API del tema natale
Trasforma un momento di nascita in un tema natale completo e strutturato - pianeti, cuspidi delle case, aspetti e dati angolari - in un unico POST. Zodiaco tropicale, tredici sistemi di case, precisione Swiss Ephemeris, output JSON.
API del tema natale
L'endpoint natal-chart risolve la data di nascita, l'ora e l'offset UTC in un giorno Giuliano preciso, poi interroga il motore Swiss Ephemeris per la longitudine, latitudine e velocità geocentriche di ogni corpo - i dieci pianeti classici più i nodi lunari, Chiron e la Black Moon Lilith. Deriva l'Ascendente e il Medio Cielo dalla latitudine e longitudine di nascita, suddivide le case secondo il sistema scelto, assegna ogni pianeta al suo segno e casa, e calcola la griglia completa degli aspetti con flag di applicazione/separazione e orbite esatte. Il moto retrogrado è segnalato dalla velocità del corpo, e la sezione del tema (nascita di giorno o di notte) viene restituita così l'interpretazione a valle può ponderare correttamente i benefici e i mali.
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
Usa questo endpoint ogni volta che ti serve lo scheletro strutturale di un oroscopo: un widget di tema natale, un rapporto natale, un flusso di onboarding che personalizza i contenuti per Sole/Luna/Ascendente, o un agente IA che ha bisogno delle posizioni grezze prima di interpretare qualsiasi cosa. È la chiamata prerequisita per sinastria, transiti, progressioni e la maggior parte dei tipi di rapporto – calcola il tema una volta, cache il JSON, e invialo agli endpoint più pesanti invece di ricalcolare ogni volta. Poiché la risposta è solo dati (niente prose, nessuna immagine), si integra facilmente in qualsiasi stack: rendilo tu stesso, passalo a un LLM, o consegnalo a uno dei nostri endpoint di rendering SVG.
Notes
I valori predefiniti seguono la convenzione occidentale dominante: zodiaco tropicale, case Placidus, "Big Three" Sole–Luna–Ascendente. Il motore è Swiss Ephemeris (Astrodienst) e condiviso con il calcolatore in-browser, così server e client concordano sull'arco-secondo. Le case ricadono su Porphyry sopra il circolo polare dove Placidus è indefinito.
Try the Tema natale API
Grab a key and make your first call in under a minute.