출생도 API
하나의 출생 순간을 완전하고 체계적인 출생도로 변환 - 행성, 하우스 경계선, 각도, 각 데이터 - 단일 POST로. 열대 황도, 열세 가지 하우스 시스템, 스위스 에페메리스 정밀도, JSON 출력.
출생도 API
출생도 엔드포인트는 출생 날짜, 시간, UTC 오프셋을 정확한 율리우스일로 변환한 다음, 스위스 에페메리스 엔진에 모든 천체의 지심 경도, 위도, 속도를 요청합니다 - 열 개의 고전 행성과 더불어 월 노드, 키론, 검은 달 릴리스. 출생 위도와 경도에서 상승점과 천궁점을 파생시키고, 선택한 시스템으로 하우스를 나누며, 각 행성을 그것의 별자리와 하우스에 할당하고, 적용/분리 플래그와 정확한 궤도로 전체 측각 그리드를 계산합니다. 역행 운동은 천체 속도로부터 플래그가 지정되며, 차트 섹트(낮 또는 밤 출생)가 반환되어 하류 해석이 유익성과 불행성을 올바르게 가중치를 줄 수 있습니다.
POST/v1/chart
curl -X POST https://api.astroway.info/v1/chart \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52,
"houseSystem": "P"
}' {
"ok": true,
"data": {
"planets": [
{ "name": "Sun", "longitude": 54.23, "sign": "Taurus", "house": 10, "retrograde": false },
{ "name": "Moon", "longitude": 282.7, "sign": "Capricorn", "house": 6 }
],
"houses": { "ascendant": 160.4, "mc": 70.1, "cusps": [160.4, 190.3, ...] },
"aspects": [ { "body1": "Sun", "body2": "Moon", "type": "trine", "orb": 1.2 } ]
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| houseSystem | string | no | One-letter Swiss Ephemeris code - P (Placidus, default), K (Koch), W (whole-sign), R (Regiomontanus), and 10 more. |
When to use it
점성도의 구조적 기둥이 필요할 때마다 이 엔드포인트를 사용하세요: 출생도 위젯, 출생 보고서, 태양/달/상승점으로 콘텐츠를 개인화하는 온보딩 플로우, 또는 해석하기 전에 원위치가 필요한 AI 에이전트. 이것은 시나스트리, 트랜짓, 프로그레션, 그리고 대부분의 보고서 유형에 대한 필수 호출입니다 - 차트를 한 번 계산하고 JSON을 캐시하여, 매번 재계산하는 대신 더 무거운 엔드포인트에 공급합니다. 응답이 순수한 데이터(프로세 없음, 이미지 없음)이므로 어떤 스택에도 깔끔하게 통합될 수 있습니다: 직렌더링하거나 LLM에 전달하거나, 우리의 SVG 렌더 엔드포인트 중 하나에 전달할 수 있습니다.
Notes
기본값은 주류 서양 관습을 따릅니다: 열대 황도, 플라시두스 하우스, 태양-달-상승점 "빅 쓰리". 엔진은 스위스 에페메리스(Astrodienst)이며, 인브라우저 계산기와 공유되므로 서버와 클라이언트가 아크초에 동의합니다. 플라시두스가 정의되지 않는 극권 위에서는 하우스가 포르피리로 대체됩니다.
Try the 출생도 API
Grab a key and make your first call in under a minute.