Zonne-terugkeer API
Bereken de kaart voor het exacte moment dat de Zon terugkeert naar zijn geboortegraad in een gekozen jaar - de astrologische verjaardag. Geef een geboortekaart en een jaar op, en ontvang de zonne-terugkeerkaart voor die cyclus. Tropisch, Zon-naar-geboorte-Zon, Swiss Ephemeris precisie, JSON uitvoer.
Zonne-terugkeer API
De zonne-terugkeer-eindpunt leest eerst de exacte zodiacale lengtegraad van de geboorte-Zon uit de verstrekte geboortegegevens, doorzoekt daarna het opgegeven jaar naar het precieze moment dat de doorgangs-Zon terugkeert naar diezelfde lengtegraad - meestal binnen een dag of twee van de kalenderverjaardag. Het lost dat terugkeermoment op naar een Juliaanse dag, haalt geocentrische posities en snelheden op uit de Swiss Ephemeris-engine, en berekent een volledige kaart daarvoor: de terugkeerplaneten met tekens en huizenplaatsingen, de huiskoppen, en de volledige aspectenrooster met toepassende en loslatende vlaggen en exacte orbs. De overeenkomst is tropisch en Zon-naar-geboorte-Zon, niet vooraf precessie-correctie, dus de terugkeer-Zon bevindt zich op de tropische graad van de geboorte-Zon. De resulterende kaart wordt gelezen als de dominante themakaart voor het jaar dat loopt van de ene verjaardag naar de volgende.
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
Gebruik de zonne-terugkeer voor jaarlijkse voorspellingen - een 'jaar vooruit' rapport, een verjaardagskaart-functie, of een AI-stroom die een twaalfmaands overzicht bouwt uit één gedateerde kaart. Het is de werkpaard van terugkeergebaseerde voorspellingen: de hoeken, het huis waarin de terugkeer-Zon valt, en de strakste aspecten worden gelezen als de hoofdd thema's voor dat zonnejaar. Koppel het met transits en progressies voor diepgang, maar de zonne-terugkeer alleen geeft een schone, zelfstandige jaarlijkse snapshot gekoppeld aan de persoonlijke verjaardag in plaats van de kalender. Omdat je alleen geboortegegevens plus een jaar doorgeeft, past het perfect in verjaardagstriggers en geplande jaarlijkse e-mails - bereken elk jaar opnieuw om de voorspelling vooruit te rollen.
Notes
De terugkeer is tropisch gematcht, Zon naar geboorte-Zon, en is standaard niet precessie-correctie, dus weerspiegelt het de conventionele Westerse zonne-terugkeer in plaats van de siderisch gecorrigeerde variant. Het wordt berekend voor de opgegeven geboortelocatie; verplaatste zonne-terugkeers zouden opnieuw moeten worden berekend op een andere plaats. Tropische dierenriem en Swiss Ephemeris doorlopend.
Try the Zonne-terugkeer API
Grab a key and make your first call in under a minute.