솔라 리턴 API

요청

실제 요청입니다. 데모 차트의 2027년 리턴을 출생지 기준으로 계산합니다.

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -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},"year":2027}'

응답

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

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

반환되는 내용

• exactMomentUtc: 태양이 다시 네이탈 황경에 이르는 순간(UTC 기준).
• location: 차트를 계산하는 장소. 다른 장소를 보내지 않으면 출생지입니다.
• natalSun: 리턴을 재는 기준인 네이탈 태양의 황경.
• chart: 그 순간과 장소에 대한 전체 차트. 네이탈 차트 엔드포인트와 같은 구조입니다.

제한 사항

• API Pro 전용입니다. 무료 키로 호출하면 엔드포인트가 업그레이드 링크와 함께 403을 반환합니다.
• 출생 시간이 필요합니다.
• 트로피컬 조디악과 플라시더스 하우스를 쓰며, 네이탈 차트와 같은 설정입니다.
• 출생 정보는 읽고 쓴 뒤 잊습니다. 요청 본문은 저장하지 않습니다.

AI 어시스턴트에서

https://www.natalchart.ai/mcp의 MCP 서버를 통해 어시스턴트는 solar_return 도구를 호출하고, 계산된 차트로 앞으로의 1년을 읽습니다.

API의 다른 기능

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

자주 묻는 질문