Měsíční návrat API
Najdi další okamžik, kdy se Měsíc vrátí domů na svou natalní délku po zvoleném datu – zhruba každých 27,3 dne – a vytvoř pro něj horoskop na místě, které si vybereš. Pošli natal data a počáteční datum, získáš horoskop měsíčního návratu. Přesnost Swiss Ephemeris, výstup v JSON.
Měsíční návrat API
Endpoint lunar-return načte přesnou délku natalního Měsíce z poskytnutých narozeninových údajů, pak hledá od zadaného počátečního data první okamžik, kdy se tranzitní Měsíc vrátí na stejnou délku. Protože Měsíc dokončí siderický cyklus za cca 27,3 dne, tento návrat nastává zhruba měsíčně. Endpoint převede nalezený okamžik na juliánský den, získá geocentrické pozice a rychlosti ze Swiss Ephemeris, a vytvoří kompletní horoskop – vrátí planety se znameními a domy, vrcholy domů a úplnou mřížku aspektů s příznaky aplikace a separace a přesnými orbami. Ve výchozím nastavení je horoskop vytvořen pro natalní místo, ale můžeš zadat jiné zeměpisné souřadnice, aby se návrat přemístil, což přetvoří úhly a domy, ale zachová stejný okamžik návratu. Výsledek představuje mapu emocionálního a rytmického tématu pro nadcházející lunární měsíc.
POST/v1/lunar-return
curl -X POST https://api.astroway.info/v1/lunar-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,
"afterDate": "2026-06-15"
}'{
"ok": true,
"data": {
"input": {},
"planets": [
{
"name": "Moon",
"longitude": 282.7,
"sign": "Capricorn",
"house": 6
}
],
"houses": {
"ascendant": 201.5,
"mc": 110.3,
"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). |
| afterDate | string (YYYY-MM-DD) | yes | Required start date (YYYY-MM-DD); the endpoint finds the first lunar return on or after it. |
| afterTime | string (HH:MM:SS) | no | Optional clock time of the start point (HH:MM:SS). |
| afterTzOffset | number (hours) | no | Optional UTC offset for the start point, in hours. |
| locationLat | number | no | Optional latitude in decimal degrees to relocate the return chart, north positive. |
| locationLng | number | no | Optional longitude in decimal degrees to relocate the return chart, east positive. |
When to use it
Použij lunární návrat pro krátkodobé, zhruba měsíční předpovědi – funkci „lunární měsíc dopředu“, sledování emocionálního rytmu nebo podrobnější doplněk k ročnímu slunečnímu návratu. Kde sluneční návrat rámuje celý rok, lunární návrat rámuje následující čtyři týdny, takže je vhodný pro pravidelné měsíční zprávy a cykly návyků nebo nálad. Pošli počáteční datum jako bod, od kterého chceš další návrat – často dnes, nebo datum posledního návratu – a endpoint se posune k nadcházejícímu. Volitelný přepis místa ti umožní vytvořit návrat tam, kde se osoba ten měsíc skutečně nachází, místo jejího místa narození, což má vliv na úhly citlivých domů. Řetěz successive volání pro vytvoření sekvence měsíčních horoskopů.
Notes
Endpoint vrací další jediný návrat v nebo po zadaném datu, ne sérii – volávej opakovaně, posunuj počáteční datum, aby ses dostal k sekvenci. Číslo ~27,3 dne představuje siderický měsíc, takže návraty se posouvají vůči kalendáři. Pokud není zadáno místo, horoskop se vytvoří pro natalní místo; přepis přesune jen úhly a domy. Tropický zvěrokruh a Swiss Ephemeris po celou dobu.
Try the Měsíční návrat API
Grab a key and make your first call in under a minute.