Transit Chart API
Ambil snapshot langit pada tanggal target mana pun dan tumpangkan ke bingkai rumah natal seseorang dalam satu POST. Planet yang transit, cusp natal tempat mereka jatuh, grid aspek di antara benda-benda yang transit, plus parallel dan antiscia - presisi Swiss Ephemeris, output JSON.
Transit Chart API
Endpoint transits menerima data natal seseorang - tanggal lahir, jam, offset UTC, lintang, bujur, dan sistem rumah - serta momen target terpisah. Endpoint ini mengubah tanggal target dan waktu jam tersebut menjadi Julian day, meminta mesin Swiss Ephemeris untuk bujur geosentris, lintang, dan kecepatan setiap benda yang transit, lalu memetakan posisi-posisi itu ke dalam rumah yang diturunkan dari lokasi natal. Responsnya membawa planet yang transit beserta tanda zodiak dan penempatan rumahnya, cusp rumah natal, dan grid aspek lengkap yang dihitung di antara benda-benda yang transit itu sendiri, masing-masing dengan tanda applying atau separating dan orb yang tepat. Endpoint ini juga mengembalikan aspek parallel dan antiscia (titik cermin) untuk kerja deklinasi dan sumbu solstis. Gerakan retrograde ditandai dari kecepatan benda, jadi kamu bisa melihat transit mana yang direct, stationer, atau bergerak mundur pada momen yang diminta.
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
Gunakan ini saat kamu ingin seluruh langit sebagaimana posisinya di atas chart seseorang pada hari tertentu - widget transit harian, panel gaya cuaca 'apa yang ada di atas sekarang', atau kerangka mentah yang dibaca agen AI sebelum mendeskripsikan iklim astrologi saat ini. Karena endpoint ini mengembalikan chart transit di atas kerangka rumah natal, bukan daftar kurasi kontak transit-ke-natal, ini adalah pilihan yang tepat saat kamu butuh snapshot strukturalnya sendiri. Jika kamu justru ingin hit transit-ke-natal berwaktu yang dipindai di sepanjang rentang tanggal - tanggal tepat, ingress, titik station - gunakan endpoint transit-calendar, yang memang dibangun untuk tugas pewaktuan itu. Padukan keduanya: endpoint ini untuk chart momen-waktu, kalender untuk daftar peristiwa ke depan.
Notes
Perjelas soal cakupan: ini mengembalikan chart transit yang ditumpangkan ke bingkai rumah natal, bukan daftar aspek transit-ke-natal yang sudah difilter. Grid aspek dihitung di antara benda-benda yang transit, bukan antara titik transit dan natal. Untuk pewaktuan ke-natal di sepanjang rentang tanggal, gunakan /transit-calendar. Rumah mengikuti sistem natal pilihanmu; zodiak tropis dan Swiss Ephemeris di seluruhnya.
Try the Transit Chart API
Grab a key and make your first call in under a minute.