API Ritorno Solare
Calcola il tema per l'istante esatto in cui il Sole torna al suo grado natale in un anno scelto - il compleanno astrologico. Passa un tema natale e un anno, ottieni il tema del ritorno solare per quel ciclo. Tropicale, Sole-su-Sole-natale, precisione Swiss Ephemeris, output JSON.
API Ritorno Solare
L'endpoint del ritorno solare legge prima la longitudine esatta zodiacale del Sole natale dai dati di nascita forniti, poi cerca nell'anno dato l'istante preciso in cui il Sole transito torna alla stessa longitudine - tipicamente entro un giorno circa del compleanno del calendario. Risolve quell'istante di ritorno a un giorno giuliano, estrae posizioni e velocità geocentriche dal motore Swiss Ephemeris, e calcola un tema completo per esso: i pianeti di ritorno con posizioni di segni e case, i cuspi delle case, e la griglia completa degli aspetti con bandiere applicanti e separanti e orbite esatte. La corrispondenza è tropicale e Sole-su-Sole-natale, non corretta per precessione di default, quindi il Sole di ritorno si trova sul grado tropicale del Sole natale. Il tema risultante viene letto come mappa tematica dominante per l'anno che va da un compleanno al successivo.
POST/v1/solar-return
curl -X POST https://api.astroway.info/v1/solar-return \
-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,
"year": 2026
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Sun",
"longitude": 54.23,
"sign": "Taurus",
"house": 9
}
],
"houses": {
"ascendant": 188.2,
"mc": 95,
"cusps": [
"…"
]
},
"aspects": [
"…"
]
}
}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). |
| year | number | yes | Required integer year in which to find the Sun's return to its natal longitude. |
When to use it
Usa il ritorno solare per la previsione annuale - un rapporto 'anno avanti', una funzionalità di tema di compleanno, o un flusso AI che costruisce una prospettiva di dodici mesi da un singolo tema datato. È il cavallo di battaglia della previsione basata sui ritorni: gli angoli, la casa in cui cade il Sole di ritorno, e gli aspetti più stretti vengono letti come temi principali per quell'anno solare. Accoppialo con transiti e progressioni per approfondire, ma il ritorno solare da solo dà una pulita, autocontenuta istantanea annuale basata sul compleanno della persona piuttosto che sul calendario. Poiché passi solo dati natali più un anno, si inserisce perfettamente in trigger di anniversario e email annuali programmate - ricalcola ogni anno per avanzare la previsione.
Notes
Il ritorno è abbinato tropicalmente, Sole su Sole natale, e non è corretto per precessione di default, quindi riflette il ritorno solare occidentale convenzionale piuttosto che la variante corretta siderale. È calcolato per la posizione natale fornita; i ritorni solari trasferiti richiederebbero ricalcolo in un luogo diverso. Zodiaco tropicale e Swiss Ephemeris in tutto.
Try the Ritorno Solare API
Grab a key and make your first call in under a minute.