AstroWay/api v2.201.6 · fr
tous les systèmes sont opérationnels
// astrology api · POST /v1/vedic/dashas/vimshottari/maha

API Vimshottari Mahadasha

Vimshottari, c’est le cycle planétaire de 120 ans qui ancre le timing védique. Ce endpoint lit la position sidérale de la Moon à la naissance, trouve le nakshatra qu’elle occupe, et à partir de ce point unique déroule la chaîne ordonnée des Mahadashas – les grandes périodes de vie, chacune gouvernée par l’un des neuf grahas – avec les dates calendaires exactes qui les encadrent.

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

API Vimshottari Mahadasha

Ce endpoint convertit la date de naissance, l’heure et le décalage UTC en jour julien, puis interroge le Swiss Ephemeris pour obtenir la longitude géocentrique de la Moon et applique le Lahiri ayanamsa pour la passer du tropical au zodiac sidéral. Cette longitude sidérale fixe le nakshatra natal et la fraction déjà écoulée à l’intérieur, ce qui détermine combien il reste de la période du premier planète dirigeante à la naissance. Ensuite il expose la séquence complète de 120 ans de Vimshottari dans l’ordre canonique – Ketu, Venus, Sun, Moon, Mars, Rahu, Jupiter, Saturn, Mercury – chaque Mahadasha affichant sa durée allouée ainsi que ses dates de début et de fin concrètes. La réponse renvoie aussi le nakshatra de naissance, la longitude sidérale de la Moon et la valeur d’ayanamsa utilisée, ainsi la timeline est totalement auditable.

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

Utilise ce endpoint quand tu as besoin du squelette dasha de haut niveau – les périodes macro qui structurent les chapitres de vie d’une personne – plutôt que du détail jour par jour. C’est l’appel naturel en premier pour une timeline prédictive : afficher la séquence des grandes périodes, mettre en avant celle qui est active à une date donnée, et laisser les utilisateurs creuser à partir de là. Comme toute la chaîne découle de façon déterministe d’une position de la Moon, tu peux la calculer une fois à l’inscription et la mettre en cache indéfiniment. Quand tu as besoin des sous-périodes imbriquées dans une Mahadasha donnée, branche-toi aux endpoints dédiés antardasha, pratyantar, sookshma et prana sous la même famille Vimshottari.

// 05 / Notes

Notes

Cette route ne renvoie que la couche Mahadasha (période majeure). Les subdivisions plus fines – antardasha, pratyantar, sookshma et prana – sont disponibles sur des endpoints séparés sous /v1/vedic/dashas/vimshottari/*. Le calcul suit la tradition Parashara telle que codifiée dans le Bṛhat Parāśara Horā Śāstra, avec le zodiac sidéral et le Lahiri ayanamsa comme cadre de référence par défaut.

Try the Vimshottari Mahadasha API

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

99,9% SLA · forfaits payants · 30 j statut →