천체운행 차트 API
하나의 POST 요청으로 목표 날짜의 하늘을 캡처하고 개인의 출생도 프레임 위에 겹쳐보세요. 천체운행 행성, 그들이 위치하는 출생도의 각선, 천체들 사이의 측위 그리드, 그리고 평행 및 안티시아 - 스위스 천체력 정밀도로 JSON 형식으로 제공됩니다.
천체운행 차트 API
천체운행 엔드포인트는 개인의 출생 데이터 - 생년월일, 시간, UTC 오프셋, 위도, 경도, 하우스 시스템 - 및 별도의 목표 시점을 받습니다. 이 목표 날짜와 시각을 율리우스일로 변환한 후, 스위스 천체력 엔진에 모든 천체운행 천체의 지심 경도, 위도, 속도를 요청하고, 이 위치들을 출생지에서 파생된 하우스에 배치합니다. 응답에는 천체운행 행성과 그들의 별자리 및 하우스 배치, 출생도의 각선, 그리고 천체들 사이의 전체 측위 그리드가 포함되며, 각각은 적용 또는 분리 플래그와 정확한 궤도를 가집니다. 또한, 적위 및 춘분추분축 작업을 위한 평행 및 안티시아(거울점) 측위도 반환합니다. 천체 속도에서 역행 운동을 플래그 처리하므로, 요청된 시점에서 어떤 천체운행이 직진, 정류, 또는 후진 중인지 확인할 수 있습니다.
POST/v1/transits
curl -X POST https://api.astroway.info/v1/transits \
-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,
"transitDate": "2026-06-15",
"transitTime": "12:00:00",
"transitTzOffset": 3
}' {
"ok": true,
"data": {
"input": {},
"julianDay": 2461206.875,
"planets": [
{
"name": "Sun",
"longitude": 84.29,
"sign": "Gemini",
"house": 11
}
],
"houses": {
"ascendant": 160.4,
"mc": 70.1,
"cusps": [
"…"
]
},
"aspects": [
{
"planet1": "Sun",
"planet2": "Moon",
"type": "conjunction",
"orb": 1.2,
"applying": true
}
],
"parallelAspects": [
"…"
],
"antiscia": [
"…"
]
}
} 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). |
| transitDate | string (YYYY-MM-DD) | yes | Required target date for the transit snapshot (YYYY-MM-DD). |
| transitTime | string (HH:MM:SS) | no | Optional clock time of the transit moment (HH:MM:SS). |
| transitTzOffset | number (hours) | no | Optional UTC offset for the transit moment, in hours. |
When to use it
주어진 날짜에 누군가의 차트 위에 있는 전체 하늘이 필요할 때 이것을 사용하세요 - 일별 천체운행 위젯, 날씨 스타일의 '지금 하늘에는 무엇이 있는지' 패널, 또는 현재 점성학적 기후를 설명하기 전 AI 에이전트가 읽는 원본 프레임. 출생도 하우스 프레임 위에 천체운행 차트를 반환하는 미리 필터링된 체류-출생 측위 목록이 아니므로, 구조적 스냅샷 자체가 필요할 때 올바른 선택입니다. 대신 날짜 범위에 걸쳐 타이밍된 체류-출생 접촉을 스캔하고 싶다면 - 정확한 날짜, 진입, 정류점 - 체력 달력 엔드포인트를 사용하세요. 이는 해당 타이밍 작업을 위해 만들어졌습니다. 두 가지를 함께 사용하세요: 이 엔드포인트는 특정 시점의 차트를, 달력은 향후 이벤트 목록을 제공합니다.
Notes
범위에 대해 정확히 파악하세요: 이것은 출생도 하우스 프레임 위에 겹쳐진 체류 차트를 반환하며, 미리 필터링된 체류-출생 측위 목록이 아닙니다. 측위 그리드는 체류 천체들 사이에서 계산되며, 체류와 출생 점 사이가 아닙니다. 날짜 범위에 걸쳐 출생도에 대한 타이밍을 원한다면 /transit-calendar를 사용하세요. 하우스는 선택한 출생 시스템을 따르며, 열대 황도대와 스위스 천체력이 전체에 적용됩니다.
Try the 천체운행 차트 API
Grab a key and make your first call in under a minute.