Transit-Chart-API
Erfassen Sie den Himmel zu einem beliebigen Zieldatum und legen Sie ihn mit einem einzigen POST über das natale Häusergerüst einer Person. Transitierende Planeten, die natalen Häuserspitzen, in die sie fallen, das Aspektgitter unter den transitierenden Körpern, dazu Parallelen und Antiszien — Swiss-Ephemeris-Präzision, JSON als Ausgabe.
Transit-Chart-API
Der transits-Endpunkt nimmt die natalen Daten einer Person — Geburtsdatum, -zeit, UTC-Offset, Breite, Länge und Häusersystem — und einen separaten Zielmoment entgegen. Er löst dieses Zieldatum und die Uhrzeit zu einem julianischen Datum auf, fragt die Swiss-Ephemeris-Engine nach der geozentrischen Länge, Breite und Geschwindigkeit jedes transitierenden Körpers ab und projiziert diese Positionen dann in die Häuser, die aus dem Geburtsort abgeleitet sind. Die Antwort enthält die transitierenden Planeten mit ihren Zeichen und Hausstellungen, die natalen Häuserspitzen und das vollständige Aspektgitter, das unter den transitierenden Körpern selbst berechnet wird, jeweils mit applikativen oder separativen Markierungen und exakten Orben. Sie gibt außerdem Parallel- und Antiszien-Aspekte (Spiegelpunkte) für die Arbeit mit Deklination und Solstitialachse zurück. Rückläufige Bewegung wird anhand der Körpergeschwindigkeit markiert, sodass Sie sehen können, welche Transite zum gewünschten Moment direktläufig, stationär oder rückläufig sind.
POST/v1/transits
curl -X POST https://api.astroway.info/v1/transits \
-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,
"transitDate": "2026-06-15",
"transitTime": "12:00:00",
"transitTzOffset": 3
}'{
"ok": true,
"data": {
"input": {},
"julianDay": 2461206.875,
"planets": [
{
"name": "Sun",
"longitude": 84.29,
"sign": "Gemini",
"house": 11
}
],
"houses": {
"ascendant": 160.4,
"mc": 70.1,
"cusps": [
"…"
]
},
"aspects": [
{
"planet1": "Sun",
"planet2": "Moon",
"type": "conjunction",
"orb": 1.2,
"applying": true
}
],
"parallelAspects": [
"…"
],
"antiscia": [
"…"
]
}
}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). |
| transitDate | string (YYYY-MM-DD) | ja | Required target date for the transit snapshot (YYYY-MM-DD). |
| transitTime | string (HH:MM:SS) | nein | Optional clock time of the transit moment (HH:MM:SS). |
| transitTzOffset | number (hours) | nein | Optional UTC offset for the transit moment, in hours. |
Wann verwenden
Verwenden Sie dies, wenn Sie den gesamten Himmel wollen, wie er an einem bestimmten Tag über dem Horoskop einer Person steht — ein Tagestransit-Widget, ein wetterartiges Panel „Was steht gerade am Himmel“, oder das rohe Gerüst, das ein KI-Agent liest, bevor er das aktuelle astrologische Klima beschreibt. Da der Endpunkt das Transithoroskop über dem natalen Häusergerüst zurückgibt statt einer kuratierten Liste von Transit-zu-Natal-Kontakten, ist er die richtige Wahl, wenn Sie die strukturelle Momentaufnahme selbst benötigen. Wenn Sie stattdessen zeitlich abgestimmte Transit-zu-Natal-Treffer über einen Datumsbereich gescannt haben möchten — exakte Daten, Eintritte, Stationspunkte — greifen Sie zum transit-calendar-Endpunkt, der für diese Timing-Aufgabe gebaut ist. Kombinieren Sie beide: diesen Endpunkt für das Horoskop des Zeitpunkts, den Kalender für die vorausschauende Ereignisliste.
Hinweise
Seien Sie präzise hinsichtlich des Umfangs: Dies gibt das Transithoroskop zurück, das über das natale Häusergerüst gelegt ist, nicht eine vorgefilterte Liste von Transit-zu-Natal-Aspekten. Das Aspektgitter wird unter den transitierenden Körpern berechnet, nicht zwischen Transit- und natalen Punkten. Für Transit-zu-Natal-Timing über einen Zeitraum verwenden Sie /transit-calendar. Häuser folgen Ihrem gewählten natalen System; tropischer Tierkreis und Swiss Ephemeris durchgängig.
Transithoroskop-API ausprobieren
Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.