curl -X POST https://api.occultapi.com/api/astro/ashtakvarga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["samudhaya_ashtaka_varga"],"latitude":26.1046,"longitude":74.319,"timezone_as_float":5.5,"chart_name":"RashiChart","date_time":"2026-09-01T06:00:00+05:30"}'El ashtakavarga puntúa cada signo de una carta sobre ocho. Siete planetas y un octavo elemento emiten cada uno su voto sobre los doce signos: un signo que reúne muchos puntos favorece los asuntos que rige, y uno que reúne pocos, no. Es el método védico habitual para decidir qué casas y qué tránsitos merece la pena aprovechar sin tener que interpretar la carta por tu cuenta. Todas las claves devuelven números, no texto. Un uso típico: `samudhaya_ashtaka_varga` para ordenar rápidamente los doce signos por fortaleza y, después, `binna_ashtaka_varga` para el planeta que te interese; por ejemplo, la puntuación de Júpiter en el signo por el que transita ahora. Sobre la octava fila: las tablas indexadas por signo la rotulan `Rahu`, mientras que las indexadas por casa (`trikona_sodhana_house`, `ekadhipatya_sodhana_house`) rotulan esa misma fila `Ascendant`. En la tradición clásica, este octavo elemento es el ascendente. Si lees ambas, guíate por la posición y no por el nombre. Las tablas se construyen a partir de la carta divisional indicada en `chart_name`, normalmente RashiChart. Dos campos de la solicitud cambian la aritmética: `apply_ekadhipatya_reductions` y `use_eight_ashtakavargas_in_sav`. Las fuentes clásicas no se ponen de acuerdo en ninguno de los dos, así que los decides tú.
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| chart_name | string | obligatorio | BhavaChartRashiChartHoraChartJagannathHoraChartParivrittidwayaHoraChartParivrittitrayaDrekkanaChartDrekkanaChartSomnathDrekkanaChartJagannathDrekkanaChartChaturthamsaChartPanchamsaChartShashthamsaChartEn esta vista no hay una lista explícita (a diferencia de /api/astro/chart/), y por eso esto es 'likely' y no 'certain'. Distingue mayúsculas y minúsculas; un nombre desconocido devuelve "Item '<x>' is not supported". En la práctica, el Ashtakvarga está pensado para ejecutarse sobre 'RashiChart'. |
| date_time | string (date-time) | obligatorio | El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC, y puede devolver con un 200 el resultado del día anterior. '2026-09-01T06:00:00Z' y '2026-09-01 06:00:00' son instantes distintos y dan respuestas distintas. Restricción de FORMATO, no un enum. DRF DateTimeField: solo ISO-8601 (formatos de entrada por defecto de DRF), p. ej., "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" o "2026-09-01 06:00:00" (sin zona horaria = se toma como UTC). |
| keys | array | obligatorio | Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas. binna_ashtaka_vargasamudhaya_ashtaka_vargaprastara_ashtaka_vargatrikona_sodhana_rashitrikona_sodhana_houseekadhipatya_sodhana_rashia_ashtaka_vargaekadhipatya_sodhana_housepindas |
| timezone_as_float | number (double) | obligatorio | Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. min -12 · max 14 |
| apply_ekadhipatya_reductions | boolean | opcional | |
| latitude | number (double) | opcional | Latitud del lugar, en grados decimales. Los valores positivos indican el norte y los negativos, el sur. Ejemplo: 26.9124 para Jaipur, 40.7128 para Nueva York. No se aceptan minutos ni segundos: conviértelos antes. min -89.9 · max 89.9 |
| longitude | number (double) | opcional | Longitud del lugar, en grados decimales. Los valores positivos indican el este y los negativos, el oeste. Ejemplo: 75.7873 para Jaipur, -74.0060 para Nueva York. Cuidado con el signo: si falta el menos, Nueva York acaba en China. min -180 · max 180 |
| use_eight_ashtakavargas_in_sav | boolean | opcional |
Indica en keys exactamente los cálculos que quieres. Si una clave no existe, se rechaza toda la solicitud. Pidas las que pidas, se cobra 1 crédito, así que agrúpalas en una sola llamada.
| Clave | Campos adicionales | Descripción | |
|---|---|---|---|
| binna_ashtaka_varga | — | Bhinnashtakavarga: una fila por contribuyente, cada una con doce números en la escala 0-8. Las filas son Sun, Moon, Mars, Mercury, Jupiter, Venus, Saturn y una octava rotulada `Rahu`; los doce valores van de Aries a Piscis. Un 3 en la fila `Sun` significa que el varga del Sol da 3 puntos a Aries. Es la tabla de la que parten la mayoría de las lecturas. | |
| ekadhipatya_sodhana_house | — | La misma tabla totalmente reducida, pero rotada para que el primer valor sea el signo del ascendente y no Aries. Tiene los mismos números que `ekadhipatya_sodhana_rashia_ashtaka_varga`, indexados por casa. Aquí la octava fila se llama `Ascendant`; en la tabla indexada por signo, `Rahu`. | |
| ekadhipatya_sodhana_rashia_ashtaka_varga | — | Bhinnashtakavarga tras las dos reducciones: primero trikona y luego ekadhipatya, que cancela puntos entre los dos signos que rige un mismo planeta. Tabla indexada por planeta, con doce valores de Aries a Piscis. A partir de ella se calculan los pindas. | |
| pindas | — | Las tres ponderaciones finales, con siete números cada una: uno por planeta, del Sol a Saturno, sin octava fila. `raasi_pindas` pondera los puntos reducidos según el signo; `graha_pindas`, según la posición de los propios planetas, y `sodhya_pindas` es la suma de las dos. El sodhya pinda es la cifra con la que los textos clásicos juzgan la fortaleza global de un planeta, y la que te conviene si quieres un solo número. | |
| prastara_ashtaka_varga | — | El cálculo detallado del bhinnashtakavarga: para cada planeta, qué contribuyente de los ocho otorgó cada punto. Tiene dos niveles de anidamiento: planeta, luego contribuyente y, dentro, doce valores. Es más grande que las otras tablas y solo hace falta si quieres mostrar cómo se llega al resultado, no solo el resultado. | |
| samudhaya_ashtaka_varga | — | Sarvashtakavarga: los totales, un número por signo, con las claves de `Raasi 1` a `Raasi 12` (de Aries a Piscis). Cada uno es la suma de los puntos de todos los planetas en ese signo, así que en el esquema clásico los doce suman 337. Úsalo para ordenar los signos por fortaleza en una sola llamada. | |
| trikona_sodhana_house | — | La misma tabla con la reducción trikona, pero rotada para que el primer valor sea el signo del ascendente y no Aries: tiene los mismos números que `trikona_sodhana_rashi`, indexados por casa. Úsala para mostrar las casas de la 1 a la 12. Aquí la octava fila se llama `Ascendant`, y esa misma fila se llama `Rahu` en la tabla indexada por signo. | |
| trikona_sodhana_rashi | — | Bhinnashtakavarga tras la reducción trikona (trinal), la primera de las dos reducciones clásicas que se aplican antes de calcular los pindas. Tabla indexada por planeta, con doce valores de Aries a Piscis. |