Transit Kaart API
Maak een foto van de hemel op elke doel datum en leg deze over het geboortehuis kader van een persoon in één POST. Doorgaande planeten, de geboortehuis cusps waar ze in vallen, het aspect rooster onder de doorgaende lichamen, plus parallellen en antiscia - Swiss Ephemeris precisie, JSON uit.
Transit Kaart API
Het transits endpoint neemt de geboortegegevens van een persoon - geboortedatum, tijd, UTC offset, breedtegraad, lengtegraad, en huizensysteem - en een apart doel moment. Het lost die doel datum en klok tijd op naar een Juliaanse dag, vraagt de Swiss Ephemeris motor om de geocentrische lengtegraad, breedtegraad, en snelheid van elke doorgaende lichaam, en werpt die posities dan in de huizen die afgeleid zijn van de geboortelocatie. Het antwoord bevat de doorgaande planeten met hun tekens en huizen plaatsingen, de geboortehuis cusps, en het volledige aspect rooster berekend onder de doorgaende lichamen zelf, elk met toepassende of scheidende vlaggen en exacte orbs. Het geeft ook parallellen en antiscia (spiegel-punt) aspecten terug voor declinatie en zonnewende-as werk. Retrograde beweging wordt gemarkeerd op basis van lichaam snelheid, zodat je kunt zien welke transits direct, stationair, of achteruit bewegen op het gevraagde moment.
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": [
"…"
]
}
}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). |
| transitDate | string (YYYY-MM-DD) | yes | Required target date for the transit snapshot (YYYY-MM-DD). |
| transitTime | string (HH:MM:SS) | no | Optional clock time of the transit moment (HH:MM:SS). |
| transitTzOffset | number (hours) | no | Optional UTC offset for the transit moment, in hours. |
When to use it
Gebruik dit wanneer je de hele hemel wilt zien zoals die boven iemands kaart hangt op een bepaalde dag - een dagelijkse-transits widget, een weer-stijl 'wat staat er nu boven' paneel, of het ruwe kader dat een AI agent leest voordat het het huidige astrologische klimaat beschrijft. Omdat het de transit kaart teruggeeft over het geboortehuis kader in plaats van een geselecteerde lijst van transit naar geboorte contacten, is het de juiste keuze wanneer je de structurele snapshot zelf nodig hebt. Als je in plaats daarvan getimede transit naar geboorte treffers wilt scannen over een datumbereik - exacte datums, ingresses, station punten - pak dan het transit-calendar endpoint, dat is gebouwd voor die timing taak. Koppel de twee: dit endpoint voor het moment-in-de-tijd kaart, de kalender voor de vooruitkijkende gebeurtenissen lijst.
Notes
Wees precies over het bereik: dit geeft de transit kaart weer over het geboortehuis kader, niet een vooraf gefilterde transit naar geboorte aspect lijst. Het aspect rooster wordt berekend onder de doorgaende lichamen, niet tussen transit en geboorte punten. Voor naar-geboorte timing over een datumbereik, gebruik /transit-calendar. Huizen volgen je gekozen geboorte systeem; tropische dierenriem en Swiss Ephemeris doorlopend.
Try the Transit Kaart API
Grab a key and make your first call in under a minute.