AstroWay/api v2.201.6 · ro
toate sistemele sunt în stare normală
// astrology api · POST /v1/lunar-return

API Revenire Lunară

Găsește următoarea momentă în care Luna se întoarce la longitudinea sa natală pe sau după o dată aleasă - aproximativ la fiecare 27.3 zile - și trage harta pentru aceasta la o locație aleasă de tine. Treci datele natale și o dată de start, primești harta revenirii lunare. Precizie Swiss Ephemeris, JSON out.

Endpoint
POST /v1/lunar-return
Cost
50 credits
Latency
~62 ms
Tier
Tier 3
// 01 / What it computes

API Revenire Lunară

Endpointul lunar-return citește longitudinea exactă a Lunii natale din datele de naștere furnizate, apoi caută înainte de la data de start dată pentru prima clipă în care Luna tranzitând se întoarce la aceeași longitudine. Deoarece Luna completează un ciclu sideral în aproximativ 27.3 zile, acea revenire are loc lunar. Endpointul rezolvă clipa potrivită la o zi iuliană, extrage pozițiile și vitezele geocentrice din motorul Swiss Ephemeris și trage o hartă completă pentru ea - planetele de revenire cu semne și poziții în case, vârfurile case și grila completă de aspecte cu steaguri de aplicare și separare și orbite exacte. În mod implicit, harta este trasă pentru locul natal, dar poți furniza o altă latitudine și longitudine pentru a muta revenirea, ceea ce reconfigurează unghiurile și casele păstrând aceeași clipă de revenire. Rezultatul citește ca hartă tematică emoțională și ritmică pentru luna lunară următoare.

// 02 / Live request

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"
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "input": {},
    "planets": [
      {
        "name": "Moon",
        "longitude": 282.7,
        "sign": "Capricorn",
        "house": 6
      }
    ],
    "houses": {
      "ascendant": 201.5,
      "mc": 110.3,
      "cusps": [
        "…"
      ]
    },
    "aspects": [
      "…"
    ]
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

When to use it

Folosește revenirea lunară pentru prognoze pe termen scurt, lunară - o funcție de 'luna lunară înainte', un tracker de ritm emoțional sau un companion mai detaliu pentru revenirea solară anuală. Dacă revenirea solară cadastrează un întreg an, revenirea lunară cadastrează următoarele patru săptămâni, făcându-se potrivită pentru rapoarte lunare recurente și cicluri de obiceiuri sau stări de spirit. Treci data de start ca punctul de care dorești următoarea revenire după - adesea astăzi sau data ultimei reveniri - și endpointul merge înainte spre cea iminentă. Suprascrierea opțională a locației îți permite să tragi revenirea pentru locul unde persoana se află de fapt în acea lună, nu locul de naștere, ceea ce contează pentru casele sensibile la unghiuri. Lansează apeluri succesive pentru a construi o secvență rulantă de harte lunare.

// 05 / Notes

Notes

Endpointul returnează următoarea revenire unică pe sau după data dată, nu o serie - apelează repetat, avansând data de start, pentru a construi o secvență. Figura de ~27.3 zile este luna siderală, așadar revenirile derivează față de calendar. Dacă nu este furnizată nicio locație, harta este trasă la locul natal; o suprascriere mută doar unghiurile și casele. Zodiac tropical și Swiss Ephemeris pe tot parcursul.

Try the Revenirea Lunară API

Grab a key and make your first call in under a minute.

99,9% SLA · planuri plătite · 30 zile status →