Astrología védica por API: de Parashara a Lal Kitab en 354 endpoints

La astrología védica es la tradición astrológica ininterrumpida más antigua del mundo. Sus métodos formales (BPHS, los Jaimini Sutras, Lal Kitab, KP) se usan a diario en la India: para emparejamientos matrimoniales, elección de fechas y diagnóstico preventivo del destino. Pero llegar por código a cálculos de calidad era, hasta hace poco, un dolor.

AstroWay v2.19 lo resuelve: 354+ endpoints védicos, contrastados con PyJHora (la implementación de referencia en Python), con las discrepancias documentadas.

Aunque ambos zodíacos se calculan a partir de las mismas posiciones planetarias (vía Swiss Ephemeris), conceptualmente son distintos:

El védico no es una “alternativa” al occidental: es un sistema independiente con su propia estructura lógica. Quienes integran apps multitradición (horóscopo móvil, emparejamiento, horóscopo diario) suelen querer ambos, y usar una sola API en lugar de dos de terceros supone un ahorro serio.

La mayoría de los competidores solo ofrecen Vimshottari (ciclo de 120 años, el más popular). AstroWay cubre:

1. Vimshottari (120 años): el estándar BPHS, transversal
2. Yogini (36 años): predicciones más rápidas, 8 planetas
3. Ashtottari (108 años): tradición Ardradi, recomendación por paksha
4. Kalachakra (signs-as-MD-lords): el sistema más complejo, paramayu varies per chart
5. Chara (Jaimini movable): para predicciones basadas en signos
6. Tribhagi (54 = Vimshottari/2 + extras): accelerated Vimshottari
7. Shatabdika (100 años): varied source-counts
8. Shodashottari (116 años): para paksha-mixed charts
9. Sthira (una rara fixed-period dasha)
10. Shoola (cross-rasi method)

Cada uno admite 5 niveles: Maha → Antar → Pratyantar → Sookshma → Prana.

Las cartas divisionales son vistas recursivas de la misma carta natal a distintas escalas. D9 (Navamsha) es la más importante para el matrimonio. D10 (Dashamsha), para la carrera. D60 (Shashtyamsha) es el nivel más fino.

Una sola llamada a /v1/vedic/vargas devuelve las 16 divisiones a la vez: quien integra no tiene que hacer 16 peticiones separadas.

5 elementos + auxiliares:

• Tithi (día lunar, 30 divisiones del ciclo lunar)
• Karana (medio tithi, 11 tipos)
• Yoga (yoga del día, 27 tipos, basado en la suma de las longitudes del Sol + la Luna)
• Nakshatra (una de las 27 mansiones lunares)
• Choghadia (el día y la noche se dividen en 8 bloques de auspiciosidad cada uno, de hora y media aproximadamente)
• Hora (hora planetaria)
• Rahu-kaal (una ventana inauspiciosa de 1,5 horas cada día)

Con /v1/vedic/panchang/full obtienes los 8 elementos en un solo JSON para una fecha y un lugar concretos.

En el védico, un yoga es una combinación planetaria especial que forma un patrón de vida visible. Parashara (BPHS) describe cientos; AstroWay implementa los más citados:

• Raja: combinaciones de poder y reconocimiento
• Dhana: riqueza
• Dharma-Karmadhipati: el camino profesional
• Pancha Mahapurusha: Ruchaka/Bhadra/Hamsa/Malavya/Shasha (5 planetas en casas kendra en su propio signo)
• Gajakesari: la Luna + Júpiter en kendra
• Adhi: Mercurio/Venus/Júpiter en la 6/7/8 desde la Luna

Además, los específicos de Jaimini: karaka-yoga (8 chara karakas en casas significativas), karakamsa (proyección de 12 casas con el AK en D9), shubha-graha (functional benefic per BPHS Adhyaya 34).

Un dosha es una aflicción planetaria que complica un área concreta de la vida. AstroWay cubre tres escuelas:

• Parashara: Mangal Dosha (Marte), Kaal Sarp (planetas entre Rahu y Ketu), Pitru (karma ancestral), Shrapit, Grahan, Guru-Chandal
• Lal Kitab: Manglik (la interpretación propia de Lal Kitab), más otros doshas exclusivos de esta escuela
• KP (Krishnamurti Paddhati): diagnóstico basado en sub-lords

Si tu servicio de emparejamiento atiende a clientes de distintas regiones de la India (en Punjab se usa a menudo LK, en Tamil Nadu KP, en todas partes Parashara), una sola API sustituye a tres.

El proceso clásico indio de emparejamiento:

1. Ashtakoot (Guna Milan): escala de 8 factores, 36 puntos como máximo. Menos de 18 = compatibilidad baja. El más popular en el norte y el centro de la India.
2. Dashakoota: de 10 factores, variante del sur de la India.
3. Manglik check: crítico para cartas natales con Marte afligido.
4. Mangal match: compensa Marte con Marte.
5. Bhrigu match: superposición predictiva a partir de la Bhrigu Samhita.

Todo a través de /v1/vedic/compatibility/full: una llamada, un informe completo de compatibilidad.

“Muhurta” es un momento auspicioso para iniciar un acontecimiento. Eventos clásicos:

• Marriage muhurta (boda)
• Vehicle purchase (coche)
• Business start (apertura de un negocio)
• Travel (viajes)
• Naming ceremony (Namakaran: dar nombre al bebé)
• Cirugía, inicio de estudios, inversión, compra de propiedad, griha-pravesh (estreno de casa), compromiso, pleitos judiciales

/v1/vedic/muhurat/{event} devuelve las 3 mejores fechas auspiciosas dentro del rango indicado.

Lahiri es el valor por defecto (Chitra Paksha, el estándar oficial del gobierno indio). Con el parámetro ayanamsa puedes cambiarlo:

• raman: tradición de B.V. Raman (popular en KP)
• krishnamurti: específico de KP
• yukteshwar: Sri Yukteshwar (distancia desde Spica)
• fagan-bradley: Fagan/Bradley (sideral occidental)
• de-luce: De Luce
• jn-bhasin: JN Bhasin

Cada uno aplica un desplazamiento distinto (normalmente de 23,5 a 24,0°). Para un mismo cliente, las posiciones de los planetas en los signos pueden variar: conviene saberlo ya en la fase de arquitectura de tu app.

Cada endpoint tiene:

• Status (GREEN/YELLOW) en docs/AUDIT-TRAIL.md
• Un encabezado AUDIT en el código fuente con las fuentes (BPHS Adhyaya N, Jaimini Sutras X.Y, función de referencia de PyJHora)
• Un fixture de snapshot test contra regresiones

Las discrepancias con PyJHora (cuando existen, casi siempre en métodos de un solo autor como Lal Kitab) están documentadas en AUDIT-TRAIL: quien integra ve el delta exacto antes de integrar.

# Natal Vedic chart
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-07-14",
    "time": "14:30:00",
    "timezoneOffset": 3,
    "latitude": 50.4501,
    "longitude": 30.5234
  }'

Devuelve el señor de la Maha-dasha actual, la fecha de fin de la MD y la secuencia de las dashas siguientes. Con /maha → /antar → /pratyantar → … puedes bajar hasta el 5.º nivel.

Los informes védicos (PDF) están disponibles en 20 idiomas, incluidos hi, ko, ja, id, tr, vi: mercados con demanda real de contenido védico. Pasa lang=<code> a cualquier endpoint /v1/reports/*. Detalles en /languages/.

Los endpoints védicos cuestan 10, 20 o 50 créditos según lo que calculan: Lal Kitab y KP, 10; vargas y elementos del panchang, 20; doshas de Parashara, dashas, shadbala y muhurta, 50. En el plan gratuito (10 000 créditos) eso son entre 200 y 1000 llamadas védicas al mes. Los informes PDF Vedic Kundli / Lal Kitab cuestan 5000.

• Categorías de endpoints védicos: navegación por 8 grupos
• Vedic API marketing: visión completa con ejemplos de código en 4 lenguajes
• Inicio rápido: la primera petición en 5 minutos
• Precios: del plan gratuito a Enterprise