API Thème de transit
Capture le ciel à n'importe quelle date cible et superpose-le sur le cadre des maisons natales d'une personne en un seul POST. Planètes en transit, les cuspides natales qu'elles traversent, la grille d'aspects entre les corps en transit, plus parallèles et antiscia – précision Swiss Ephemeris, sortie JSON.
API Thème de transit
L'endpoint transits prend les données natales d'une personne – date de naissance, heure, décalage UTC, latitude, longitude et système de maisons – ainsi qu'un moment cible séparé. Il convertit cette date et heure cible en jour julien, interroge le moteur Swiss Ephemeris pour la longitude, latitude et vitesse géocentriques de chaque corps en transit, puis projette ces positions dans les maisons dérivées de la localisation natale. La réponse renvoie les planètes en transit avec leurs signes et placements en maison, les cuspides des maisons natales, et la grille complète d'aspects calculée entre les corps en transit eux-mêmes, chaque aspect avec indicateur d'application ou de séparation et orbites exactes. Elle renvoie aussi les aspects parallèles et antiscia (points miroirs) pour la déclinaison et le travail sur l'axe solsticial. Le mouvement rétrograde est indiqué par la vitesse du corps, ainsi tu vois quels transits sont directs, stationnaires ou en marche arrière au moment demandé.
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
Utilise ceci quand tu veux le ciel complet tel qu'il se trouve au-dessus du thème de quelqu'un à un jour donné – un widget de transits quotidiens, un panneau style météo « ce qui est au-dessus maintenant », ou le cadre brut qu'un agent AI lit avant de décrire le climat astrologique actuel. Comme il renvoie le thème de transit superposé au cadre des maisons natales plutôt qu'une liste filtrée de contacts transit-to-natal, c'est le bon choix quand tu as besoin de la capture structurelle elle-même. Si tu veux plutôt des hits transit-to-natal chronométrés sur une plage de dates – dates exactes, ingressions, points de station – utilise l'endpoint transit-calendar, qui est fait pour ce travail de timing. Combine les deux : cet endpoint pour le thème instantané, le calendrier pour la liste d'événements à venir.
Notes
Sois précis sur le périmètre : cela renvoie le thème de transit superposé au cadre des maisons natales, pas une liste pré-filtrée d'aspects transit-to-natal. La grille d'aspects est calculée entre les corps en transit, pas entre les points transit et natals. Pour un timing to-natal sur une plage de dates, utilise /transit-calendar. Les maisons suivent le système natal que tu as choisi ; zodiac tropical et Swiss Ephemeris partout.
Try the Thème de transit API
Grab a key and make your first call in under a minute.