Geboortehoroscoop API
Zet één geboortemoment om in een complete, gestructureerde geboortehoroscoop - planeten, huizen, aspecten en hoekdata - in één POST. Tropische dierenriem, dertien huizensystemen, Swiss Ephemeris precisie, JSON output.
Geboortehoroscoop API
Het geboortehoroscoop endpoint zet de geboortedatum, tijd en UTC-offset om naar een precieze Juliaanse dag, en vraagt vervolgens de Swiss Ephemeris engine om de geocentrische lengtegraad, breedtegraad en snelheid van elk lichaam - de tien klassieke planeten plus de maanknopen, Chiron en de Zwarte Maan Lilith. Het leidt de Ascendant en Midhemel af van de geboorte breedtegraad en lengtegraad, verdeelt de huizen volgens jouw gekozen systeem, wijst elke planeet toe aan zijn teken en huis, en berekent het volledige aspectenraster met toepassende/scheidende vlaggen en exacte orbs. Retrograde beweging wordt gemarkeerd op basis van de snelheid van het lichaam, en de horoscoopsectie (dag- of nachtgeboorte) wordt geretourneerd, zodat verdere interpretatie de weldoeners en kwaaddoeners correct kan wegen.
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
Gebruik dit endpoint wanneer je de structurele ruggengraat van een horoscoop nodig hebt: een geboortehoroscoop widget, een geboorterapport, een onboarding flow die content personaliseert op basis van Zon/Maan/Ascendant, of een AI-agent die de ruwe plaatsingen nodig heeft voordat het iets interpreteert. Het is de vereiste aanroep voor synastrie, transits, progressies en de meeste rapporttypen - bereken de horoscoop één keer, cache de JSON, en voer deze in de zwaardere endpoints in plaats van elke keer opnieuw te berekenen. Omdat de respons pure data is (geen proza, geen afbeeldingen), past het naadloos in elke stack: render het zelf, geef het door aan een LLM, of geef het aan een van onze SVG render endpoints.
Notes
Standaardwaarden volgen de gangbare Westerse conventie: tropische dierenriem, Placidus huizen, Zon–Maan–Ascendant "Grote Drie". De engine is Swiss Ephemeris (Astrodienst) en gedeeld met de in-browser calculator, zodat server en client tot op de boogseconde overeenkomen. Huizen vallen terug op Porphyrius boven de poolcirkel waar Placidus ongedefinieerd is.
Try the Geboortehoroscoop API
Grab a key and make your first call in under a minute.