Natal-Chart-API
Verwandeln Sie einen einzigen Geburtsmoment mit einem einzigen POST in ein vollständiges, strukturiertes Geburtshoroskop — Planeten, Häuserspitzen, Aspekte und Achsendaten. Tropischer Tierkreis, dreizehn Häusersysteme, Swiss-Ephemeris-Präzision, JSON als Ausgabe.
Natal-Chart-API
Der natal-chart-Endpunkt löst Geburtsdatum, Uhrzeit und UTC-Offset zu einem präzisen julianischen Datum auf und fragt dann die Swiss-Ephemeris-Engine nach der geozentrischen Länge, Breite und Geschwindigkeit jedes Körpers ab — den zehn klassischen Planeten plus den Mondknoten, Chiron und der Schwarzen Mond Lilith. Er leitet Aszendent und Medium Coeli aus der Geburtsbreite und -länge ab, teilt die Häuser nach dem gewählten System auf, weist jeden Planeten seinem Zeichen und Haus zu und berechnet das vollständige Aspektgitter mit applikativen/separativen Markierungen und exakten Orben. Rückläufige Bewegung wird anhand der Körpergeschwindigkeit markiert, und die Sekte des Horoskops (Tag- oder Nachtgeburt) wird zurückgegeben, damit die nachgelagerte Deutung Benefizen und Malefizen korrekt gewichten kann.
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 } ]
}
}Parameter
| name | type | Erforderlich | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | ja | Birth date. |
| time | string (HH:MM:SS) | ja | Local clock time at birth. |
| timezoneOffset | number (hours) | ja | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | ja | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | ja | Birth-place longitude, decimal degrees (east positive). |
| houseSystem | string | nein | One-letter Swiss Ephemeris code — P (Placidus, default), K (Koch), W (whole-sign), R (Regiomontanus), and 10 more. |
Wann verwenden
Greifen Sie zu diesem Endpunkt, wann immer Sie das strukturelle Rückgrat eines Horoskops benötigen: ein Geburtshoroskop-Widget, einen Geburtsbericht, einen Onboarding-Ablauf, der Inhalte nach Sonne/Mond/Aszendent personalisiert, oder einen KI-Agenten, der die rohen Stellungen braucht, bevor er etwas deutet. Es ist der vorausgesetzte Aufruf für Synastrie, Transite, Direktionen und die meisten Berichtsarten — berechnen Sie das Horoskop einmal, cachen Sie das JSON und speisen Sie es in die rechenintensiveren Endpunkte ein, statt es jedes Mal neu zu berechnen. Da die Antwort reine Daten sind (keine Prosa, keine Bilder), fügt sie sich sauber in jeden Stack ein: Rendern Sie sie selbst, übergeben Sie sie an ein LLM oder reichen Sie sie an einen unserer SVG-Render-Endpunkte weiter.
Hinweise
Die Voreinstellungen folgen der gängigen westlichen Konvention: tropischer Tierkreis, Placidus-Häuser, die „großen Drei“ Sonne–Mond–Aszendent. Die Engine ist Swiss Ephemeris (Astrodienst), zu WASM kompiliert und mit dem im Browser laufenden Rechner geteilt, sodass Server und Client bis auf die Bogensekunde übereinstimmen. Häuser fallen oberhalb des Polarkreises, wo Placidus undefiniert ist, auf Porphyrius zurück.
Geburtshoroskop-API ausprobieren
Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.