운세 API

요청

데모 차트에 대한 실제 요청입니다:

curl -X POST https://api.natalchart.ai/v1/horoscope/daily \
  -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},"date":"2026-09-18"}'

응답

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

{
  "date": "2026-09-18",
  "computedFor": "2026-09-18T12:00:00.000Z",
  "moon": {
    "phase": "First Quarter",
    "illumination": 46.5,
    "elongation": 86.04,
    "sign": "Sagittarius",
    "longitude": 261.6344,
    "degreeInSign": 21.63,
    "theme": "Decision + Action",
    "nextNewMoon": {
      "utc": "2026-10-10T15:50:05.436Z",
      "sign": "Libra",
      "degreeInSign": 17.36,
      "absoluteDegree": 197.36
    },
    "nextFullMoon": {
      "utc": "2026-09-26T16:49:02.781Z",
      "sign": "Aries",
      "degreeInSign": 3.62,
      "absoluteDegree": 3.62
    }
  },
  "positions": [
    {
      "name": "Sun",
      "longitude": 175.5994,
      "sign": "Virgo",
      "degreeInSign": 25.6,
      "speed": 0.9761,
      "retrograde": false
    },
    {
      "name": "Moon",
      "longitude": 261.6344,
      "sign": "Sagittarius",
      "degreeInSign": 21.63,
      "speed": 11.8869,
      "retrograde": false
    }
  ],
  "events": [
    {
      "kind": "ingress",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    },
    {
      "kind": "equinox",
      "at": "2026-09-23T00:05:13.524Z",
      "planet": "sun",
      "sign": "Libra",
      "degreeInSign": 0.01
    }
  ],
  "transits": [
    {
      "transit": "Vesta",
      "natal": "Mercury",
      "aspect": "Trine",
      "angle": 119.93,
      "orb": 0.07,
      "phase": "applying",
      "exactAt": "2026-09-18T21:43:39.997Z",
      "tone": "supportive",
      "transitHouse": 2,
      "houseTheme": "Money & Possessions"
    },
    {
      "transit": "Uranus",
      "natal": "Lilith",
      "aspect": "Trine",
      "angle": 119.86,
      "orb": 0.14,
      "phase": "separating",
      "exactAt": null,
      "tone": "supportive",
      "transitHouse": 3,
      "houseTheme": "Communication & Learning"
    }
  ],
  "focus": [
    {
      "transit": "Pluto",
      "natal": "Mars",
      "aspect": "Trine",
      "angle": 119.78,
      "orb": 0.22,
      "phase": "separating",
      "exactAt": "2026-09-03T17:58:04.996Z",
      "tone": "supportive",
      "transitHouse": 12,
      "houseTheme": "Spirituality & Subconscious"
    },
    {
      "transit": "Neptune",
      "natal": "Mars",
      "aspect": "Opposition",
      "angle": 179.74,
      "orb": 0.26,
      "phase": "separating",
      "exactAt": "2026-09-09T00:24:29.005Z",
      "tone": "challenging",
      "transitHouse": 1,
      "houseTheme": "Identity & Self"
    },
    {
      "transit": "Jupiter",
      "natal": "Moon",
      "aspect": "Conjunction",
      "angle": 1.77,
      "orb": 1.77,
      "phase": "applying",
      "exactAt": "2026-09-27T20:40:07.004Z",
      "tone": "intensifying",
      "transitHouse": 7,
      "houseTheme": "Partnerships & Marriage"
    }
  ]
}

반환되는 내용

• positions: 그날 UTC 정오에 각 천체가 놓인 별자리와 도수.
• moon: 달의 위상, 밝은 면의 비율, 달 별자리, 다음 신월과 보름달.
• events: 별자리 진입이나 정지 같은 앞으로 일주일의 하늘 이벤트.
• transits: 출생 정보를 보내면 네이탈 차트에 대한 모든 트랜짓을 애스펙트, 오브, 접근 중인지 분리 중인지, 정확해지는 시각, 트랜짓 천체가 놓인 네이탈 하우스와 함께 담습니다.
• focus: 행성의 속도와 오브의 좁기로 순위가 가장 높은 접촉 3개를 담으며, 각각 고정된 규칙(삼각과 육분은 supportive, 사각과 충은 challenging, 합은 intensifying)에 따라 정한 tone 값이 붙습니다.

제한 사항

• 무료 키는 하루 10회 요청, API Pro는 하루 1,000회입니다.
• 트랜짓 오브는 달, 태양, 수성, 금성, 화성이 2°, 그보다 느린 천체가 3°입니다.
• 태양 별자리별 운세 글도, 생성된 텍스트도 없습니다. 엔드포인트는 한 차트에 대한 숫자를 반환합니다.
• 출생 정보는 읽고 쓴 뒤 잊습니다. 요청 본문은 저장하지 않습니다.

AI 어시스턴트에서

https://www.natalchart.ai/mcp의 MCP 서버를 통해 어시스턴트는 daily_transits 도구를 호출하고, 트랜짓을 지어내는 대신 계산된 트랜짓으로 운세를 씁니다.

API의 다른 기능

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

자주 묻는 질문