Natal Chart API
एक जन्म क्षण को पूरी, संरचित जन्म कुंडली में बदलो - ग्रह, भाव संधि, दृष्टियाँ और कोणीय डेटा - एक ही POST में। Tropical राशि चक्र, तेरह भाव प्रणालियाँ, Swiss Ephemeris सटीकता, JSON आउटपुट।
Natal Chart API
Natal-chart endpoint जन्म तारीख, घड़ी का समय और UTC offset को सटीक Julian day में बदलता है, फिर Swiss Ephemeris इंजन से हर पिंड का geocentric longitude, latitude और speed माँगता है - दस शास्त्रीय ग्रहों के साथ चंद्र नोड्स, Chiron और Black Moon Lilith। यह जन्म के latitude और longitude से Ascendant और Midheaven निकालता है, तुम्हारी चुनी प्रणाली से भाव विभाजित करता है, हर ग्रह को उसकी राशि और भाव में रखता है, और applying/separating flags तथा exact orbs के साथ पूरा aspect grid बनाता है। Retrograde गति पिंड की speed से चिह्नित होती है, और chart sect (दिन या रात का जन्म) लौटाया जाता है ताकि आगे की व्याख्या benefics और malefics को सही ढंग से तौल सके।
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
इस endpoint का इस्तेमाल तब करो जब तुम्हें कुंडली की संरचनात्मक रीढ़ चाहिए: birth-chart widget, natal report, ऐसा onboarding flow जो Sun/Moon/Rising से कंटेंट को निजीकृत करे, या कोई AI agent जिसे व्याख्या से पहले कच्चे placements चाहिए। यह synastry, transits, progressions और ज़्यादातर report types के लिए पहली ज़रूरी कॉल है - कुंडली एक बार बनाओ, JSON cache करो, और हर बार दोबारा गणना करने के बजाय उसे भारी endpoints में भेजो। क्योंकि response शुद्ध डेटा है (कोई गद्य नहीं, कोई चित्र नहीं), यह किसी भी stack में आसानी से फिट हो जाता है: खुद render करो, किसी LLM को दो, या हमारे किसी SVG render endpoint को सौंप दो।
Notes
डिफ़ॉल्ट मुख्यधारा की पश्चिमी परंपरा का पालन करते हैं: tropical राशि चक्र, Placidus भाव, Sun–Moon–Ascendant "Big Three"। इंजन Swiss Ephemeris (Astrodienst) है जो ब्राउज़र कैलकुलेटर के साथ साझा किया गया है, इसलिए server और client arc-second तक मेल खाते हैं। ध्रुव वृत्त के ऊपर, जहाँ Placidus परिभाषित नहीं है, भाव Porphyry पर वापस आ जाते हैं।
Try the जन्म कुंडली API
Grab a key and make your first call in under a minute.