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

Ashtakavarga

O Ashtakavarga pontua cada signo do mapa numa escala de até oito. Sete planetas e um oitavo contribuinte votam, cada um, nos doze signos; um signo que acumula muitos pontos favorece os assuntos que rege, e um que acumula poucos, não. É a forma védica padrão de classificar em quais casas e em quais trânsitos vale a pena agir, sem que você precise interpretar o mapa. Todas as chaves aqui retornam números, não texto. Um uso típico é `samudhaya_ashtaka_varga` para classificar rapidamente a força dos doze signos e, em seguida, `binna_ashtaka_varga` para o planeta que interessa a você — por exemplo, a pontuação de Júpiter no signo em que ele está transitando agora. Nota sobre a oitava linha: as tabelas indexadas por signo a rotulam como `Rahu`, enquanto as indexadas por casa (`trikona_sodhana_house`, `ekadhipatya_sodhana_house`) rotulam a mesma linha como `Ascendant`. Na tradição clássica, esse contribuinte é o ascendente. Se você ler as duas, use a posição, não o nome, como referência. As tabelas são montadas a partir do mapa divisional indicado em `chart_name`, normalmente RashiChart. Dois campos da requisição alteram a aritmética: `apply_ekadhipatya_reductions` e `use_eight_ashtakavargas_in_sav`. As fontes clássicas divergem sobre os dois, então cabe a você defini-los.

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

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
chart_name	string	obrigatório	`BhavaChartRashiChartHoraChartJagannathHoraChartParivrittidwayaHoraChartParivrittitrayaDrekkanaChartDrekkanaChartSomnathDrekkanaChartJagannathDrekkanaChartChaturthamsaChartPanchamsaChartShashthamsaChart` Não há uma lista explícita nesta view (ao contrário de /api/astro/chart/, e é por isso que isto é 'provável' e não 'certo'. Diferencia maiúsculas de minúsculas; um nome desconhecido produz "Item '<x>' is not supported". Na prática, o Ashtakvarga foi feito para rodar sobre 'RashiChart'.
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. Restrição de FORMATO, não um enum. DRF DateTimeField: apenas ISO-8601 (formatos de entrada padrão do DRF), por exemplo "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sem fuso horário = assume-se UTC).
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. `binna_ashtaka_vargasamudhaya_ashtaka_vargaprastara_ashtaka_vargatrikona_sodhana_rashitrikona_sodhana_houseekadhipatya_sodhana_rashia_ashtaka_vargaekadhipatya_sodhana_housepindas`
timezone_as_float	number (double)	obrigatório	Deslocamento UTC do local, em horas, como número decimal. Exemplo: 5.5 para a Índia (UTC+05:30), -5 para Nova York no inverno, 5.75 para o Nepal. Este valor NÃO é conferido com date_time: se os dois divergirem, você recebe uma resposta bem-sucedida para o momento errado. Por isso, tire os dois da mesma fonte. Use o deslocamento em vigor naquela data, não o de hoje: quem nasceu no verão, em um país com horário de verão, precisa do deslocamento de verão. min -12 · max 14
apply_ekadhipatya_reductions	boolean	opcional
latitude	number (double)	opcional	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 -89.9 · max 89.9
longitude	number (double)	opcional	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
use_eight_ashtakavargas_in_sav	boolean	opcional

Chaves disponíveis (8)

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
binna_ashtaka_varga	—	Bhinnashtakavarga: uma linha por contribuinte, com doze números cada, pontuados de 0-8. As linhas são Sol, Lua, Marte, Mercúrio, Júpiter, Vênus, Saturno e uma oitava rotulada `Rahu`; os doze valores vão de Áries a Peixes. Linha `Sun` com valor 3 significa que o varga do Sol dá 3 pontos a Áries. É por esta tabela que a maioria das leituras começa.
ekadhipatya_sodhana_house	—	A mesma tabela totalmente reduzida, rotacionada para que o primeiro valor seja o signo do ascendente em vez de Áries. Números idênticos aos de `ekadhipatya_sodhana_rashia_ashtaka_varga`, indexados por casa. A oitava linha é rotulada `Ascendant` aqui e `Rahu` na tabela indexada por signo.
ekadhipatya_sodhana_rashia_ashtaka_varga	—	Bhinnashtakavarga após as duas reduções: trikona e, depois, ekadhipatya, que cancela pontos entre os dois signos regidos por um mesmo planeta. Indexado por planeta, com doze valores de Áries a Peixes. Esta é a tabela a partir da qual os pindas são calculados.
pindas	—	As três ponderações finais, com sete números cada — um por planeta, do Sol a Saturno, sem oitava linha. `raasi_pindas` pondera os pontos reduzidos por signo, `graha_pindas` pelas posições dos próprios planetas, e `sodhya_pindas` é a soma dos dois. O sodhya pinda é o valor que os textos clássicos usam para julgar a força geral de um planeta, e é o que você deve usar se quiser um único número.
prastara_ashtaka_varga	—	O cálculo detalhado por trás do bhinnashtakavarga: para cada planeta, qual dos oito contribuintes deu cada ponto. Aninhado em dois níveis — planeta, depois contribuinte, depois doze valores. É maior que as outras tabelas e só é necessário se você for mostrar a derivação, e não o resultado.
samudhaya_ashtaka_varga	—	Sarvashtakavarga: os totais, um número por signo, com chaves de `Raasi 1` a `Raasi 12` para os signos de Áries a Peixes. Cada um é a soma dos pontos de todos os planetas naquele signo, então os doze somam 337 no esquema clássico. Use-o para classificar os signos por força em uma única chamada.
trikona_sodhana_house	—	A mesma tabela com redução trikona, rotacionada para que o primeiro valor seja o signo do ascendente em vez de Áries — números idênticos aos de `trikona_sodhana_rashi`, indexados por casa. Use-a ao dispor as casas de 1 a 12. A mesma oitava linha é rotulada `Ascendant` aqui e `Rahu` na tabela indexada por signo.
trikona_sodhana_rashi	—	Bhinnashtakavarga após a redução trikona (trinal), a primeira das duas reduções clássicas aplicadas antes dos pindas. Indexado por planeta, com doze valores de Áries a Peixes.

Exemplo de requisição

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

Resposta

{
  "data": {
    "samudhaya_ashtaka_varga": {
      "Raasi 1": 28,
      "Raasi 2": 36,
      "Raasi 3": 40,
      "Raasi 4": 25,
      "Raasi 5": 24,
      "Raasi 6": 23,
      "Raasi 7": 26,
      "Raasi 8": 25,
      "Raasi 9": 28,
      "Raasi 10": 34,
      "Raasi 11": 25,
      "Raasi 12": 23
    }
  },
  "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.