트랜짓 API

요청

데모 차트에 대한 한 달 기간의 실제 요청입니다:

curl -X POST https://api.natalchart.ai/v1/transits \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"from":"2026-09-18","to":"2026-10-18"}'

응답

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

{
  "window": {
    "from": "2026-09-18",
    "to": "2026-10-18"
  },
  "events": [
    {
      "kind": "aspect",
      "at": "2026-09-19T10:10:33.151Z",
      "date": "2026-09-19",
      "position": "14°06′ Libra",
      "house": 8,
      "body": "Mercury",
      "target": "Neptune",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "14°06′ Capricorn",
      "targetHouse": 11,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-22T09:53:49.800Z",
      "date": "2026-09-22",
      "position": "18°00′ Leo",
      "house": 7,
      "body": "Jupiter",
      "target": "Pluto",
      "aspect": "Square",
      "exactness": 0,
      "targetPosition": "18°00′ Scorpio",
      "targetHouse": 8,
      "significance": "low"
    },
    {
      "kind": "aspect",
      "at": "2026-09-23T20:47:58.234Z",
      "date": "2026-09-23",
      "position": "0°51′ Libra",
      "house": 7,
      "body": "Sun",
      "target": "Saturn",
      "aspect": "Trine",
      "exactness": 0,
      "targetPosition": "0°51′ Aquarius",
      "targetHouse": 12,
      "significance": "low"
    }
  ]
}

반환되는 내용

• window: 요청한 날짜 범위입니다.
• events: 트랜짓 천체가 네이탈 천체와 정확한 애스펙트를 이루는 시점, 별자리 진입, 정지를 날짜순으로 최대 60개까지 담으며, 각각 UTC 기준 시각, 위치, 관련된 하우스가 붙습니다. 기간 안의 이벤트가 그보다 많으면 가장 중요한 것을 남깁니다.
• activeOnFirstDay: 첫날에 이미 오브 안에 있는 트랜짓을 적용한 오브와 함께 담습니다.
• 모든 이벤트에는 관련된 천체에 따라 정한 중요도(high, medium, low)가 붙습니다.

제한 사항

• API Pro 전용이며, 요청 한 번에 최대 92일, 이벤트 60개까지입니다. 무료 키로 호출하면 엔드포인트가 업그레이드 링크와 함께 403을 반환합니다.
• 1800년에서 2399년까지의 출생을 지원합니다. 트랜짓의 하우스에는 출생 시간이 필요하며, 출생 시간이 없으면 하우스는 빠집니다.
• 정확해지는 시각은 모두 Swiss Ephemeris로 찾아 UTC로 제공합니다.
• 출생 정보는 읽고 쓴 뒤 잊습니다. 요청 본문은 저장하지 않습니다.

AI 어시스턴트에서

https://www.natalchart.ai/mcp의 MCP 서버를 통해 어시스턴트는 기간에는 transits 도구를, 하루에는 daily_transits 도구를 호출해, 트랜짓을 추측하는 대신 실제 트랜짓을 읽습니다.

API의 다른 기능

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

자주 묻는 질문