Solar Return API
Készítsd el a chart-ot a pontos pillanatra, amikor a Nap visszatér a születési fokához egy választott évben – az asztrológiai születésnapra. Adj meg egy natal chart-ot és egy évet, és kapsz egy solar return chart-ot az adott ciklusra. Tropical, Sun-to-natal-Sun, Swiss Ephemeris pontosság, JSON kimenet.
Solar Return API
A solar-return endpoint először kiolvassa a születési adatokból a születési Nap pontos zodiákus hosszúságát, aztán átkutatja a megadott évet a pontos pillanatért, amikor a transzitív Nap visszatér ugyanarra a hosszúságra – általában egy nap körül a naptári születésnap körül. Ezt a visszatérési pillanatot Julian day-ra konvertálja, a Swiss Ephemeris motorból lekéri a geocentrikus pozíciókat és sebességeket, és egy teljes chart-ot készít: a visszatérő bolygók jelekkel és házhelyzetekkel, a házcsúcsokkal, valamint a teljes aspektus rácsot alkalmazó és elváló jelzésekkel és pontos orbokkal. A párosítás tropical és Sun-to-natal-Sun, alapértelmezésben nincs precession-corrected, így a visszatérő Nap a születési Nap tropical fokán van. Az eredményül kapott chart-ot a domináns téma térképként olvassák az évre, ami egy születésnaptól a következőig tart.
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
Használd a solar return-t éves előrejelzéshez – egy 'year ahead' jelentés, egy birthday-chart funkció, vagy egy AI flow, ami egyetlen dátummal ellátott chart-ból épít fel egy 12 hónapos kilátást. Ez a visszatérő-alapú jóslás munkáspolgára: a szögek, a ház, ahová a visszatérő Nap esik, és a legszorosabb aspektusok a fő témákat adják az adott napévre. Párosítsd transits és progressions segítségével a mélységért, de a solar return önmagában tiszta, önálló éves pillanatképet ad, ami a személy saját születésnapjához van kötve, nem a naptárhoz. Mivel csak születési adatot és egy évet adsz meg, könnyen beilleszthető anniversary trigger-ekbe és ütemezett annual emails-be – recompute minden évben, hogy a forecast továbbhaladjon.
Notes
A visszatérés tropikusan, Sun to natal Sun párosítva, és alapértelmezésben nincs precession-corrected, így a konvencionális Western solar return-ot tükrözi, nem a sidereal-corrected változatot. A chart a megadott natal location-hoz készül; áthelyezett solar return-hoz újrakészítés szükséges más helyen. Tropical zodiac és Swiss Ephemeris mindenhol.
Try the Solar Return API
Grab a key and make your first call in under a minute.