Solar-Return-API
Berechnen Sie das Horoskop für den exakten Augenblick, in dem die Sonne in einem gewählten Jahr zu ihrem natalen Grad zurückkehrt — der astrologische Geburtstag. Übergeben Sie ein Geburtshoroskop und ein Jahr und erhalten Sie das Solarrückkehr-Horoskop für diesen Zyklus. Tropisch, Sonne-zu-natale-Sonne, Swiss-Ephemeris-Präzision, JSON als Ausgabe.
Solar-Return-API
Der solar-return-Endpunkt liest zunächst die exakte ekliptikale Länge der natalen Sonne aus den übergebenen Geburtsdaten und durchsucht dann das angegebene Jahr nach dem präzisen Moment, in dem die transitierende Sonne zu eben dieser Länge zurückkehrt — typischerweise innerhalb von etwa einem Tag um den kalendarischen Geburtstag. Er löst diesen Rückkehraugenblick zu einem julianischen Datum auf, holt geozentrische Positionen und Geschwindigkeiten aus der Swiss-Ephemeris-Engine und berechnet ein vollständiges Horoskop dafür: die Rückkehrplaneten mit Zeichen und Hausstellungen, die Häuserspitzen und das vollständige Aspektgitter mit applikativen und separativen Markierungen und exakten Orben. Die Übereinstimmung ist tropisch und Sonne-zu-natale-Sonne, standardmäßig nicht präzessionskorrigiert, sodass die Rückkehrsonne auf dem tropischen Grad der natalen Sonne sitzt. Das resultierende Horoskop wird als dominante Themenkarte für das Jahr von einem Geburtstag zum nächsten gelesen.
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": [
"…"
]
}
}Parameter
| name | type | Erforderlich | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | ja | Birth date. |
| time | string (HH:MM:SS) | ja | Local clock time at birth. |
| timezoneOffset | number (hours) | ja | UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones. |
| latitude | number | ja | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | ja | Birth-place longitude, decimal degrees (east positive). |
| year | number | ja | Required integer year in which to find the Sun's return to its natal longitude. |
Wann verwenden
Verwenden Sie die Solarrückkehr für jährliche Prognosen — einen Bericht „Das Jahr voraus“, eine Geburtstagshoroskop-Funktion oder einen KI-Ablauf, der aus einem einzigen datierten Horoskop einen Zwölf-Monats-Ausblick erstellt. Sie ist das Arbeitspferd der rückkehrbasierten Vorhersage: Die Achsen, das Haus, in das die Rückkehrsonne fällt, und die engsten Aspekte werden als die zentralen Themen für dieses Sonnenjahr gelesen. Kombinieren Sie sie für Tiefe mit Transiten und Direktionen, aber die Solarrückkehr allein liefert eine saubere, in sich geschlossene Jahresmomentaufnahme, die am Geburtstag der Person und nicht am Kalender ausgerichtet ist. Da Sie nur natale Daten plus ein Jahr übergeben, fügt sie sich elegant in Jahrestags-Trigger und geplante Jahres-E-Mails ein — berechnen Sie sie jedes Jahr neu, um die Prognose voranzurollen.
Hinweise
Die Rückkehr wird tropisch abgeglichen, Sonne zu natale Sonne, und ist standardmäßig nicht präzessionskorrigiert, sodass sie die konventionelle westliche Solarrückkehr widerspiegelt und nicht die siderisch korrigierte Variante. Sie wird für den übergebenen Geburtsort berechnet; relozierte Solarrückkehren würden eine Neuberechnung an einem anderen Ort erfordern. Tropischer Tierkreis und Swiss Ephemeris durchgängig.
Solarrückkehr-API ausprobieren
Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.