API Thème Natal
Transformez un moment de naissance en un thème natal complet et structuré - planètes, maisons, aspects, et données angulaires - en un seul POST. Zodiaque tropical, treize systèmes de maisons, précision Swiss Ephemeris, sortie JSON.
API Thème Natal
Le point de terminaison thème-natal résout la date de naissance, l'heure de l'horloge et le décalage UTC en un jour julien précis, puis demande au moteur Swiss Ephemeris la longitude géocentrique, la latitude et la vitesse de chaque corps - les dix planètes classiques plus les nœuds lunaires, Chiron et la Lune Noire Lilith. Il déduit l'Ascendant et le Milieu du Ciel à partir de la latitude et longitude de naissance, divise les maisons selon le système choisi, attribue chaque planète à son signe et maison, et calcule la grille complète des aspects avec indicateurs d'application/séparation et orbites exactes. Le mouvement rétrograde est signalé à partir de la vitesse du corps, et le sect du thème (naissance de jour ou de nuit) est retourné afin que l'interprétation en aval puisse correctement pondérer les bénéfiques et maléfiques.
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
Utilisez ce point de terminaison chaque fois que vous avez besoin de la structure de base d'un horoscope : un widget de thème natal, un rapport natal, un processus d'intégration qui personnalise le contenu par Soleil/Lune/Ascendant, ou un agent IA qui a besoin des positions brutes avant toute interprétation. C'est l'appel préalable pour la synastrie, les transits, les progressions et la plupart des types de rapports - calculez le thème une fois, mettez en cache le JSON, et alimentez les points de terminaison plus lourds au lieu de recalculer à chaque fois. Comme la réponse est purement des données (pas de prose, pas d'images), elle s'intègre parfaitement à n'importe quelle pile : affichez-la vous-même, passez-la à un LLM, ou transmettez-la à l'un de nos points de terminaison de rendu SVG.
Notes
Les valeurs par défaut suivent la convention occidentale principale : zodiaque tropical, maisons Placidus, Soleil–Lune–Ascendant "Grande Trois". Le moteur est Swiss Ephemeris (Astrodienst) et partagé avec le calculateur en navigateur, donc serveur et client s'accordent sur la seconde d'arc. Les maisons reviennent à Porphyry au-dessus du cercle polaire où Placidus est indéfini.
Try the Thème Natal API
Grab a key and make your first call in under a minute.