시나스트리 API

요청

가상의 두 사람에 대한 실제 요청입니다. 키이우의 데모 출생 정보와 뉴욕의 두 번째 출생 정보를 씁니다.

curl -X POST https://api.natalchart.ai/v1/synastry \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personA":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"personB":{"date":"1989-03-14","time":"07:45","latitude":40.7128,"longitude":-74.006}}'

응답

위 요청에 대한 응답의 일부입니다. 주요 필드만 보여 주며, 목록은 모두 처음 세 항목으로 줄였습니다.

{
  "aspects": [
    {
      "personA": "Neptune",
      "personB": "Lilith",
      "aspect": "Trine",
      "angle": 120.08,
      "orb": 0.08
    },
    {
      "personA": "Saturn",
      "personB": "Jupiter",
      "aspect": "Trine",
      "angle": 119.66,
      "orb": 0.34
    },
    {
      "personA": "Mercury",
      "personB": "Moon",
      "aspect": "Sextile",
      "angle": 60.38,
      "orb": 0.38
    }
  ],
  "sphereScores": {
    "identity": 89,
    "love": 81,
    "body": 86,
    "money": 76,
    "home": 83,
    "mind": 66
  }
}

반환되는 내용

• aspects: 한 차트의 천체와 다른 차트의 천체 사이에 이루어지는 모든 주요 애스펙트를 각도, 오브와 함께 담습니다.
• overlays: 각자의 행성이 상대의 차트에서 어느 하우스에 들어가는지를 양방향으로 보여 줍니다. 상대의 출생 시간을 모르면 그쪽 방향은 null 값이 됩니다. 하우스는 출생 시간에 따라 정해지기 때문입니다.
• sphereScores: 정체성, 사랑, 몸, 돈, 집, 정신의 점수로, 각각 0에서 100까지이며 차트 간 애스펙트(60%)와 하우스 오버레이(40%)로 계산합니다.
• scoring: 점수의 근거가 되는 규칙으로, 응답에 명시되어 있습니다. 이 규칙은 관계의 미래가 아니라 두 차트의 기하 배치를 설명합니다.

제한 사항

• API Pro 전용입니다. 무료 키로 호출하면 엔드포인트가 업그레이드 링크와 함께 403을 반환합니다.
• 1800년에서 2399년까지의 출생을 지원합니다. 트로피컬 조디악, 플라시더스 하우스, 5가지 주요 애스펙트를 씁니다.
• 장소 이름을 좌표로 변환하지 않으므로 좌표를 보내야 합니다. 시간대는 좌표와 출생일의 서머타임 규칙으로 결정합니다.
• 출생 정보는 읽고 쓴 뒤 잊습니다. 요청 본문은 저장하지 않습니다.

AI 어시스턴트에서

https://www.natalchart.ai/mcp의 MCP 서버는 같은 계산을 synastry 도구로 제공하므로, Claude, ChatGPT 또는 Cursor가 궁합을 이야기하기 전에 두 차트를 먼저 비교할 수 있습니다.

API의 다른 기능

같은 키로 네이탈 차트, 일일 트랜짓, 시나스트리, 기간별 트랜짓, 솔라 리턴, 좋은 날, 아스트로카토그래피까지 점성술 API 전체를 쓸 수 있습니다. 모든 엔드포인트, 필드, 오류는 문서에 있으며, 무엇을 요청 1회로 세는지는 요금 페이지에서 볼 수 있습니다.

자주 묻는 질문