ट्रांज़िट चार्ट API
किसी भी target date पर आकाश की snapshot ले और उसे एक POST में व्यक्ति के natal house फ्रेम पर रखो। Transiting planets, वे natal cusps जिनमें वे गिरते हैं, transiting bodies के बीच का aspect grid, साथ में parallels और antiscia - Swiss Ephemeris की precision, JSON आउट।
ट्रांज़िट चार्ट API
transits endpoint एक व्यक्ति के natal data - जन्म तिथि, समय, UTC offset, latitude, longitude, और house system - और एक अलग target moment लेता है। यह target date और clock time को Julian day में बदलता है, Swiss Ephemeris engine से हर transiting body की geocentric longitude, latitude, और speed पूछता है, फिर उन positions को natal location से निकाले गए houses में डालता है। response में transiting planets उनके signs और house placements के साथ, natal house cusps, और transiting bodies के बीच computed full aspect grid शामिल है, प्रत्येक के पास applying या separating flags और exact orbs होते हैं। यह parallel और antiscia (mirror-point) aspects भी लौटाता है declination और solstitial-axis काम के लिए। Retrograde motion को body speed से flag किया जाता है, ताकि तू देख सके कौन से transits direct, stationary, या backward हैं requested moment पर।
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
जब तू चाहता है कि पूरे sky को किसी दिन पर किसी के chart के ऊपर देखे - एक daily-transits widget, एक weather-style 'what's overhead now' पैनल, या वह raw फ्रेम जो AI एजेंट current astrological climate बताने से पहले पढ़ता है। क्योंकि यह transit chart को natal house framework पर लौटाता है न कि curated transit-to-natal contacts की लिस्ट, यह सही है जब तुझे structural snapshot चाहिए। अगर तू timed transit-to-natal hits को date range में स्कैन करना चाहता है - exact dates, ingresses, station points - तो transit-calendar endpoint इस्तेमाल कर, जो उस timing job के लिए बना है। दोनों को जोड़: यह endpoint moment-in-time chart के लिए, calendar forward-looking event list के लिए।
Notes
Scope के बारे में सटीक रह: यह transit chart को natal house फ्रेम पर रखता है, न कि pre-filtered transit-to-natal aspect लिस्ट। aspect grid transiting bodies के बीच computed है, transit और natal points के बीच नहीं। तो-natal timing के लिए dates की span में /transit-calendar इस्तेमाल कर। Houses तेरे चुने हुए natal system को फॉलो करते हैं; tropical zodiac और Swiss Ephemeris पूरे समय।
Try the ट्रांज़िट चार्ट API
Grab a key and make your first call in under a minute.