API del Grafico dei Transiti
Cattura il cielo in qualsiasi data target e sovrapponilo al tema natale di una persona in un unico POST. Pianeti in transito, le cuspidi natali in cui cadono, la griglia degli aspetti tra i corpi in transito, più paralleli e antiscia – precisione Swiss Ephemeris, output JSON.
API del Grafico dei Transiti
L'endpoint dei transiti prende i dati natali di una persona – data di nascita, ora, offset UTC, latitudine, longitudine e sistema delle case – e un momento target separato. Risolve quella data e ora in un giorno Giuliano, chiede al motore Swiss Ephemeris la longitudine, latitudine e velocità geocentriche di ogni corpo in transito, poi assegna quelle posizioni alle case derivate dalla posizione natale. La risposta restituisce i pianeti in transito con i loro segni e collocazioni nelle case, le cuspidi delle case natali e l'intera griglia degli aspetti calcolata tra i corpi in transito stessi, ciascuno con flag di applicazione o separazione e orbite esatte. Restituisce anche aspetti paralleli e antiscia (punto speculare) per declinazione e lavoro sull'asse solstiziale. Il moto retrogrado è segnalato dalla velocità del corpo, così puoi vedere quali transiti sono diretti, stazionari o retrogradi nel momento richiesto.
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
Usalo quando vuoi vedere l'intero cielo sopra il tema di qualcuno in un giorno specifico – un widget di transiti giornalieri, un pannello in stile meteo “cosa c'è sopra ora”, o il frame grezzo che un agente AI legge prima di descrivere il clima astrologico attuale. Poiché restituisce il grafico dei transiti sul quadro delle case natali invece di una lista curata di contatti transito-natal, è la scelta giusta quando ti serve lo snapshot strutturale stesso. Se invece ti servono transiti-natal temporizzati scansionati su un intervallo di date – date esatte, ingressi, punti di stazionarietà – usa l'endpoint transit-calendar, pensato per quel lavoro di timing. Abbina i due: questo endpoint per il grafico del momento, il calendar per la lista di eventi futuri.
Notes
Fai attenzione all'ambito: questo restituisce il grafico dei transiti sovrapposto al quadro delle case natali, non una lista pre-filtrata di aspetti transito-natal. La griglia degli aspetti è calcolata tra i corpi in transito, non tra punti transito e natal. Per il timing transito-natal su un intervallo di date, usa /transit-calendar. Le case seguono il sistema natale scelto; zodiac tropicale e Swiss Ephemeris per tutto.
Try the Grafico dei transiti API
Grab a key and make your first call in under a minute.