AstroWay/api v2.202.3 · nl
alle systemen normaal
// astrology api · POST /v1/vedic/dashas/vimshottari/maha

Vimshottari Mahadasha API

Vimshottari is de 120-jaar planetair-periode cyclus die de Vedische tijdbepaling verankert. Deze endpoint leest de siderische positie van de Moon bij geboorte, bepaalt de nakshatra die hij bezet, en rolt vanaf dat ene punt de geordende keten van Mahadashas uit – de grote levensperioden, elk bestuurd door een van de negen graha’s – met de exacte kalenderdatums die ze begrenzen.

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

Vimshottari Mahadasha API

De endpoint zet de geboortedatum, kloktijd en UTC-offset om naar een Julian-dag, vraagt vervolgens de Swiss Ephemeris op voor de geocentrische lengtegraad van de Moon en past de Lahiri ayanamsa toe om deze van het tropische naar het siderische zodiac te verschuiven. Die siderische lengtegraad bepaalt de natal nakshatra en het al verstreken deel ervan, wat aangeeft hoeveel van de periode van de eerste heersende planeet nog overblijft bij geboorte. Vervolgens toont het de volledige 120-jaar Vimshottari-reeks in canonieke volgorde – Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury – waarbij elke Mahadasha zijn toegewezen duur en concrete start- en einddatums heeft. Het antwoord geeft ook de geboorte-nakshatra, de siderische lengtegraad van de Moon en de gebruikte ayanamsa-waarde terug, zodat de tijdlijn volledig controleerbaar is.

// 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

Gebruik deze endpoint wanneer je de top-level dasha-skelet nodig hebt – de macro-perioden die de levenshoofdstukken van een persoon kaderen – in plaats van de dag-level details. Het is de natuurlijke eerste oproep voor een voorspellende tijdlijn: render de reeks van grote perioden, markeer welke momenteel actief is voor een gegeven datum, en laat gebruikers van daaruit verder inzoomen. Omdat de hele keten deterministisch volgt uit één Moon-positie, kun je het één keer bij aanmelding berekenen en onbeperkt cachen. Wanneer je de geneste sub-perioden binnen een bepaalde Mahadasha nodig hebt, ga je naar de speciale antardasha, pratyantar, sookshma en prana endpoints onder dezelfde Vimshottari-familie.

// 05 / Notes

Notes

Deze route geeft alleen de Mahadasha-laag (grote-periode) terug. De fijnere onderverdelingen – antardasha, pratyantar, sookshma en prana – bevinden zich op aparte endpoints onder /v1/vedic/dashas/vimshottari/*. De berekening volgt de Parashara-traditie zoals gecodificeerd in de Bṛhat Parāśara Horā Śāstra, met het siderische zodiac en de Lahiri ayanamsa als standaard referentiekader.

Try the Vimshottari Mahadasha API

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

99.9% SLA · betaalde plannen · 30d status →