Vedic FAQ
Hemos reunido las preguntas que surgen a menudo al integrar los endpoints védicos. Si no encuentras la respuesta, escribe a hello@astroway.info y la añadimos.
¿Qué ayanamsas se soportan? ¿Cuál elegir?
Sección titulada «¿Qué ayanamsas se soportan? ¿Cuál elegir?»La API soporta 9 ayanamsas:
| Código | Nombre | Cuándo elegirla |
|---|---|---|
lahiri (default) | Chitra Paksha | Estándar del gobierno indio; el mayor mercado masivo. Para la mayoría de las apps védicas, es esta. |
raman | B.V. Raman | Si integras una app móvil para el mercado del sur de la India (Karnataka, Tamil Nadu). |
krishnamurti (alias kp) | KP | Si llamas a /v1/vedic/kp/*: KP tiene su propia ayanamsa. |
yukteshwar | Sri Yukteshwar | Distancia desde Spica; audiencias teosóficas o de orientación occidental. |
fagan-bradley | Fagan/Bradley | Sideral occidental (no védica). Para astrólogos que vienen de tradiciones siderales occidentales. |
de-luce | De Luce | Una elección antigua entre astrólogos, poco común. |
jn-bhasin | JN Bhasin | Escuela específica, poco común. |
true-citra | True Chitra Paksha | Spica fijada exactamente en 0° de Libra. Se separa de Lahiri en 0.01°, así que elígela solo si necesitas precisamente el anclaje estelar. |
djwhal-khul | Djwhal Khul | Escuela teosófica, poco común. La mayor desviación de la tabla. |
Las escuelas principales difieren poco: Lahiri, True Chitra y KP se mantienen dentro de 0.1°; Fagan/Bradley, JN Bhasin, Yukteshwar y Raman, hasta 1.45°. Aparte quedan De Luce (3.96° respecto a Lahiri) y Djwhal Khul (3.82°), y con ellas una posición cerca del límite de un signo ya pasa al signo vecino. Medido el 2026-08-18 con la Luna de una misma carta; en técnicas basadas en grados (posición en el Nakshatra, Argala) la diferencia se nota incluso dentro de 0.1°.
¿Sidereal o tropical? ¿Qué devuelve la API?
Sección titulada «¿Sidereal o tropical? ¿Qué devuelve la API?»Por defecto, los endpoints védicos devuelven posiciones siderales (el zodíaco se ancla a las estrellas, con la ayanamsa aplicada). Los endpoints occidentales (/v1/chart, /v1/synastry) devuelven posiciones tropicales (el zodíaco se ancla al punto equinoccial).
La API no ofrece védico tropical (un caso límite poco común que proponen Sanjay Rath y Ernst Wilhelm): todos los endpoints védicos calculan en sideral e ignoran zodiacType en el cuerpo de la petición. Las posiciones tropicales las da la rama occidental (/v1/chart, /v1/synastry), y zodiacType: "sidereal" la cambia al zodíaco sideral con la misma ayanamsa.
¿Qué escuela se usa en cada caso?
Sección titulada «¿Qué escuela se usa en cada caso?»| Escuela | Región / audiencia | Punto fuerte |
|---|---|---|
| Parashara (BPHS) | Todo el mundo védico: la base universal | El corpus de técnicas más completo; empieza siempre por aquí |
| Jaimini | Tamil Nadu + practicantes avanzados | Predicciones basadas en karakas; temas vitales guiados por el AK |
| Lal Kitab | Punjab + norte de la India | Remedios únicos (upaya), Manglik específico |
| KP (Krishnamurti) | Tamil Nadu + Andhra Pradesh | Sub-lord theory, precisión en la datación de eventos |
Pratyangira, AstroSage y otras API grandes ofrecen sobre todo Parashara. AstroWay cubre las cuatro mediante grupos de endpoints separados.
¿Ashtakoot o Dashakoota? ¿Para qué mercado?
Sección titulada «¿Ashtakoot o Dashakoota? ¿Para qué mercado?»| Ashtakoot | Dashakoota | |
|---|---|---|
| Región | Norte y centro de la India, Pakistán, Nepal | Sur de la India (Tamil Nadu, Karnataka, Kerala) |
| Escala | 36 puntos máx. | 10 kutas (factores) |
| Componentes | Varna + Vashya + Tara + Yoni + Graha Maitri + Gana + Bhakoot + Nadi | Dina + Gana + Mahendra + Stri-Dirgha + Yoni + Rashi + Rashi-adhipati + Vashya + Rajju + Vedha |
| API | /v1/vedic/compatibility/ashtakoot | /v1/vedic/compatibility/dashakoota |
Si tu servicio de emparejamiento atiende a toda la India, llama a /v1/vedic/compatibility/full: obtienes ambos + Manglik + Bhrigu.
Mangal Dosha: ¿por qué importa?
Sección titulada «Mangal Dosha: ¿por qué importa?»Mangal Dosha = Marte en la casa 1/2/4/7/8/12 desde el Lagna, la Luna o Venus (cada escuela lo interpreta a su manera). En la India es un factor que puede frenar un matrimonio: si ambos miembros de la pareja tienen aflicción de Mangal sin compensación, un astrólogo tradicional no dará luz verde sin upayas (remedios) o factores compensatorios.
Endpoint de la API: /v1/vedic/compatibility/manglik-check, devuelve { chart1: { manglik: true/false, severity, factors }, chart2: ..., compensation: ... }.
D9 (Navamsha): ¿por qué es la varga más importante?
Sección titulada «D9 (Navamsha): ¿por qué es la varga más importante?»D9 = división de cada signo en 9 partes = una carta detallada a “nivel del alma”. En el védico se usa para:
- Predicciones de matrimonio: Venus + el señor de la 7.ª en D9 muestran la verdadera naturaleza de la vida conyugal
- Fuerza de los planetas: un planeta fuerte en D1 pero débil en D9 = “promete pero no cumple”
- Vargottama: un planeta en el mismo signo en D1 y D9 = fuerza especial
API: /v1/vedic/vargas devuelve las 16 divisiones en una sola llamada; céntrate en D9 para funciones relacionadas con matrimonio y relaciones.
¿Por qué es crítica la hora de nacimiento? ¿Qué hacer si no se conoce?
Sección titulada «¿Por qué es crítica la hora de nacimiento? ¿Qué hacer si no se conoce?»El védico es muy sensible a la hora:
- El Lagna (Ascendente) cambia cada ~2 horas: se desplaza TODA la carta
- El Nakshatra de la Luna cambia cada 6–8 horas
- El Dasha-balance (periodo inicial) depende de la posición de la Luna en el nakshatra
Si no se conoce la hora exacta:
- Carta del amanecer: usa la hora de salida del Sol en el lugar de nacimiento como aproximación. El Sol queda entonces sobre el Ascendente, así que el Lagna coincide aproximadamente con el signo solar; algunos astrólogos védicos consideran válidas las cartas del amanecer para una previsión de tendencias generales
- Rectificación: llama a
/v1/rectificationcon 2-3 acontecimientos conocidos (boda, hijo, cambio de trabajo); la API devuelve la ventana probable de la hora de nacimiento - Aviso al usuario: indica que los resultados con hora desconocida son una aproximación, no una carta exacta
¿Qué sistemas de casas se usan?
Sección titulada «¿Qué sistemas de casas se usan?»El védico usa tradicionalmente casas Whole Sign (todo el signo = una casa). El occidental: Placidus / Koch / Equal, etc.
El valor por defecto de AstroWay para el védico es Whole Sign. Para los endpoints KP, Placidus (la convención de KP). Pasa el parámetro houseSystem si necesitas otro: whole-sign, placidus, koch, equal, porphyry.
¿Se puede combinar védico + occidental en una misma app?
Sección titulada «¿Se puede combinar védico + occidental en una misma app?»Sí, e incluso es lo recomendado para audiencias multitradición. Arquitectura:
- La carta natal se calcula una sola vez: los endpoints occidentales y védicos comparten la misma entrada (date/time/lat/lon)
- Muestra un selector “Western view” / “Vedic view” en tu UI
- El signo lunar védico (rashi) se confunde a menudo con el signo solar occidental: avisa al usuario de la diferencia
- Compatibilidad: puedes mostrar AMBAS a la vez: la sinastría occidental + el Ashtakoot védico
El endpoint /v1/compat/astro-vedic lo hace automáticamente: un puente entre la sinastría occidental × el Ashtakoot védico.
¿Qué efemérides se usan? ¿Con qué precisión?
Sección titulada «¿Qué efemérides se usan? ¿Con qué precisión?»Swiss Ephemeris (LGPL), las mismas que usan Solar Fire, Kepler, Astro Gold, Janus y AstroSeek. Precisión:
- Posiciones planetarias: ±1 segundo de arco frente a las efemérides NASA JPL
- Cúspides de las casas: ±1 minuto de arco
- Ayanamsa: tabla Lahiri contrastada con las tablas oficiales del gobierno indio
Para los cálculos propios del védico (posición en el Nakshatra, balance de Vimshottari, vargas) hay contraste con PyJHora (la referencia de facto en Python); las discrepancias, donde las hay, son < 0.01°. El informe de discrepancias está en docs/AUDIT-TRAIL.md del repo.
¿Puedo cachear los resultados? ¿Cómo?
Sección titulada «¿Puedo cachear los resultados? ¿Cómo?»Sí: la mayoría de los endpoints védicos son deterministas para una misma entrada de carta. Clave de caché estable: hash(date + time + lat + lon + ayanamsa + endpoint).
La API también ofrece la cabecera X-Idempotency-Key: una caché de 5 minutos del lado de api-calc. En un cache hit no se descuentan créditos.
¿Cómo se localizan los textos de las respuestas?
Sección titulada «¿Cómo se localizan los textos de las respuestas?»Los endpoints védicos que devuelven interpretaciones (descripciones de yogas, significados de doshas, motivos de muhurat) aceptan el parámetro lang. Soporte: 20 idiomas (T0: uk/en/de/ru a mano; T1: pl/es/pt/hi/fr/ko AI Beta; T2/T3: planificados). Detalles: /languages/.
Si el endpoint devuelve datos numéricos (grados, fechas, índices de signos), son neutros respecto al idioma. Los campos de texto (note, meaning, manifestation) están localizados.
¿Qué hacer con el estado YELLOW?
Sección titulada «¿Qué hacer con el estado YELLOW?»YELLOW = el endpoint funciona, pero tiene una de estas tres características:
- Escuela de un solo autor (Lal Kitab, KP): no hay verificación cruzada con otras escuelas porque no existen
- Basado en puntuación o heurística (compatibilidad 0-100, momento de ruptura): la valoración numérica es subjetiva por naturaleza
- Límite intrínseco de precisión (rectificación, Bhrigu match): el algoritmo tiene un suelo de precisión inherente
Consulta docs/AUDIT-TRAIL.md para el endpoint concreto: ahí se explica por qué es YELLOW y si hay camino hacia GREEN. Para la mayoría no lo hay (es intrínseco), y es un aviso honesto para quien integra.