AstroWay/api v2.201.7 · ko
모든 시스템 정상 작동 중
// astrology api · POST /v1/transits

천체운행 차트 API

하나의 POST 요청으로 목표 날짜의 하늘을 캡처하고 개인의 출생도 프레임 위에 겹쳐보세요. 천체운행 행성, 그들이 위치하는 출생도의 각선, 천체들 사이의 측위 그리드, 그리고 평행 및 안티시아 - 스위스 천체력 정밀도로 JSON 형식으로 제공됩니다.

Endpoint
POST /v1/transits
Cost
50 credits
Latency
~60 ms
Tier
Tier 3
// 01 / What it computes

천체운행 차트 API

천체운행 엔드포인트는 개인의 출생 데이터 - 생년월일, 시간, UTC 오프셋, 위도, 경도, 하우스 시스템 - 및 별도의 목표 시점을 받습니다. 이 목표 날짜와 시각을 율리우스일로 변환한 후, 스위스 천체력 엔진에 모든 천체운행 천체의 지심 경도, 위도, 속도를 요청하고, 이 위치들을 출생지에서 파생된 하우스에 배치합니다. 응답에는 천체운행 행성과 그들의 별자리 및 하우스 배치, 출생도의 각선, 그리고 천체들 사이의 전체 측위 그리드가 포함되며, 각각은 적용 또는 분리 플래그와 정확한 궤도를 가집니다. 또한, 적위 및 춘분추분축 작업을 위한 평행 및 안티시아(거울점) 측위도 반환합니다. 천체 속도에서 역행 운동을 플래그 처리하므로, 요청된 시점에서 어떤 천체운행이 직진, 정류, 또는 후진 중인지 확인할 수 있습니다.

// 02 / Live request

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
}'
Response (excerpt)
{
  "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": [
      "…"
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

When to use it

주어진 날짜에 누군가의 차트 위에 있는 전체 하늘이 필요할 때 이것을 사용하세요 - 일별 천체운행 위젯, 날씨 스타일의 '지금 하늘에는 무엇이 있는지' 패널, 또는 현재 점성학적 기후를 설명하기 전 AI 에이전트가 읽는 원본 프레임. 출생도 하우스 프레임 위에 천체운행 차트를 반환하는 미리 필터링된 체류-출생 측위 목록이 아니므로, 구조적 스냅샷 자체가 필요할 때 올바른 선택입니다. 대신 날짜 범위에 걸쳐 타이밍된 체류-출생 접촉을 스캔하고 싶다면 - 정확한 날짜, 진입, 정류점 - 체력 달력 엔드포인트를 사용하세요. 이는 해당 타이밍 작업을 위해 만들어졌습니다. 두 가지를 함께 사용하세요: 이 엔드포인트는 특정 시점의 차트를, 달력은 향후 이벤트 목록을 제공합니다.

오늘의 천체운행을 당신의 차트와 비교해 보세요 →

// 05 / Notes

Notes

범위에 대해 정확히 파악하세요: 이것은 출생도 하우스 프레임 위에 겹쳐진 체류 차트를 반환하며, 미리 필터링된 체류-출생 측위 목록이 아닙니다. 측위 그리드는 체류 천체들 사이에서 계산되며, 체류와 출생 점 사이가 아닙니다. 날짜 범위에 걸쳐 출생도에 대한 타이밍을 원한다면 /transit-calendar를 사용하세요. 하우스는 선택한 출생 시스템을 따르며, 열대 황도대와 스위스 천체력이 전체에 적용됩니다.

Try the 천체운행 차트 API

Grab a key and make your first call in under a minute.

99.9% SLA · 유료 플랜 · 30일 상태 →