AstroWay/api v2.201.6 · it
tutti i sistemi sono operativi
// astrology api · POST /v1/vedic/dashas/vimshottari/maha

API Vimshottari Mahadasha

Vimshottari è il ciclo di 120 anni dei periodi planetari che fonda il timing vedico. Questo endpoint legge la posizione sidereale della Luna alla nascita, individua il nakshatra che occupa e da quel punto srotola la catena ordinata delle Mahadasha - i principali periodi di vita, ciascuno governato da uno dei nove graha - con le esatte date calendaristiche che li delimitano.

Endpoint
POST /v1/vedic/dashas/vimshottari/maha
Cost
50 credits
Latency
~62 ms
Tier
Tier 3
// 01 / What it computes

API Vimshottari Mahadasha

L'endpoint converte la data di nascita, l'orologio e l'offset UTC in un giorno giuliano, interroga l'Ephemeris Svizzera per la longitudine geocentrica della Luna e applica l'ayanamsa di Lahiri per spostarla dal tropiclo allo zodiaco sidereo. Quella longitudine siderea fissa il nakshatra natale e la frazione già trascorsa al suo interno, che determina quanto del periodo del primo pianeta regnante rimane alla nascita. Da lì espone l'intera sequenza Vimshottari di 120 anni in ordine canonico - Ketu, Venere, Sole, Luna, Marte, Rahu, Giove, Saturno, Mercurio - ciascuna Mahadasha portando la sua assegnata durata e concrete date di inizio e fine. La risposta restituisce anche il nakshatra di nascita, la longitudine siderea della Luna e il valore ayanamsa usato, così la timeline è completamente verificabile.

// 02 / Live request

POST/v1/vedic/dashas/vimshottari/maha

curl -X POST https://api.astroway.info/v1/vedic/dashas/vimshottari/maha \
  -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
}'
Response (excerpt)
{
  "ok": true,
  "data": {
    "system": "vimshottari",
    "level": "maha",
    "ayanamsa": 23.85,
    "moonSiderealLongitude": 258.97,
    "nakshatra": "Purva Ashadha",
    "periods": [
      {
        "lord": "Venus",
        "start": "1986-02-11",
        "end": "2006-02-11"
      },
      {
        "lord": "Sun",
        "start": "2006-02-11",
        "end": "2012-02-11"
      }
    ]
  }
}
// 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).
// 04 / When to use it

When to use it

Usa questo endpoint quando hai bisogno della struttura di base delle dasha - i macro periodi che inquadrano i capitoli della vita di una persona - piuttosto che i dettagli a livello giornaliero. È la chiamata naturale per una timeline predittiva: visualizza la sequenza dei periodi principali, evidenzia quale è attivo per una data specifica e lascia che gli utenti approfondiscano da lì. Poiché l'intera catena segue deterministicamente da una posizione della Luna, puoi calcolarla una sola volta alla registrazione e memorizzarla indefinitivamente. Quando hai bisogno dei sottoperiodi annidati all'interno di una data Mahadasha, ramifica verso gli endpoint dedicati antardasha, pratyantar, sookshma e prana sotto la stessa famiglia Vimshottari.

// 05 / Notes

Notes

Questa rotta restituisce solo il livello Mahadasha (periodo principale). Le suddivisioni più fini - antardasha, pratyantar, sookshma e prana - risiedono in endpoint separati sotto /v1/vedic/dashas/vimshottari/*. Il calcolo segue la tradizione Parashara come codificata nel Bṛhat Parāśara Horā Śāstra, con lo zodiaco sidereo e l'ayanamsa di Lahiri come sistema di riferimento predefinito.

Try the Vimshottari Mahadasha API

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

99.9% SLA · piani a pagamento · 30d stato →