AstroWay/api v2.95.1 · es
todos los sistemas funcionando con normalidad
// astrology api · POST /v1/vedic/dashas/vimshottari/maha

API de Mahadasha Vimshottari

Vimshottari es el ciclo de períodos planetarios de 120 años que ancla el cómputo de fechas védico. Este endpoint lee la posición sidérea de la Luna al nacer, localiza el nakshatra que ocupa y, desde ese único punto, despliega la cadena ordenada de Mahadashas —los grandes períodos de vida, cada uno gobernado por uno de los nueve grahas— con las fechas de calendario exactas que los delimitan.

Endpoint
POST /v1/vedic/dashas/vimshottari/maha
Coste
50 créditos
Latencia
~62 ms
Nivel
Tier 3
// 01 / Qué calcula

API de Mahadasha Vimshottari

El endpoint convierte la fecha de nacimiento, la hora del reloj y el desfase UTC a un día juliano, y luego consulta a Swiss Ephemeris la longitud geocéntrica de la Luna y aplica el ayanamsa Lahiri para desplazarla del zodíaco tropical al sidéreo. Esa longitud sidérea fija el nakshatra natal y la fracción ya transcurrida dentro de él, lo que determina cuánto del período del primer planeta regente queda al nacer. A partir de ahí despliega la secuencia completa de Vimshottari de 120 años en orden canónico —Ketu, Venus, Sol, Luna, Marte, Rahu, Júpiter, Saturno, Mercurio—, cada Mahadasha con su lapso asignado y fechas de inicio y fin concretas. La respuesta también devuelve el nakshatra de nacimiento, la longitud sidérea de la Luna y el valor del ayanamsa utilizado, de modo que la línea de tiempo es plenamente auditable.

// 02 / Solicitud en vivo

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
}'
Respuesta (fragmento)
{
  "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 / Parámetros

Parámetros

nametypeObligatorio
date string (YYYY-MM-DD) Birth date.
time string (HH:MM:SS) Local clock time at birth.
timezoneOffset number (hours) UTC offset in effect at the birth moment (e.g. 3 for Kyiv summer time). Decimal allowed for half-hour zones.
latitude number Birth-place latitude, decimal degrees (north positive).
longitude number Birth-place longitude, decimal degrees (east positive).
// 04 / Cuándo usarlo

Cuándo usarlo

Usa este endpoint cuando necesites el esqueleto de dasha de nivel superior —los macroperíodos que enmarcan los capítulos de la vida de una persona— en lugar del detalle a nivel de día. Es la primera llamada natural para una línea de tiempo predictiva: renderiza la secuencia de grandes períodos, destaca cuál está actualmente activo para una fecha dada y deja que los usuarios profundicen desde ahí. Como toda la cadena se deduce de forma determinista a partir de una única posición de la Luna, puedes calcularla una vez al registrarse y almacenarla en caché indefinidamente. Cuando necesites los subperíodos anidados dentro de una Mahadasha dada, deriva a los endpoints dedicados de antardasha, pratyantar, sookshma y prana bajo la misma familia Vimshottari.

// 05 / Notas

Notas

Esta ruta devuelve solo la capa de Mahadasha (gran período). Las subdivisiones más finas —antardasha, pratyantar, sookshma y prana— viven en endpoints separados bajo /v1/vedic/dashas/vimshottari/*. El cálculo sigue la tradición de Parashara tal como está codificada en el Bṛhat Parāśara Horā Śāstra, con el zodíaco sidéreo y el ayanamsa Lahiri como marco de referencia predeterminado.

Prueba la API de Mahadasha Vimshottari

Consigue una clave y haz tu primera llamada en menos de un minuto.

99.9% SLA · planes de pago · 30 días estado →