API Bagan Natal
Ubah satu momen kelahiran menjadi bagan natal lengkap dan terstruktur – planet, cusp rumah, aspek, dan data sudut – dalam satu POST. Zodiak tropis, tiga belas sistem rumah, presisi Swiss Ephemeris, keluaran JSON.
API Bagan Natal
Endpoint natal-chart mengonversi tanggal lahir, waktu jam, dan offset UTC menjadi hari Julian yang tepat, lalu meminta mesin Swiss Ephemeris untuk longitude, latitude, dan kecepatan geosentrik setiap benda – sepuluh planet klasik plus nodus lunar, Chiron, dan Black Moon Lilith. Ia menghitung Ascendant dan Midheaven dari latitude dan longitude lahir, membagi rumah menurut sistem pilihanmu, menempatkan tiap planet ke tanda dan rumahnya, serta menghitung grid aspek lengkap dengan flag applying/separating dan orb tepat. Gerakan retrograde ditandai dari kecepatan benda, dan sect bagan (kelahiran siang atau malam) dikembalikan supaya interpretasi hilir dapat menimbang benefik dan malefik dengan tepat.
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
Gunakan endpoint ini kapan saja kamu butuh kerangka struktural horoskop: widget bagan kelahiran, laporan natal, alur onboarding yang mempersonalisasi konten berdasarkan Matahari/Bulan/Ascendant, atau agen AI yang butuh penempatan mentah sebelum menginterpretasi apa pun. Ini panggilan prasyarat untuk sinastri, transit, progresi, dan kebanyakan tipe laporan – hitung bagan sekali, cache JSON, dan beri ke endpoint yang lebih berat alih-alih menghitung ulang tiap kali. Karena responsnya data murni (tanpa prosa, tanpa gambar), ia masuk bersih ke stack apa saja: render sendiri, kirim ke LLM, atau serahkan ke salah satu endpoint render SVG kami.
Notes
Default mengikuti konvensi Barat mainstream: zodiak tropis, rumah Placidus, "Big Three" Matahari–Bulan–Ascendant. Mesin ini adalah Swiss Ephemeris (Astrodienst) dan dibagikan dengan kalkulator di peramban, jadi server dan klien setuju pada arc-second. Rumah kembali ke Porphyry di atas lingkar kutub dimana Placidus tidak terdefinisi.
Try the Bagan Natal API
Grab a key and make your first call in under a minute.