NatalChart.AI API는 NatalChart.AI 앱의 계산 엔진을 개발자에게 공개한 것입니다. 생년월일, 출생 시간, 좌표를 보내면 차트가 돌아옵니다. 천체력 파일을 호스팅할 필요도, 시간대 표를 관리할 필요도, 점성술 라이브러리를 최신으로 유지할 필요도 없습니다.
만들 수 있는 것
네이탈 차트 페이지
태양, 달, 상승궁, 별자리와 하우스에 놓인 모든 행성, 오브를 포함한 애스펙트, 원소의 균형을 1800년에서 2399년까지의 어떤 출생에 대해서든 계산합니다. /v1/chart/full, /v1/chart/short
실제 하늘로 만드는 일일 운세
그날 한 사람의 차트에 작용하는 트랜짓을 각각의 오브, 그리고 강해지는 중인지 약해지는 중인지와 함께 보여 주며, 달의 위상과 그 주의 하늘 이벤트도 제공합니다. /v1/horoscope/daily, /v1/sky
데이팅 서비스를 위한 궁합
두 차트를 비교합니다. 둘 사이의 모든 애스펙트, 각자의 행성이 상대의 어느 하우스에 들어가는지, 삶의 영역별 점수를 제공합니다. /v1/synastry
예측과 앞으로의 1년
최대 92일 기간 안에서 트랜짓이 정확해지는 시점(최대 60개 이벤트, 가장 중요한 것부터), 그리고 출생지나 그 사람이 지낼 장소를 기준으로 한 원하는 해의 솔라 리턴 차트를 제공합니다. /v1/transits, /v1/solar-return
좋은 날
기간 안의 하루하루에 한 가지 활동(사업, 연애, 여행, 건강 등)에 맞춘 점수를 매기고, 그 활동에 유리한 트랜짓과 불리한 트랜짓을 함께 보여 줍니다. /v1/timing
아스트로카토그래피와 리로케이션
한 도시를 차트에 맞춰 점수를 매기거나, 세계의 주요 도시에 그 차트 기준으로 순위를 매깁니다. 삶의 영역별, 지역별로 볼 수 있습니다. /v1/locations/score, /v1/locations/rank
1분 만에 시작하기
앱 설정의 API & MCP 탭에서 키를 만들고(무료, 카드 필요 없음) 출생 정보를 보내면 됩니다:
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가지 주요 애스펙트, 진교점을 쓰며, 위치는 도 단위로 소수점 넷째 자리까지 나옵니다. 시간대는 좌표와 출생일의 서머타임 규칙으로 결정하며, 출생 시간을 모르면 현지 시각 12:00을 가정해 위치를 계산하고, 하우스와 앵글은 추측하지 않고 비워 둡니다. 정확도 보고서는 공개된 테스트 차트 하나로 엔진을 NASA JPL Horizons와 비교하며, 공개된 데모 차트로 코드를 쓰기 전에 응답을 확인해 볼 수 있습니다.
AI 어시스턴트용: MCP 서버
같은 계산을 https://www.natalchart.ai/mcp의 MCP 서버로도 제공합니다. Claude, ChatGPT, Cursor, VS Code가 같은 키로 연결해 차트, 트랜짓, 궁합 도구를 직접 호출하므로, 어시스턴트는 추측한 차트가 아니라 계산된 차트를 읽습니다.
요금
| 요금제 | 가격 | 요청 | 엔드포인트 |
|---|---|---|---|
| 무료 플랜 | $0 | 하루 10회 | 차트와 그 부분, 일일 운세, 하늘, 사용량 |
| Premium | 월 $9.99 또는 연 $79 | 하루 100회 | 전체: 트랜짓, 시나스트리, 솔라 리턴, 좋은 날, 장소 |
| MAX | 월 $19.99 또는 연 $179 | 일일 한도 없음 | 전체: 트랜짓, 시나스트리, 솔라 리턴, 좋은 날, 장소 |
Premium과 MAX는 NatalChart.AI 앱의 요금제로, 구독 하나로 앱, API, MCP 서버를 모두 이용할 수 있습니다. 한도는 계정 단위로 모든 키가 함께 쓰며, UTC 기준 00:00에 다시 채워집니다. 유효하지 않아 거부된 요청은 세지 않고, 저희 쪽 오류로 실패한 요청은 한도에 되돌려 드리며, 출생 정보는 저장하지 않습니다. 로그에는 엔드포인트, 상태, 시간만 남습니다.
다른 API와 비교
점성술 API 7개를 나란히 비교했습니다. 각 업체의 자체 요금 페이지에서 가져온 내용이며, 2026년 10월 16일에 확인했습니다. 요금은 바뀌므로 결정하기 전에 링크를 따라가 확인하시기 바랍니다.
| API | 무료 요금제 | 가장 저렴한 요금제 | 호출 집계 방식 | MCP 서버 |
|---|---|---|---|---|
| NatalChart.AI | 기본 엔드포인트에 하루 10회 요청, 카드 필요 없음 | Premium: 월 $9.99에 하루 100회 요청(월 약 3,000회). MAX: 월 $19.99, 일일 한도 없음. 둘 다 모든 엔드포인트, 앱, MCP 서버 포함. | 엔드포인트와 관계없이 호출 1회에 요청 1회 | 있음, 도구 10개, 무료 키로도 사용 가능 |
| AstrologyAPI.com | 테스트 호출, 카드 필요 없음 | 월 $49에 월 50,000회 요청(서양 점성술 네이탈 데이터와 차트 휠), 시나스트리는 $99부터 | 요금제별 요청 수 또는 크레딧 지갑 | 있음 |
| Astrology-API.io | 월 50회 요청 | 월 $11에 월 1,000회 요청 | 호출 1회에 크레딧 1개, 일부 엔드포인트는 그 이상 | 있음 |
| FreeAstroAPI | 하루 80회 요청, 카드 필요 없음 | 월 $8에 월 50,000회 요청 | 호출 1회에 요청 1회 | 있음 |
| Prokerala | 월 크레딧 5,000개 | 월 $19에 크레딧 100,000개 | 엔드포인트별로 가중치를 둔 크레딧(서양 점성술 네이탈 차트는 500) | 공식 서버 없음 |
| RoxyAPI | 없음(가입 없이 쓰는 플레이그라운드) | 월 $39에 월 50,000회 요청 | 호출 1회에 요청 1회 | 있음 |
| AstroWay | 월 크레딧 10,000개 | 월 $5에 크레딧 50,000개 | 엔드포인트별로 가중치를 둔 크레딧 | 있음 |
이 API가 하지 않는 것: 다른 조디악이나 하우스 시스템, 차트 이미지, PDF 보고서, 베다 점성술, 해석 글. 위의 API 중 몇몇은 이런 기능을 제공합니다. 이 API가 하는 것: 어떤 계산이든 똑같이 요청 1회, 테스트 차트 하나를 NASA JPL Horizons와 비교한 정확도 보고서, 절대 저장하지 않는 출생 정보.
자주 묻는 질문
무료 점성술 API가 있나요?
네. NatalChart.AI 키는 무료이며 하루 10회 요청을 쓸 수 있습니다. 전체 또는 부분 네이탈 차트, 차트에 대한 트랜짓을 포함한 그날의 하늘, 원하는 날짜의 행성 위치를 받을 수 있습니다. 카드는 필요 없습니다. Premium(월 $9.99)은 한도를 하루 100회로 늘리고 기간별 트랜짓, 시나스트리, 솔라 리턴, 좋은 날, 아스트로카토그래피를 열어 주며, MAX(월 $19.99)는 일일 한도가 없습니다. 둘 다 NatalChart.AI 앱의 요금제라서 구독 하나로 앱, API, MCP 서버를 모두 이용할 수 있습니다.
계산은 얼마나 정확한가요?
위치는 전문 점성술 소프트웨어의 표준인 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 서버에 연결해 계산을 도구로 호출합니다.