API Solárního návratu
Vytvořte horoskop pro přesný okamžik, kdy se Slunce vrátí do svého natálního stupně ve zvoleném roce – astrologické narozeniny. Předáte natální horoskop a rok, získáte horoskop solárního návratu pro daný cyklus. Tropický, Slunce k natálnímu Slunci, přesnost Swiss Ephemeris, výstup JSON.
API Solárního návratu
Endpoint solárního návratu nejprve přečte přesnou zodiakální délku natálního Slunce z dodaných dat narození, poté pro daný rok vyhledá přesný okamžik, kdy se tranzitující Slunce vrátí na stejnou délku – obvykle do jednoho dne od kalendářních narozenin. Tento okamžik návratu převede na juliánský den, získá geocentrické pozice a rychlosti z enginu Swiss Ephemeris a vytvoří pro něj kompletní horoskop: planety návratu se znameními a umístěním v domech, hroty domů a kompletní mřížku aspektů s aplikujícími a separujícími příznaky a přesnými orby. Shoda je tropická a Slunce k natálnímu Slunci, ve výchozím nastavení není korigována precesí, takže se Slunce návratu nachází na tropickém stupni natálního Slunce. Výsledný horoskop je čten jako mapa dominantních témat pro rok běžící od jedněch narozenin k dalším.
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
Použijte solární návrat pro roční předpovědi – zprávu 'rok dopředu', funkci narozeninového horoskopu nebo AI tok, který vytváří dvanáctiměsíční výhled z jednoho datovaného horoskopu. Je to tahoun predikce založené na návratech: úhly, dům, do kterého spadá Slunce návratu, a nejtěsnější aspekty jsou čteny jako hlavní témata pro daný solární rok. Spárujte jej s tranzity a progresí pro hloubku, ale samotný solární návrat poskytuje čistý, soběstačný roční snímek vázaný na vlastní narozeniny osoby, nikoli na kalendář. Protože předáváte pouze natální data plus rok, snadno se hodí pro spouštěče výročí a plánované roční e-maily – přepočítávejte každý rok, abyste posunuli předpověď vpřed.
Notes
Návrat je tropicky sladěn, Slunce k natálnímu Slunci, a ve výchozím nastavení není korigován precesí, takže odráží konvenční západní solární návrat spíše než sidericky korigovanou variantu. Je vytvořen pro dodané natální místo; přemístěné solární návraty by vyžadovaly přepočítání na jiném místě. Tropický zvěrokruh a Swiss Ephemeris v celém rozsahu.
Try the Solární návrat API
Grab a key and make your first call in under a minute.