Natační graf API
Převedte jeden okamžik narození na kompletní, strukturovaný natační graf - planety, hranice domů, aspekty a úhlová data - v jednom POSTu. Tropický zodiak, třináct systémů domů, přesnost Swiss Ephemeris, JSON na výstupu.
Natační graf API
Koncový bod natačního grafu převede datum narození, čas a UTC posun na přesný juliánský den, pak se zeptá Swiss Ephemeris engine na geocentrickou délku, šířku a rychlost každého tělesa - deset klasických planet plus lunární uzly, Chiron a Černou Lunu Lilith. Odvodí Ascendent a Středobrod z zeměpisné šířky a délky narození, rozdělí domy podle zvoleného systému, přiřadí každou planetu k jejímu znamení a domu a spočítá kompletní aspektovou mřížku s příznaky aplikace/oddělení a přesnými orbity. Retrográdní pohyb je označen podle rychlosti tělesa a sekt grafu (den nebo noc narození) je vrácen, takže následná interpretace může správně vážit benefické a škodlivé planety.
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
Sáhněte po tomto koncovém bodu, kdykoliv potřebujete strukturální kostru horoskopu: widget natačního grafu, natační zprávu, onboardovací tok, který personalizuje obsah podle Slunce/Měsíce/Vzestupu, nebo AI agenta, který potřebuje surová umístění, než cokoliv interpretuje. Je to předpokládané volání pro synastrii, transity, progresy a většinu typů zpráv - spočítejte graf jednou, uložte JSON do mezipaměti a podávejte těžším koncovým bodům místo přepočítávání pokaždé. Protože odpověď je čistá data (žádný text, žádné obrázky), snadno zapadne do jakéhokoliv stacku: vykreslete ji sami, předávejte LLM nebo předávejte jeden z našich SVG vykreslovacích koncových bodů.
Notes
Výchozí nastavení následuje hlavní západní konvenci: tropický zodiak, domy Placidus, Slunce–Měsíc–Ascendent "Velká trojka". Engine je Swiss Ephemeris (Astrodienst) a sdílený s kalkulačkou v prohlížeči, takže server a klient souhlasí na úroveň úhlové sekundy. Nad polárním kruhem, kde Placidus není definován, se domy vracejí k systému Porphyry.
Try the Natační graf API
Grab a key and make your first call in under a minute.