POSThttps://api.occultapi.com/api/astro/strength/

Shadbala y fortaleza planetaria

Cuerpo de la solicitudJSON

Pega una clave de API arriba para enviarla.

Fragmento de código

curl -X POST https://api.occultapi.com/api/astro/strength/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["harsha_bala"],"date_time":"2025-03-27T11:11:24.366Z","latitude":26.9124,"longitude":75.7873,"timezone":5.5,"asc_house":2}'

El Shadbala, las «seis fortalezas», es la forma clásica de cuantificar cuánto puede dar realmente un planeta. Se puntúan por separado seis fuentes (posición, tiempo, dirección, movimiento, rango natural y aspectos recibidos) y se suman. El total se expresa en virupas, y sesenta virupas forman un rupa; cada planeta tiene un mínimo en rupas que debería superar, y la proporción entre lo que obtiene y lo que necesita es el dato que de verdad sirve. Este endpoint ofrece ese total, cada uno de sus componentes y subcomponentes, y varios esquemas de fortaleza relacionados. Empieza por `shad_bala`. Devuelve un array de nueve elementos: las seis listas de componentes, luego los totales en virupas, esos mismos totales en rupas y, por último, los rupas de cada planeta divididos por su mínimo (Sol 5, Luna 6, Marte 5, Mercurio 7, Júpiter 6.5, Venus 5.5, Saturno 5). Una proporción superior a 1 significa que el planeta alcanzó su mínimo. Todas las listas de siete elementos de este endpoint siguen el orden Sol, Luna, Marte, Mercurio, Júpiter, Venus, Saturno; todas las de doce elementos van de la casa uno a la doce. Envía `date_time`, `latitude`, `longitude` y `timezone`. Ten en cuenta que aquí el campo es `timezone`, no `timezone_as_float` como en la mayoría de los endpoints. `asc_house` es obligatorio, pero solo lo usan las tres claves de clasificación de casas, y `planet_index`, `include_houses` y `use_epoch_table` solo las claves que los mencionan. Además del Shadbala, el endpoint incluye las fortalezas quíntuple y duodécuple de Tajaka, la puntuación benéfica Ishta Phala, las medidas de rayos Rashmi y el Harsha Bala. El Bhava Bala, la fortaleza de las casas y no de los planetas, figura en la lista de claves, pero sus tres componentes son funciones sin implementar que devuelven ceros, así que `bhava_bala` también devuelve ceros.

Campos de la solicitud

Campo	Tipo	Obligatorio	Notas
asc_house	integer	obligatorio
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.
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.
latitude	number (double)	obligatorio	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 -90 · max 90
longitude	number (double)	obligatorio	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
timezone	number (double)	obligatorio	Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30). Significa exactamente lo mismo que timezone_as_float; otros endpoints simplemente le dan ese otro nombre. min -12 · max 14
include_houses	boolean	opcional
planet_index	integer	opcional
use_epoch_table	boolean	opcional

Claves disponibles (50)

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
abda_bala	—	Fortaleza del señor del año: el planeta que rige el año recibe 15 virupas y el resto, cero. Devuelve siete valores, del Sol a Saturno, con exactamente una entrada de 15. Ten en cuenta que esta implementación elige el señor a partir del día de la semana de `date_time`; `abdadhipathi` calcula el señor del año de la forma clásica, a partir de los días transcurridos, y es preferible.
abdadhipathi	—	El señor del año, calculado de la forma clásica a partir del ahargana (el número de días transcurridos desde una época base) y no a partir del día de la semana. El planeta regente recibe 15 virupas y el resto, cero. Devuelve siete valores, del Sol a Saturno, con exactamente una entrada de 15. Es preferible a `abda_bala`.
apoklimas	asc_house	Las cuatro casas cadentes (la 3.ª, la 6.ª, la 9.ª y la 12.ª) contadas desde la casa del ascendente que pasas como `asc_house`. Devuelve cuatro enteros, `(asc_house + n - 1) mod 12` para n igual a 3, 6, 9 y 12, con base cero como `panapharas`. Se considera que los planetas situados en ellas son los más débiles por posición, y por eso Kendra Bala les da la puntuación más baja.
ayana_bala	—	Fortaleza por declinación, según la distancia de cada planeta al norte o al sur del ecuador celeste: la declinación más 24, multiplicada por 1.25, con el resultado del Sol duplicado. Devuelve siete números en virupas, del Sol a Saturno.
bhava_adhipathi_bala	—	El componente del señor de la casa en Bhava Bala: lo que aporta a una casa la fortaleza de su propio señor. Devuelve doce números, de la casa uno a la doce. Actualmente es un marcador de posición sin implementar que devuelve ceros.
bhava_bala	—	Bhava Bala, la fortaleza de las casas y no de los planetas, formada por Bhava Adhipathi, Bhava Dig y Bhava Drik Bala. Devuelve un array de tres elementos (doce valores en virupas, los mismos en rupas y cada uno dividido por el mínimo de 5 rupas), de la casa uno a la doce. Sus tres componentes son marcadores de posición sin implementar en el motor actual, así que por ahora todas las cifras son cero.
bhava_dig_bala	—	El componente direccional de Bhava Bala: la fortaleza que una casa obtiene cuando el tipo de asuntos que rige coincide con la dirección que ocupa. Devuelve doce números, de la casa uno a la doce. Actualmente es un marcador de posición sin implementar que devuelve ceros.
bhava_drik_bala	—	El componente de aspectos de Bhava Bala: el saldo de los aspectos benéficos y maléficos que recaen sobre cada casa. Devuelve doce números, de la casa uno a la doce. Actualmente es un marcador de posición sin implementar que devuelve ceros.
bhava_madhya	—	Los doce bhava madhyas, los puntos medios de las casas, calculados a partir de las cúspides Placidus en longitud sideral. Devuelve doce números en grados de 0 a 360, empezando por la casa uno. Dig Bala los usa internamente, y son útiles por sí solos si quieres los puntos medios de las casas en lugar de las cúspides.
cheshta_bala	—	Fortaleza por movimiento, el cuarto de los seis componentes: la diferencia entre el seeghrocha de un planeta y la media de sus longitudes verdadera y media, dividida por tres. Es alta cuando el planeta va lento, está estacionario o retrógrado, y baja cuando avanza deprisa. Devuelve siete números en virupas; el Sol y la Luna son siempre 0, ya que nunca están retrógrados.
cheshta_bala_new	use_epoch_table	Una segunda implementación de la fortaleza por movimiento, que calcula las longitudes medias desde la época Ujjain 1900 en lugar de a partir de las efemérides. Pasa `use_epoch_table` como true para leer las tablas clásicas de movimiento medio, o como false para usar una tasa lineal desde la misma época. Devuelve siete números en virupas, con el Sol y la Luna siempre en 0. Úsalo para compararlo con `cheshta_bala`; las dos implementaciones no coinciden exactamente, y es intencionado.
cheshta_rashmi	—	Cheshta Rashmi, los rayos que un planeta emite en virtud de su movimiento, derivados de Cheshta Bala y reducidos al intervalo 0–180 antes de convertirlos en rayos. Devuelve siete números, del Sol a Saturno. Está marcado como experimental en el código fuente y no conviene fiarse de él.
dig_bala	—	Fortaleza direccional, el tercero de los seis componentes: a qué distancia está cada planeta del punto medio de la casa en la que se considera que no tiene poder (la cuarta para el Sol y Marte, la décima para la Luna y Venus, la séptima para Mercurio y Júpiter, la primera para Saturno), con la separación dividida por tres. Devuelve siete números en virupas, del Sol a Saturno, redondeados a dos decimales.
drekkana_bala	—	Fortaleza de drekkana para el conjunto quíntuple: 10 virupas para un planeta en su signo propio en la carta D3, 5 en el de un amigo y 2.5 en el de un enemigo. Devuelve siete números, del Sol a Saturno. `drekkana_bala_simple` es la misma regla con la posición en D3 derivada directamente de la longitud.
drekkana_bala_simple	—	Fortaleza de drekkana con la posición en D3 calculada directamente a partir de la longitud (la longitud por tres) en lugar de a partir de una carta D3 construida: 10 virupas en su signo propio, 5 en el de un amigo y 2.5 en el de un enemigo. Devuelve siete números, del Sol a Saturno. Es la variante que usa `pancha_vargeeya_bala`.
dreshkon_bala	—	Fortaleza de drekkana: 15 virupas para un planeta masculino (Sol, Marte, Júpiter) en el primer tercio de su signo, para Mercurio o Saturno en el tercio central y para la Luna o Venus en el último tercio; 0 en los demás casos. Devuelve siete valores de 0 o 15, del Sol a Saturno.
drik_bala	—	Fortaleza por aspectos: los aspectos de cada planeta sobre cada uno de los demás se puntúan según el ángulo entre ellos, los aspectos benéficos se suman y los maléficos se restan, y el saldo se divide por cuatro. Devuelve siete números en virupas, del Sol a Saturno, que pueden ser negativos: un planeta muy aspectado por maléficos pierde fortaleza aquí.
dwadhasa_vargeeya_bala	—	La fortaleza duodécuple: cada planeta se sitúa en las doce cartas divisionales, de D1 a D12, y suma un punto por cada carta en la que cae en un signo amigo o mejor. Devuelve un objeto con las claves de `"0"` a `"6"` para los planetas del Sol a Saturno, cada una con un entero de 0 a 12: un simple recuento de cuántas divisiones tratan bien al planeta.
get_planet_mean_longitude	planet_index	La longitud media de un planeta en el momento indicado, calculada a partir de su posición media y su tasa diaria en la época Ujjain 1900, más una corrección por año. Pasa `planet_index` de 0 a 6 para los planetas del Sol a Saturno. Devuelve un único número de grados de 0 a 360, salvo para la Luna (índice 1), que no está implementada y devuelve 0.0. La longitud media es el dato que necesita Cheshta Bala; no es la posición verdadera del planeta.
get_planet_mean_longitude_using_epoch_table	planet_index	La misma longitud media que `get_planet_mean_longitude`, pero leída cifra a cifra de las tablas clásicas de movimiento medio de Ujjain 1900 en lugar de a partir de una tasa lineal. Pasa `planet_index` de 0 a 6 para los planetas del Sol a Saturno. Devuelve un único número de grados de 0 a 360, de nuevo 0.0 para la Luna. Los resultados difieren ligeramente del método lineal; `cheshta_bala_new` te permite alternar entre ambos.
hadda_bala	—	Fortaleza de hadda, según los términos egipcios: cada signo se divide en cinco tramos desiguales, cada uno con un señor planetario, y un planeta obtiene 15 virupas en su propio hadda, 7.5 en el de un amigo y 3.75 en el de un enemigo. Devuelve siete números, del Sol a Saturno.
hadda_bala_simple	—	Fortaleza de hadda calculada directamente a partir de la longitud de cada planeta y de las tablas de términos: 15 virupas en su propio hadda, 7.5 en el de un amigo y 3.75 en el de un enemigo. Devuelve siete números, del Sol a Saturno. Es la variante que usa realmente `pancha_vargeeya_bala`; a diferencia de `hadda_bala`, no necesita que se le pase una carta.
harsha_bala	—	Harsha Bala, la «fortaleza de la alegría» que se usa en el sistema Tajaka: un planeta suma 5 puntos por cada una de estas cuatro condiciones: estar en su casa de alegría, estar en su signo propio o en uno amigo, estar en un signo de su mismo género y estar en la mitad del día que corresponde a su naturaleza. Devuelve un objeto con las claves de `"0"` a `"6"` para los planetas del Sol a Saturno, cada una con un entero de 0 a 20, de 5 en 5.
hora_bala	—	Fortaleza de la hora planetaria: el planeta que rige la hora vigente en el momento indicado recibe 60 virupas y todos los demás planetas, cero. Devuelve siete valores, del Sol a Saturno, con exactamente una entrada distinta de cero.
ishta_phala	—	Ishta Phala, la medida del resultado benéfico que probablemente dará un planeta. Esta implementación lo puntúa según la dignidad en la carta natal: 60 por exaltación, 45 por moolatrikona, 30 por signo propio y luego 22, 15, 8, 4 o 2 según la relación del planeta con el señor del signo. Devuelve siete enteros, del Sol a Saturno. Ten en cuenta que la definición clásica deriva Ishta Phala de Uccha y Cheshta Bala, así que estas cifras no coincidirán con un texto que siga ese método.
kaala_bala	—	Fortaleza temporal, la suma de nueve subcomponentes: Nathonnatha, Paksha, Tribhaga, Abda, Masa, Vaara, Hora, Ayana y Yuddha Bala. Devuelve siete números en virupas, del Sol a Saturno, redondeados a dos decimales. Cada subcomponente está disponible como clave propia.
kendra_bala	—	Fortaleza de cuadrante según el tipo de casa: 60 virupas en un ángulo (1, 4, 7, 10), 30 en una casa sucedente (2, 5, 8, 11) y 15 en una casa cadente (3, 6, 9, 12). Devuelve siete valores de 60, 30 o 15, del Sol a Saturno. El ascendente de referencia se obtiene internamente de la posición del Sol al amanecer, no del `asc_house` que envías.
kendras	asc_house	Las cuatro casas angulares contadas desde el ascendente que pasas en `asc_house`: una lista plana de cuatro índices de signo con base CERO, casas 1, 4, 7 y 10. Ten en cuenta las dos diferencias con la clave `kendras` de /api/astro/house_hora/, que devuelve doce filas de números con base UNO y no recibe ningún argumento.
kshetra_bala	—	Fortaleza de campo, el primer componente del conjunto quíntuple de Tajaka: 30 virupas para un planeta en su signo propio, 22.5 en el de un gran amigo, 15 en el de un amigo, 7.5 en el de un neutral y 3.75 en el de un enemigo, según la carta natal. Devuelve siete números, del Sol a Saturno.
masa_bala	—	Fortaleza del señor del mes: el planeta que rige el mes recibe 30 virupas y el resto, cero. Devuelve siete valores, del Sol a Saturno, con exactamente una entrada de 30. Igual que con `abda_bala`, esta implementación toma el señor del día de la semana de `date_time`, mientras que `masadhipathi` lo deriva de los días transcurridos.
masadhipathi	—	El señor del mes, calculado a partir del ahargana y no del día de la semana. El planeta regente recibe 30 virupas y el resto, cero. Devuelve siete valores, del Sol a Saturno, con exactamente una entrada de 30. Es preferible a `masa_bala`.
naisargika_bala	—	Fortaleza natural, una clasificación fija de los planetas por su brillo que nunca varía con la carta: 60.00, 51.43, 17.14, 25.71, 34.29, 42.86 y 8.57 virupas para el Sol, la Luna, Marte, Mercurio, Júpiter, Venus y Saturno. Devuelve esas siete constantes. Se incluye porque Shadbala la cuenta como una de las seis.
nathonnath_bala	—	Fortaleza de día y noche, la primera parte de Kaala Bala: fortaleza medida desde la medianoche local, que se otorga al Sol, Júpiter y Venus a medida que avanza el día y a la Luna, Marte y Saturno a medida que avanza la noche, mientras que Mercurio recibe un valor fijo de 60 porque es fuerte a todas horas. Devuelve siete números en virupas, del Sol a Saturno.
navamsa_bala	—	Fortaleza de navamsa para el conjunto quíntuple: 5 virupas para un planeta en su signo propio en la carta D9, 2.5 en el de un amigo y 1.25 en el de un enemigo. Devuelve siete números, del Sol a Saturno. `navamsa_bala_simple` es la misma regla con la posición en D9 derivada directamente de la longitud.
navamsa_bala_simple	—	Fortaleza de navamsa con la posición en D9 calculada directamente a partir de la longitud (la longitud por nueve) en lugar de a partir de una carta D9 construida: 5 virupas en su signo propio, 2.5 en el de un amigo y 1.25 en el de un enemigo. Devuelve siete números, del Sol a Saturno. Es la variante que usa `pancha_vargeeya_bala`.
ojayugama_bala	—	Fortaleza par-impar: 15 virupas por estar en un signo impar en la carta natal y 15 más por estar en un signo impar en el navamsa; para la Luna y Venus, que prefieren los signos pares, la condición se invierte. Devuelve siete enteros de 0, 15 o 30, del Sol a Saturno.
paksha_bala	—	Fortaleza de la quincena lunar, a partir de la separación Sol-Luna dividida por tres: los benéficos obtienen esa cifra y los maléficos, 60 menos ella, de modo que la mitad creciente favorece a los benéficos y la menguante a los maléficos. Después se duplica el valor de la Luna, y por eso puede superar 60. Devuelve siete números en virupas, del Sol a Saturno.
panapharas	asc_house	Las cuatro casas sucedentes (la 2.ª, la 5.ª, la 8.ª y la 11.ª) contadas desde la casa del ascendente que pasas como `asc_house`. Devuelve cuatro enteros, `(asc_house + n - 1) mod 12` para n igual a 2, 5, 8 y 11, así que los resultados son índices de signo con base cero y siguen la convención que hayas usado para `asc_house`. Se considera que los planetas situados en ellas dan resultados intermedios, entre los ángulos y las casas cadentes.
pancha_vargeeya_bala	—	La fortaleza quíntuple de Tajaka, que se usa para las cartas anuales: la media de Kshetra, Uchcha, Hadda, Drekkana y Navamsa Bala. Un planeta en su signo propio obtiene 30 en Kshetra, 22.5 en el de un gran amigo, 15 en el de un amigo, 7.5 en el de un neutral y 3.75 en el de un enemigo; Drekkana y Navamsa se puntúan sobre 10 y 5 con el mismo principio, y Hadda sobre 15 según los señores de los términos egipcios. Devuelve un objeto con las claves de `"0"` a `"6"` para los planetas del Sol a Saturno, cada uno un número con dos decimales, normalmente entre 5 y 20.
planet_aspect_relationship_table	include_houses	La matriz completa de aspectos en la que se basa Drik Bala: para cada par ordenado de planetas, la fuerza del aspecto que el segundo proyecta sobre el primero, puntuada según la separación angular entre ellos. Devuelve un array anidado de números con dos decimales, con una fila por planeta que aspecta. Pasa `include_houses` como true para añadir columnas con las doce cúspides de las casas como puntos aspectados, además de los planetas.
sapthavargaja_bala	—	Fortaleza según el conjunto divisional séptuple: cada planeta se puntúa en D1, D2, D3, D7, D9, D12 y D30 según caiga en su moolatrikona, en su signo propio o en un signo amigo, neutral o enemigo, y se suman las siete puntuaciones. Devuelve siete números en virupas, del Sol a Saturno.
shad_bala	—	El cálculo completo de la fortaleza séxtuple. Devuelve un array de nueve elementos: los componentes Sthana, Kaala, Dig, Cheshta, Naisargika y Drik, cada uno una lista de siete números en virupas; luego los totales en virupas; luego los mismos totales en rupas (virupas divididos por 60); y por último los rupas de cada planeta divididos por su mínimo clásico de 5, 6, 5, 7, 6.5, 5.5 y 5, del Sol a Saturno. Esa última lista es la que hay que mirar: un valor superior a 1 significa que el planeta alcanzó su mínimo.
sthana_bala	—	Fortaleza posicional, la primera de las seis: la suma de Uchcha, Sapthavargaja, Ojayugama, Kendra y Dreshkona Bala. Devuelve siete números en virupas, del Sol a Saturno, redondeados a dos decimales. Pide los cinco componentes por separado si necesitas ver de dónde sale el total.
subha_rashmi	—	Subha Rashmi, el número de «rayos propicios» que emite un planeta, calculado aquí como la cuarta parte de la suma de su Cheshta y Uccha Rashmi. Devuelve siete números, del Sol a Saturno. Hereda el carácter experimental de `cheshta_rashmi`.
tribhaga_bala	—	Fortaleza del tercio del día: el día y la noche se dividen cada uno en tres partes, y el planeta que rige el tercio en curso recibe 60 virupas. Júpiter recibe siempre 60, en cualquier caso. Devuelve siete valores de 0 o 60, del Sol a Saturno.
uccha_rashmi	—	Uccha Rashmi, los rayos que emite un planeta en virtud de su exaltación: la distancia desde su punto de debilitación profunda, reducida al intervalo 0–180, más 30, convertida en rayos multiplicando por 2 y dividiendo entre 30. Devuelve siete números de aproximadamente 2 a 14, del Sol a Saturno, redondeados a un decimal.
uchcha_bala	—	Fortaleza de exaltación: a qué distancia está cada planeta de su punto de debilitación profunda, escalada de modo que un planeta situado exactamente en su grado de exaltación profunda puntúa 20 y uno situado en su grado de debilitación profunda puntúa 0. Devuelve siete números de 0 a 20 en virupas, del Sol a Saturno.
vaara_bala	—	Fortaleza del señor del día de la semana: el planeta que rige el día de la semana recibe 45 virupas y el resto, cero. Devuelve siete valores, del Sol a Saturno, con exactamente una entrada de 45. `vaaradhipathi` calcula lo mismo a partir de un recuento de días transcurridos y cambia de día al amanecer y no a medianoche.
vaaradhipathi	—	El señor del día de la semana, calculado a partir del ahargana y con el cambio de día al amanecer, no a medianoche, de modo que un momento anterior al amanecer sigue perteneciendo al señor del día anterior. El planeta regente recibe 45 virupas y el resto, cero. Devuelve siete valores, del Sol a Saturno, con exactamente una entrada de 45. Es preferible a `vaara_bala`.
yuddha_bala	—	Fortaleza por guerra planetaria. Cuando dos planetas están muy próximos, se considera vencedor el que tiene mayor fortaleza acumulada; la diferencia entre sus totales se divide entre la diferencia de los diámetros aparentes de sus discos, y el resultado se suma al vencedor y se resta al perdedor. Devuelve siete números, del Sol a Saturno, casi todos cero salvo, cuando se detecta una guerra, un par de valores iguales con signo contrario. Se omiten las guerras en las que intervienen el Sol o la Luna.

Referencia completa de este endpoint