POST/api/astro/strength/1 crédito

Shadbala e força planetária

Shadbala, "seis forças", é a forma clássica de medir em números o quanto um planeta consegue de fato realizar. Seis fontes são pontuadas separadamente — posição, tempo, direção, movimento, hierarquia natural e aspectos recebidos — e depois somadas. O total é expresso em virupas (sessenta virupas formam um rupa); cada planeta tem um mínimo em rupas que deve superar, e a razão entre o que ele marcou e esse mínimo é o número que realmente importa. Este endpoint expõe esse total, cada componente e subcomponente dele e vários esquemas de força relacionados. Comece por `shad_bala`. Essa chave retorna um array de nove elementos: as seis listas de componentes, depois os totais em virupas, os mesmos totais em rupas e, por fim, os rupas de cada planeta divididos pelo seu mínimo (Sol 5, Lua 6, Marte 5, Mercúrio 7, Júpiter 6.5, Vênus 5.5, Saturno 5). Uma razão acima de 1 significa que o planeta atingiu o mínimo. Toda lista de sete elementos neste endpoint segue a ordem Sol, Lua, Marte, Mercúrio, Júpiter, Vênus, Saturno; toda lista de doze elementos corresponde às casas de um a doze. Envie `date_time`, `latitude`, `longitude` e `timezone`. Observe que aqui o campo é `timezone`, e não `timezone_as_float` como na maioria dos outros endpoints. `asc_house` é obrigatório, mas só as três chaves de classificação de casas o usam; `planet_index`, `include_houses` e `use_epoch_table` só são usados pelas chaves que os mencionam. Além do Shadbala, o endpoint traz as forças quíntupla e duodécupla do Tajaka, a pontuação benéfica Ishta Phala, as medidas de raios Rashmi e o Harsha Bala. O Bhava Bala, que mede a força das casas e não dos planetas, aparece na lista de chaves, mas seus três componentes são stubs não implementados que retornam zeros; por isso, `bhava_bala` também retorna zeros.

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

Testar requisição

Autenticação

Envie sua chave no cabeçalho X-API-Key. A chave é uma credencial de servidor — nunca a coloque no JavaScript do navegador nem num app mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Campos da requisição

Campo	Tipo	Obrigatório	Observações
asc_house	integer	obrigatório
date_time	string (date-time)	obrigatório	O momento a calcular, em ISO 8601. SEMPRE inclua um deslocamento ou um Z no final - um valor sem fuso horário é lido como Asia/Kolkata (UTC+05:30), não como UTC, e pode retornar o resultado do dia anterior com um 200. '2026-09-01T06:00:00Z' e '2026-09-01 06:00:00' são instantes diferentes e dão respostas diferentes.
keys	array	obrigatório	Quais cálculos retornar, como uma lista de nomes. Veja a tabela de chaves deste endpoint; um nome não reconhecido rejeita a requisição inteira. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite tudo o que precisa de uma vez em vez de fazer várias chamadas.
latitude	number (double)	obrigatório	Latitude do local, em graus decimais. Positivo é norte, negativo é sul. Exemplo: 26.9124 para Jaipur, 40.7128 para Nova York. Minutos e segundos não são aceitos - converta antes. min -90 · max 90
longitude	number (double)	obrigatório	Longitude do local, em graus decimais. Positivo é leste, negativo é oeste. Exemplo: 75.7873 para Jaipur, -74.0060 para Nova York. Atenção ao sinal: sem o sinal de menos, Nova York vai parar na China. min -180 · max 180
timezone	number (double)	obrigatório	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30). Equivale a timezone_as_float, nome que outros endpoints usam para o mesmo valor. min -12 · max 14
include_houses	boolean	opcional
planet_index	integer	opcional
use_epoch_table	boolean	opcional

Chaves disponíveis (50)

Liste em keys só os cálculos que você quer. Uma chave desconhecida faz a requisição inteira ser rejeitada. O custo é 1 crédito, não importa quantas chaves você peça — então agrupe tudo numa chamada só.

Chave	Campos extras exigidos	Descrição
abda_bala	—	Força do senhor do ano: o planeta que rege o ano recebe 15 virupas e os demais, zero. Retorna sete valores, do Sol a Saturno, com exatamente uma entrada igual a 15. Observe que esta implementação escolhe o senhor a partir do dia da semana de `date_time`; `abdadhipathi` calcula o senhor do ano da forma clássica, a partir dos dias decorridos, e é a mais indicada.
abdadhipathi	—	O senhor do ano, determinado da forma clássica a partir do ahargana — a contagem de dias decorridos desde uma época de base — e não a partir do dia da semana. O planeta regente recebe 15 virupas e os demais, zero. Retorna sete valores, do Sol a Saturno, com exatamente uma entrada igual a 15. Prefira esta chave a `abda_bala`.
apoklimas	asc_house	As quatro casas cadentes — a 3ª, a 6ª, a 9ª e a 12ª — contadas a partir da casa do ascendente que você passa em `asc_house`. Retorna quatro inteiros, `(asc_house + n - 1) mod 12` para n igual a 3, 6, 9 e 12, baseados em zero como `panapharas`. Planetas nessas casas são considerados os mais fracos pela posição, e é por isso que o Kendra Bala lhes dá menos pontos.
ayana_bala	—	Força de declinação, a partir da distância de cada planeta ao norte ou ao sul do equador celeste: a declinação mais 24, multiplicada por 1.25, com o resultado do Sol dobrado. Retorna sete números em virupas, do Sol a Saturno.
bhava_adhipathi_bala	—	O componente do senhor da casa no Bhava Bala: a contribuição que uma casa obtém da força de seu próprio senhor. Retorna doze números, para as casas de um a doze. No momento, é um placeholder não implementado que retorna zeros.
bhava_bala	—	Bhava Bala, a força das casas, e não dos planetas, formada a partir de Bhava Adhipathi, Bhava Dig e Bhava Drik Bala. Retorna um array de três elementos — doze valores em virupas, os mesmos em rupas e cada um dividido pelo mínimo de 5 rupas —, para as casas de um a doze. Seus três componentes são placeholders não implementados no motor atual, então, no momento, todos os valores aqui são zero.
bhava_dig_bala	—	O componente direcional do Bhava Bala: a força que uma casa obtém da correspondência entre o tipo de assuntos que ela rege e a direção que ela ocupa. Retorna doze números, para as casas de um a doze. No momento, é um placeholder não implementado que retorna zeros.
bhava_drik_bala	—	O componente aspectual do Bhava Bala: o saldo dos aspectos benéficos e maléficos que recaem sobre cada casa. Retorna doze números, para as casas de um a doze. No momento, é um placeholder não implementado que retorna zeros.
bhava_madhya	—	Os doze bhava madhyas, os pontos médios das casas, calculados a partir das cúspides de Placidus em longitude sideral. Retorna doze números em graus, de 0 a 360, começando pela casa um. O Dig Bala os usa internamente, e eles também servem por si só se você quiser os pontos médios das casas em vez das cúspides.
cheshta_bala	—	Força de movimento, o quarto dos seis componentes: a diferença entre o seeghrocha de um planeta e a média de suas longitudes verdadeira e média, dividida por três — alta quando o planeta está lento, estacionário ou retrógrado e baixa quando ele avança rapidamente. Retorna sete números em virupas; o Sol e a Lua são sempre 0, pois nunca ficam retrógrados.
cheshta_bala_new	use_epoch_table	Uma segunda implementação da força de movimento, que calcula as longitudes médias a partir da época de Ujjain 1900, e não das efemérides. Passe `use_epoch_table` como true para usar as tabelas clássicas de movimento médio, ou como false para usar uma taxa linear a partir da mesma época. Retorna sete números em virupas, com o Sol e a Lua sempre em 0. Use-a para comparar com `cheshta_bala`; as duas não coincidem exatamente, e isso é proposital.
cheshta_rashmi	—	Cheshta Rashmi, os raios que um planeta emite em virtude de seu movimento, derivados do Cheshta Bala e rebatidos para um intervalo de 0–180 antes de serem convertidos em raios. Retorna sete números, do Sol a Saturno. Marcado como experimental no código-fonte; não foi feito para servir de base confiável.
dig_bala	—	Força direcional, o terceiro dos seis componentes: a distância de cada planeta ao ponto médio da casa em que ele é considerado sem força — a quarta para o Sol e Marte, a décima para a Lua e Vênus, a sétima para Mercúrio e Júpiter, a primeira para Saturno —, com a separação dividida por três. Retorna sete números em virupas, do Sol a Saturno, arredondados para duas casas decimais.
drekkana_bala	—	Força de drekkana para o conjunto quíntuplo: 10 virupas para um planeta em seu próprio signo no mapa D3, 5 no de um amigo e 2.5 no de um inimigo. Retorna sete números, do Sol a Saturno. `drekkana_bala_simple` é a mesma regra com a posição em D3 derivada diretamente da longitude.
drekkana_bala_simple	—	Força de drekkana com a posição em D3 calculada diretamente da longitude (longitude vezes três), e não a partir de um mapa D3 montado: 10 virupas no próprio signo, 5 no de um amigo, 2.5 no de um inimigo. Retorna sete números, do Sol a Saturno. Esta é a variante que `pancha_vargeeya_bala` usa.
dreshkon_bala	—	Força de drekkana: 15 virupas para um planeta masculino (Sol, Marte, Júpiter) no primeiro terço de seu signo, para Mercúrio ou Saturno no terço do meio e para a Lua ou Vênus no último terço; 0 nos demais casos. Retorna sete valores, cada um 0 ou 15, do Sol a Saturno.
drik_bala	—	Força aspectual: os aspectos de cada planeta sobre todos os outros são pontuados pelo ângulo entre eles, os aspectos benéficos são somados e os maléficos, subtraídos, e o saldo é dividido por quatro. Retorna sete números em virupas, do Sol a Saturno, que podem ser negativos — um planeta fortemente aspectado por maléficos perde força aqui.
dwadhasa_vargeeya_bala	—	A força duodécupla: cada planeta é colocado nos doze mapas divisionais, de D1 a D12, e marca um ponto para cada mapa em que cai em um signo amigo ou melhor. Retorna um objeto com chaves de `"0"` a `"6"`, do Sol a Saturno, cada uma com um inteiro de 0 a 12 — uma simples contagem de quantas divisões favorecem o planeta.
get_planet_mean_longitude	planet_index	A longitude média de um planeta no momento informado, calculada a partir de sua posição média e de sua taxa diária na época de Ujjain 1900, mais uma correção por ano. Passe `planet_index` de 0 a 6, do Sol a Saturno. Retorna um único número, em graus, de 0 a 360 — exceto para a Lua, índice 1, que não está implementada e retorna 0.0. A longitude média é o ingrediente de que o Cheshta Bala precisa; não é a posição verdadeira do planeta.
get_planet_mean_longitude_using_epoch_table	planet_index	A mesma longitude média de `get_planet_mean_longitude`, mas lida dígito a dígito das tabelas clássicas de movimento médio de Ujjain 1900, em vez de a partir de uma taxa linear. Passe `planet_index` de 0 a 6, do Sol a Saturno. Retorna um único número, em graus, de 0 a 360, novamente 0.0 para a Lua. Os resultados diferem ligeiramente dos do método linear; `cheshta_bala_new` permite alternar entre os dois.
hadda_bala	—	Força de hadda, a partir dos termos egípcios: cada signo é dividido em cinco trechos desiguais, cada um com um senhor planetário, e um planeta marca 15 virupas em seu próprio hadda, 7.5 no de um amigo e 3.75 no de um inimigo. Retorna sete números, do Sol a Saturno.
hadda_bala_simple	—	Força de hadda calculada diretamente da longitude de cada planeta e das tabelas de termos — 15 virupas no próprio hadda, 7.5 no de um amigo, 3.75 no de um inimigo. Retorna sete números, do Sol a Saturno. Esta é a variante que `pancha_vargeeya_bala` de fato usa; ao contrário de `hadda_bala`, não exige que você passe um mapa.
harsha_bala	—	Harsha Bala, a "força da alegria" usada na prática do Tajaka: um planeta marca 5 pontos para cada uma de quatro condições — estar em sua casa de alegria, estar em seu próprio signo ou em um signo amigo, estar em um signo que corresponde ao seu gênero e estar na metade do dia que corresponde à sua natureza. Retorna um objeto com chaves de `"0"` a `"6"`, do Sol a Saturno, cada uma com um inteiro de 0 a 20 em incrementos de 5.
hora_bala	—	Força da hora planetária: o planeta que rege a hora em vigor no momento informado recebe 60 virupas, e todos os outros planetas, zero. Retorna sete valores, do Sol a Saturno, com exatamente uma entrada diferente de zero.
ishta_phala	—	Ishta Phala, a medida do resultado benéfico que um planeta tende a produzir. Esta implementação o pontua a partir da dignidade no mapa natal: 60 para exaltação, 45 para moolatrikona, 30 para signo próprio e, depois, 22, 15, 8, 4 ou 2 conforme a relação do planeta com o senhor do signo. Retorna sete inteiros, do Sol a Saturno. Observe que a definição clássica, em vez disso, deriva o Ishta Phala de Uccha e Cheshta Bala, então esses valores não vão coincidir com os de um texto que siga esse caminho.
kaala_bala	—	Força temporal, a soma de nove subcomponentes: Nathonnatha, Paksha, Tribhaga, Abda, Masa, Vaara, Hora, Ayana e Yuddha Bala. Retorna sete números em virupas, do Sol a Saturno, arredondados para duas casas decimais. Cada subcomponente está disponível como uma chave própria.
kendra_bala	—	Força de quadrante por tipo de casa: 60 virupas em uma casa angular (1, 4, 7, 10), 30 em uma casa sucedente (2, 5, 8, 11) e 15 em uma casa cadente (3, 6, 9, 12). Retorna sete valores, cada um 60, 30 ou 15, do Sol a Saturno. O ascendente de referência é derivado internamente da posição do Sol ao nascer do sol, e não do `asc_house` que você envia.
kendras	asc_house	As quatro casas angulares contadas a partir do ascendente que você passa em `asc_house`: uma lista plana de quatro índices de signo baseados em ZERO, para as casas 1, 4, 7 e 10. Observe as duas diferenças em relação à chave `kendras` de /api/astro/house_hora/, que retorna doze linhas de números baseados em UM e não recebe argumento.
kshetra_bala	—	Força de campo, o primeiro componente do conjunto quíntuplo do Tajaka: 30 virupas para um planeta em seu próprio signo, 22.5 no de um grande amigo, 15 no de um amigo, 7.5 no de um neutro e 3.75 no de um inimigo, com base no mapa natal. Retorna sete números, do Sol a Saturno.
masa_bala	—	Força do senhor do mês: o planeta que rege o mês recebe 30 virupas e os demais, zero. Retorna sete valores, do Sol a Saturno, com exatamente uma entrada igual a 30. Assim como em `abda_bala`, esta implementação escolhe o senhor pelo dia da semana de `date_time`, enquanto `masadhipathi` o deriva dos dias decorridos.
masadhipathi	—	O senhor do mês, determinado a partir do ahargana, e não a partir do dia da semana. O planeta regente recebe 30 virupas e os demais, zero. Retorna sete valores, do Sol a Saturno, com exatamente uma entrada igual a 30. Prefira esta chave a `masa_bala`.
naisargika_bala	—	Força natural, uma classificação fixa dos planetas por brilho que nunca varia com o mapa: 60.00, 51.43, 17.14, 25.71, 34.29, 42.86 e 8.57 virupas para Sol, Lua, Marte, Mercúrio, Júpiter, Vênus e Saturno. Retorna essas sete constantes. Incluída porque o Shadbala a conta como uma das seis.
nathonnath_bala	—	Força dia-noite, a primeira parte do Kaala Bala: força medida a partir da meia-noite local, atribuída ao Sol, a Júpiter e a Vênus à medida que o dia avança e à Lua, a Marte e a Saturno à medida que a noite avança, com Mercúrio recebendo um valor fixo de 60 porque é forte a qualquer hora. Retorna sete números em virupas, do Sol a Saturno.
navamsa_bala	—	Força de navamsa para o conjunto quíntuplo: 5 virupas para um planeta em seu próprio signo no mapa D9, 2.5 no de um amigo e 1.25 no de um inimigo. Retorna sete números, do Sol a Saturno. `navamsa_bala_simple` é a mesma regra com a posição em D9 derivada diretamente da longitude.
navamsa_bala_simple	—	Força de navamsa com a posição em D9 calculada diretamente da longitude (longitude vezes nove), e não a partir de um mapa D9 montado: 5 virupas no próprio signo, 2.5 no de um amigo, 1.25 no de um inimigo. Retorna sete números, do Sol a Saturno. Esta é a variante que `pancha_vargeeya_bala` usa.
ojayugama_bala	—	Força ímpar-par: 15 virupas por estar em um signo ímpar no mapa natal e mais 15 por um signo ímpar no navamsa, com o teste invertido para a Lua e Vênus, que preferem signos pares. Retorna sete inteiros, cada um 0, 15 ou 30, do Sol a Saturno.
paksha_bala	—	Força da quinzena lunar, a partir da separação Sol-Lua dividida por três: os benéficos pontuam esse valor e os maléficos, 60 menos esse valor, então a metade crescente favorece os benéficos e a metade minguante, os maléficos. O valor da Lua é então dobrado, e é por isso que ele pode passar de 60. Retorna sete números em virupas, do Sol a Saturno.
panapharas	asc_house	As quatro casas sucedentes — a 2ª, a 5ª, a 8ª e a 11ª — contadas a partir da casa do ascendente que você passa como `asc_house`. Retorna quatro inteiros, `(asc_house + n - 1) mod 12` para n igual a 2, 5, 8 e 11, então os resultados são índices de signo baseados em zero e seguem a convenção que você tiver usado para `asc_house`. Planetas nessas casas tendem a dar resultados medianos, entre os das casas angulares e os das cadentes.
pancha_vargeeya_bala	—	A força quíntupla do Tajaka, usada para mapas anuais: a média de Kshetra, Uchcha, Hadda, Drekkana e Navamsa Bala. Um planeta em seu próprio signo marca 30 no Kshetra, 22.5 no de um grande amigo, 15 no de um amigo, 7.5 no de um neutro e 3.75 no de um inimigo; Drekkana e Navamsa são pontuados com máximo de 10 e 5 pelo mesmo princípio, e Hadda com máximo de 15 pelos senhores dos termos egípcios. Retorna um objeto com chaves de `"0"` a `"6"`, do Sol a Saturno, cada uma com um número com duas casas decimais, normalmente entre 5 e 20.
planet_aspect_relationship_table	include_houses	A matriz completa de aspectos subjacente ao Drik Bala: para cada par ordenado de planetas, a força do aspecto que o segundo lança sobre o primeiro, pontuada pela separação angular entre eles. Retorna um array aninhado de números com duas casas decimais, com uma linha por planeta que aspecta. Passe `include_houses` como true para estender as colunas com as doze cúspides das casas como pontos aspectados, além dos planetas.
sapthavargaja_bala	—	Força a partir do conjunto divisional sétuplo: cada planeta é pontuado em D1, D2, D3, D7, D9, D12 e D30 conforme caia em seu moolatrikona, em seu próprio signo ou em um signo amigo, neutro ou inimigo, e as sete pontuações são somadas. Retorna sete números em virupas, do Sol a Saturno.
shad_bala	—	O cálculo completo da força sêxtupla. Retorna um array de nove elementos: os componentes Sthana, Kaala, Dig, Cheshta, Naisargika e Drik, cada um uma lista de sete números em virupas; depois, os totais em virupas; depois, os mesmos totais em rupas (virupas divididos por 60); depois, os rupas de cada planeta divididos pelo mínimo clássico de 5, 6, 5, 7, 6.5, 5.5 e 5, do Sol a Saturno. É essa última lista que interessa — acima de 1, o planeta atingiu o mínimo.
sthana_bala	—	Força posicional, a primeira das seis: a soma de Uchcha, Sapthavargaja, Ojayugama, Kendra e Dreshkona Bala. Retorna sete números em virupas, do Sol a Saturno, arredondados para duas casas decimais. Solicite os cinco componentes separadamente se precisar ver de onde veio o total.
subha_rashmi	—	Subha Rashmi, a contagem de "raios auspiciosos" que um planeta emite, calculada aqui como um quarto da soma de seus Cheshta e Uccha Rashmi. Retorna sete números, do Sol a Saturno. Herda o status experimental de `cheshta_rashmi`.
tribhaga_bala	—	Força do terço do dia: o dia e a noite são divididos, cada um, em três partes, e o planeta que rege o terço atual recebe 60 virupas. Júpiter sempre recebe 60, independentemente disso. Retorna sete valores, cada um 0 ou 60, do Sol a Saturno.
uccha_rashmi	—	Uccha Rashmi, os raios que um planeta emite em virtude da sua exaltação: a distância do seu ponto de debilitação profunda, rebatida para o intervalo 0–180, mais 30, convertida em raios multiplicando por 2 e dividindo por 30. Retorna sete números de cerca de 2 a 14, do Sol a Saturno, arredondados para uma casa decimal.
uchcha_bala	—	Força de exaltação: a que distância cada planeta está do seu ponto de debilitação profunda, em uma escala na qual um planeta exatamente no seu grau de exaltação profunda obtém 20 e um planeta no seu grau de debilitação profunda obtém 0. Retorna sete números de 0 a 20 em virupas, do Sol a Saturno.
vaara_bala	—	Força do senhor do dia da semana: o planeta que rege o dia da semana recebe 45 virupas e os demais, zero. Retorna sete valores, do Sol a Saturno, com exatamente uma entrada igual a 45. `vaaradhipathi` calcula a mesma coisa a partir de uma contagem de dias decorridos e faz a virada do dia no nascer do sol, em vez de à meia-noite.
vaaradhipathi	—	O senhor do dia da semana, obtido a partir do ahargana e com a virada do dia no nascer do sol, em vez de à meia-noite, de modo que um momento antes do nascer do sol ainda pertence ao senhor do dia anterior. O planeta regente recebe 45 virupas e os demais, zero. Retorna sete valores, do Sol a Saturno, com exatamente uma entrada igual a 45. Prefira este a `vaara_bala`.
yuddha_bala	—	Força de guerra planetária. Quando dois planetas estão muito próximos, o que tem a maior força acumulada é considerado o vencedor; a diferença entre os totais dos dois é dividida pela diferença entre os diâmetros aparentes dos seus discos, somada ao vencedor e subtraída do perdedor. Retorna sete números, do Sol a Saturno, quase todos zero, com um par de valores positivo e negativo correspondentes quando há uma guerra. Guerras que envolvem o Sol ou a Lua são ignoradas.

Exemplo de requisição

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}'

Resposta

{
  "data": {
    "harsha_bala": {
      "0": 10,
      "1": 0,
      "2": 10,
      "3": 0,
      "4": 5,
      "5": 10,
      "6": 5
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data, sob cada chave que você pediu.

Erros

Erros de consumo de créditos retornam { "error": "…", "message": "<code>", "is_error": true }. Mostre error para o usuário e use message para decidir o que fazer no código. Consulte a referência de erros.