API Retour solaire
Calcule la carte pour l’instant exact où le Soleil revient à son degré natal dans une année choisie – l’anniversaire astrologique. Fournis une carte natale et une année, reçois la carte de retour solaire pour ce cycle. Tropical, Sun-to-natal-Sun, précision Swiss Ephemeris, sortie JSON.
API Retour solaire
Le endpoint solar-return lit d’abord la longitude zodiacale exacte du Soleil natal à partir des données de naissance fournies, puis parcourt l’année donnée pour trouver le moment précis où le Soleil en transit revient à cette même longitude – généralement dans un jour ou deux de l’anniversaire calendaire. Il convertit cet instant de retour en jour julien, récupère les positions géocentriques et les vitesses depuis le moteur Swiss Ephemeris, et calcule une carte complète : les planètes de retour avec leurs signes et placements en maisons, les cuspides des maisons, et la grille d’aspects complète avec les drapeaux d’application et de séparation et les orbes exactes. Le calcul est tropical et Sun-to-natal-Sun, non corrigé pour la précession par défaut, donc le Soleil de retour se trouve sur le degré tropical du Soleil natal. La carte obtenue est lue comme la carte des thèmes dominants pour l’année allant d’un anniversaire à l’autre.
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
Utilise le retour solaire pour la prévision annuelle – un rapport « année à venir », une fonction de carte d’anniversaire, ou un flux IA qui crée une perspective de douze mois à partir d’une seule carte datée. C’est le cheval de bataille des prédictions basées sur les retours : les angles, la maison où se trouve le Soleil de retour, et les aspects les plus serrés sont lus comme les thèmes principaux de l’année solaire. Combine-le avec les transits et les progressions pour plus de profondeur, mais le retour solaire seul fournit un instantané annuel propre et autonome, basé sur l’anniversaire de la personne plutôt que sur le calendrier. Comme tu ne fournis que les données natales + une année, il s’intègre parfaitement aux déclencheurs d’anniversaire et aux e-mails annuels programmés – recalcul chaque année pour faire avancer la prévision.
Notes
Le retour est apparié de façon tropicale, Soleil à Soleil natal, et n’est pas corrigé pour la précession par défaut, il reflète donc le retour solaire occidental conventionnel plutôt que la variante sidérale corrigée. Il est calculé pour le lieu natal fourni ; les retours solaires relocalisés nécessiteraient un nouveau calcul à un autre endroit. Zodiaque tropical et Swiss Ephemeris tout au long.
Try the Retour solaire API
Grab a key and make your first call in under a minute.