NatalChart.AI API는 NatalChart.AI 앱의 계산 엔진을 개발자에게 공개한 것입니다. 생년월일, 출생 시간, 좌표를 보내면 차트가 돌아옵니다. 천체력 파일을 호스팅할 필요도, 시간대 표를 관리할 필요도, 점성술 라이브러리를 최신으로 유지할 필요도 없습니다.
만들 수 있는 것
네이탈 차트 페이지
태양, 달, 상승궁, 별자리와 하우스에 놓인 모든 행성, 오브를 포함한 애스펙트, 원소의 균형을 1800년에서 2399년까지의 어떤 출생에 대해서든 계산합니다. /v1/chart/full, /v1/chart/short
실제 하늘로 만드는 일일 운세
그날 한 사람의 차트에 작용하는 트랜짓을 각각의 오브, 그리고 강해지는 중인지 약해지는 중인지와 함께 보여 주며, 달의 위상과 그 주의 하늘 이벤트도 제공합니다. /v1/horoscope/daily, /v1/sky
데이팅 서비스를 위한 궁합
두 차트를 비교합니다. 둘 사이의 모든 애스펙트, 각자의 행성이 상대의 어느 하우스에 들어가는지, 삶의 영역별 점수를 제공합니다. /v1/synastry
예측과 앞으로의 1년
최대 92일 기간 안에서 트랜짓이 정확해지는 모든 시점, 그리고 출생지나 그 사람이 지낼 장소를 기준으로 한 원하는 해의 솔라 리턴 차트를 제공합니다. /v1/transits, /v1/solar-return
좋은 날
기간 안의 하루하루에 한 가지 활동(사업, 연애, 여행, 건강 등)에 맞춘 점수를 매기고, 그 활동에 유리한 트랜짓과 불리한 트랜짓을 함께 보여 줍니다. /v1/timing
아스트로카토그래피와 리로케이션
한 도시를 차트에 맞춰 점수를 매기거나, 세계의 주요 도시에 그 차트 기준으로 순위를 매깁니다. 삶의 영역별, 지역별로 볼 수 있습니다. /v1/locations/score, /v1/locations/rank
1분 만에 시작하기
키를 만들고(무료, 카드 필요 없음) 출생 정보를 보내면 됩니다:
curl https://api.natalchart.ai/v1/chart/short \
-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}}'모든 엔드포인트, 필드, 오류는 API 문서에 있으며, 코드 생성기용으로는 OpenAPI 문서에 설명되어 있습니다.
직접 확인할 수 있는 정확도
트로피컬 조디악, 플라시더스 하우스, 5가지 주요 애스펙트, 진교점을 쓰며, 위치는 도 단위로 소수점 넷째 자리까지 나옵니다. 시간대는 좌표와 출생일의 서머타임 규칙으로 결정하며, 출생 시간을 모르면 하우스와 앵글을 추측하지 않고 비워 둡니다. 정확도 보고서는 엔진을 NASA JPL Horizons와 비교하며, 공개된 데모 차트로 코드를 쓰기 전에 응답을 확인해 볼 수 있습니다.
AI 어시스턴트용: MCP 서버
같은 계산을 https://www.natalchart.ai/mcp의 MCP 서버로도 제공합니다. Claude, ChatGPT, Cursor, VS Code가 같은 키로 연결해 차트, 트랜짓, 궁합 도구를 직접 호출하므로, 어시스턴트는 추측한 차트가 아니라 계산된 차트를 읽습니다.
요금
| 요금제 | 가격 | 요청 | 엔드포인트 |
|---|---|---|---|
| 무료 플랜 | $0 | 하루 10회 | 차트와 그 부분, 일일 운세, 하늘, 사용량 |
| API Pro | 월 $6.99 | 하루 1,000회 | 전체: 트랜짓, 시나스트리, 솔라 리턴, 좋은 날, 장소 |
한도는 계정 단위이며 UTC 기준 00:00에 다시 채워집니다. 유효하지 않아 거부된 요청은 세지 않고, 출생 정보는 저장하지 않습니다. 로그에는 엔드포인트, 상태, 시간만 남습니다.
자주 묻는 질문
무료 점성술 API가 있나요?
네. NatalChart.AI 키는 무료이며 하루 10회 요청을 쓸 수 있습니다. 전체 또는 부분 네이탈 차트, 차트에 대한 트랜짓을 포함한 그날의 하늘, 원하는 날짜의 행성 위치를 받을 수 있습니다. 카드는 필요 없습니다. API Pro(월 $6.99)는 한도를 하루 1,000회로 늘리고, 기간별 트랜짓, 시나스트리, 솔라 리턴, 좋은 날, 아스트로카토그래피를 열어 줍니다.
계산은 얼마나 정확한가요?
위치는 전문 점성술 소프트웨어의 표준인 Swiss Ephemeris에서 나오며, 데이터 파일을 쓰고 속도 플래그를 켜서 계산합니다. NatalChart.AI 앱의 모든 차트를 같은 엔진이 그리며, 정확도 보고서는 그 결과를 NASA JPL Horizons와 비교합니다.
이 API로 운세 앱이나 궁합 앱을 만들 수 있나요?
네, 바로 그런 용도로 만든 API입니다. 네이탈 차트 페이지, 실제 트랜짓에 근거한 일일 운세, 데이팅 서비스용 궁합 점수, 좋은 날 고르기 기능, 리로케이션 지도를 만들 수 있습니다. 두 요금제 모두 상업적 이용이 가능하며, 키는 서버에 보관해야 합니다.
해석 글도 돌려주나요?
아니요. API는 숫자를 계산해 돌려줍니다: 별자리, 도수, 하우스, 오브를 포함한 애스펙트, 삶의 영역별 점수. AI 호출이 없으므로 같은 입력에는 언제나 같은 결과가 나오며, 글은 직접 쓰거나 사용하는 모델이 씁니다.
어떤 언어와 프레임워크에서 쓸 수 있나요?
JSON 본문을 담은 HTTPS 요청을 보낼 수 있다면 무엇이든 됩니다: JavaScript, Python, PHP, Swift, Kotlin, 노코드 도구. 문서에는 복사해 붙여 넣을 수 있는 예시가 있고, OpenAPI 문서가 코드 생성기용으로 모든 엔드포인트를 설명합니다.
AI 어시스턴트도 쓸 수 있나요?
네, MCP 서버를 통해 쓸 수 있습니다. Claude, ChatGPT, Cursor, VS Code가 같은 키로 MCP 서버에 연결해 계산을 도구로 호출합니다.