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

Relações entre casas

A estrutura relacional de um mapa natal: quais signos aspectam quais, quais planetas aspectam quais, quem é amigo de quem e quais planetas os textos clássicos destacam como significativos para os momentos decisivos de um mapa. É boa parte da engrenagem por trás da interpretação nas escolas de Jaimini e parashari, disponível peça por peça. Há três grupos. As chaves de classes de casas (`trikonas`, `kendras`, `quadrants`, `dushthanas`, `chathusras`, `upachayas`) são pura geometria: doze linhas, uma por signo, com números de signo de 1 a 12, sem nenhuma dependência do mapa. As chaves de aspecto e de relação (`raasi_drishti_of_the_planet`, as três chaves `aspected_*_of_the_planet`, as duas chaves `*_of_the_raasi`, `argala`, `associations_of_the_planet`, as três chaves de amizade natural e `baadhakas_of_raasi`) descrevem como os corpos do mapa se situam uns em relação aos outros. As chaves de Jaimini (`chara_karakas`, `marakas`, `brahma`, `rudra`, `maheshwara`, `trishoola_rasis`, `order_of_planets_by_strength`) indicam os planetas que importam para a longevidade e para situar no tempo os grandes eventos. Em todas as chaves, os planetas vêm como índices: 0 Sol, 1 Lua, 2 Marte, 3 Mercúrio, 4 Júpiter, 5 Vênus, 6 Saturno, 7 Rahu, 8 Ketu. Os signos são baseados em zero (de 0 Áries a 11 Peixes) nas chaves de aspecto e de Jaimini, mas baseados em 1 (de 1 a 12) nas chaves de classes de casas, então confira qual você está lendo. O campo da requisição `planet` tem inicial maiúscula e diferencia maiúsculas de minúsculas — 'Sun', não 'sun' —, e `raasi` é um inteiro baseado em zero sem verificação de limites, então um valor fora de 0–11 faz a requisição falhar.

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

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
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. 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. `trikonasdushthanaschathusrasquadrantskendrasupachayaschara_karakasraasi_drishti_of_the_planetaspected_planets_of_the_planetaspected_rasis_of_the_planetaspected_houses_of_the_planetaspected_houses_of_the_raasi` Array de strings. As chaves terminadas em '_of_the_planet', além de 'associations_of_the_planet', requerem `planet`; as chaves terminadas em '_of_the_raasi', além de 'baadhakas_of_raasi', requerem `raasi`.
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
node	string	obrigatório	`truemean` Diferencia maiúsculas de minúsculas; em minúsculas. 'true' usa os nodos lunares verdadeiros, 'mean' os nodos médios. Qualquer outro valor produz um KeyError -> 400. Encaminhado em.
planet	string	obrigatório	`SunMoonMarsMercuryJupiterVenusSaturnRahuKetu` DIFERENCIA maiúsculas de minúsculas, com inicial maiúscula - observe que isso difere dos nomes de corpos celestes em minúsculas usados por /api/astro/chart_analysis/.
raasi	integer	obrigatório	`01234567891011` Inteiro, não uma string. Usado como índice de signo BASEADO EM 0: 0 = Áries... 11 = Peixes. Não há verificação de limites, então valores fora do intervalo geram IndexError -> 400 e valores negativos dão a volta silenciosamente.
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

Chaves disponíveis (29)

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
argala	—	Argala e virodhargala para o mapa inteiro, como uma lista de dois elementos. O primeiro elemento é o argala, a intervenção que uma casa exerce: doze linhas, uma por casa a partir do ascendente, cada uma com quatro strings para a 2ª, a 4ª, a 5ª e a 11ª a partir dessa casa, com os índices dos planetas ocupantes unidos por '/' e uma string vazia onde não há nada. O segundo elemento é o virodhargala, a obstrução a ele, no mesmo formato para a 12ª, a 10ª, a 9ª e a 3ª — tomadas nessa ordem, de modo que as colunas fazem par com as do argala.
aspected_houses_of_the_planet	planet	Os mesmos aspectos de graha drishti que `aspected_rasis_of_the_planet`, mas expressos como números de casa contados a partir do ascendente, de 1 a 12, em vez de índices de signo. Requer `planet`.
aspected_houses_of_the_raasi	raasi	As casas, de 1 a 12 contadas a partir do ascendente, que o signo informado aspecta sob rasi drishti — todas elas, estejam ou não ocupadas por um planeta. Requer `raasi` como índice de signo baseado em zero.
aspected_planets_of_the_planet	planet	Os planetas que o planeta informado aspecta sob graha drishti — o aspecto planetário parashari, no qual todo planeta vê a 7ª e Marte, Júpiter e Saturno têm seus aspectos adicionais. Retorna uma lista de índices de planetas. Requer `planet`.
aspected_raasis_of_the_raasi	raasi	A mesma relação de rasi drishti que `aspected_houses_of_the_raasi`, retornada como índices de signo baseados em zero em vez de números de casa, então não depende em nada do ascendente. Requer `raasi`.
aspected_rasis_of_the_planet	planet	Os signos que o planeta informado aspecta sob graha drishti, como uma lista de índices de signo baseados em zero, de 0 para Áries a 11 para Peixes. A forma em signos de `aspected_houses_of_the_planet`. Requer `planet`.
associations_of_the_planet	planet	Todos os planetas com ligação relevante com o planeta informado, por qualquer uma das três vias clássicas: estar no mesmo signo que ele, aspectá-lo sob graha drishti ou estar em troca de signos (parivartana) com ele. Retorna uma lista de índices de planetas sem duplicatas. Requer `planet`.
baadhakas_of_raasi	raasi	A casa baadhaka, ou obstrutora, de um dado signo ascendente e os planetas que a regem — a 11ª para signos móveis, a 9ª para os fixos e a 7ª para os duplos. Retorna uma lista de dois elementos [o signo baadhaka baseado em zero, a lista dos índices dos planetas que o regem]. Requer `raasi`.
brahma	—	Brahma, o planeta que Jaimini associa à sustentação da vida. É o mais forte dos senhores da 6ª, da 8ª e da 12ª, contadas a partir do mais forte entre o ascendente e a sétima casa, excluindo Rahu e Ketu; empates são resolvidos por dignidade, posição em signo ímpar e posição dentro da metade. Retorna um único índice de planeta.
chara_karakas	—	Os oito chara karakas, como uma lista de oito índices de planetas ordenados por grau decrescente dentro do seu signo. A primeira entrada é o Atmakaraka e as demais seguem na ordem padrão (Amatya, Bhratri, Matri, Pitri, Putra, Gnati, Dara). Ketu é excluído, e Rahu é classificado pela sua longitude invertida, como exige a regra clássica.
chathusras	—	Doze linhas com dois números de signo no intervalo 1–12. Conforme implementado, cada linha dá o 3º e o 5º a partir do signo — a linha 1 é [3, 5] — em vez do 4º e do 8º que o par chatusra clássico indica.
dushthanas	—	Doze linhas com três números de signo no intervalo 1–12. Conforme implementado, cada linha dá o próprio signo, o 3º a partir dele e o 7º a partir dele — a linha 1 é [1, 3, 7] —, o que não é o conjunto clássico de dusthanas 6º/8º/12º, então trate a saída como aquilo que o código calcula, e não como dusthanas no sentido dos manuais.
kendras	—	Os quadrantes de cada signo: doze linhas, uma por signo, cada uma com uma lista de quatro números de signo de 1 a 12. A linha 0 é Áries. Não recebe argumentos. O formato é diferente do da chave `kendras` em /api/astro/strength/, que recebe um `asc_house` e retorna uma única lista plana de quatro índices baseados em ZERO - o erro a evitar é confundir as duas contagens, que diferem em uma unidade.
maheshwara	—	O mesmo valor que `maheshwara_from_planet_positions` — esta chave delega diretamente a ela e retorna o mesmo índice único de planeta. Peça só uma das duas.
maheshwara_from_planet_positions	—	Maheshwara, o planeta que Jaimini associa ao modo da morte, tomado como o senhor do oitavo signo a partir do Atmakaraka, com as substituições clássicas aplicadas quando esse senhor está em seu signo próprio ou tem um nodo em conjunção ou em oposição a ele. Retorna um único índice de planeta; caso o resultado seja Rahu ou Ketu, ele é substituído por Mercúrio ou Júpiter, respectivamente.
marakas	—	Os mesmos planetas maraka que `marakas_from_planet_positions`, mas calculados a partir da forma casa-planeta do mapa. O resultado é a mesma lista de índices de planetas, então peça só uma das duas chaves.
marakas_from_planet_positions	—	Os planetas maraka, ou que infligem a morte: os senhores da 2ª e da 7ª casas, junto com qualquer planeta situado em uma dessas casas ou com um desses senhores. Retorna uma lista de índices de planetas sem ordem específica. Calculado a partir da forma de posições planetárias do mapa.
natural_enemies_of_planets	—	A tabela padrão de inimizade, como uma lista de nove listas indexada por planeta 0–8, cada uma com os planetas hostis a ele. É fixa, não depende do mapa e é a contraparte de `natural_neutral_of_planets`.
natural_friends_of_planets	—	Amizade planetária permanente, derivada das próprias regências de signos deste mapa: um objeto indexado por índice de planeta 0–8, cada entrada com uma lista dos índices dos planetas amigos dele. Para os sete planetas clássicos, o senhor do signo de exaltação é incluído junto com os senhores dos signos amigos.
natural_neutral_of_planets	—	A tabela padrão de neutralidade, como uma lista de nove listas indexada por planeta 0–8, cada uma com os planetas neutros em relação a ele. Ao contrário de `natural_friends_of_planets`, esta é a tabela clássica fixa e não depende em nada do mapa.
order_of_planets_by_strength	—	Todos os nove planetas em ordem de força, o mais forte primeiro, como uma lista de nove índices de planetas. A ordem vem da comparação de força par a par do motor, a mesma usada para escolher entre senhores candidatos nos cálculos de Rudra e Maheshwara.
planets_aspecting_the_planet	planet	Deveria retornar os planetas que lançam graha drishti sobre o planeta informado, como uma lista de índices de planetas. Do jeito que está, compara o nome do planeta, com inicial maiúscula, a listas de índices de planetas, então retorna uma lista vazia para qualquer entrada; em vez disso, use `aspected_planets_of_the_planet` para cada planeta, um por vez, e inverta o resultado.
quadrants	—	Os ângulos de cada signo: doze linhas, cada uma com quatro números de signo no intervalo 1–12: o próprio signo e o 4º, o 7º e o 10º a partir dele. A linha 1 é [1, 4, 7, 10]. É um alias de `kendras` neste endpoint — os dois não podem diferir, então pedir ambos só desperdiça uma posição na resposta.
raasi_drishti_of_the_planet	planet	Os planetas situados nos signos que o próprio signo do planeta informado aspecta sob rasi drishti — o aspecto de signo para signo de Jaimini, no qual os signos móveis veem os fixos e vice-versa, e os signos duplos veem uns aos outros. Retorna uma lista de índices de planetas. Requer `planet`.
rudra	—	Rudra, tomado como o mais forte entre o senhor da oitava casa a partir do ascendente e o senhor da oitava casa a partir da sétima. Retorna [índice do planeta, o signo baseado em zero que ele ocupa, os três signos do trígono desse signo, baseados em zero]. Observe que isso difere de `rudra_based_on_planet_positions`, que deriva o segundo dos dois senhores de outra forma e, por isso, pode retornar um planeta diferente.
rudra_based_on_planet_positions	—	Rudra, o planeta que Jaimini associa à virada destrutiva de um mapa — aqui, o mais forte entre o senhor do oitavo signo a partir do ascendente e o senhor da sétima casa. Retorna uma lista de três elementos [índice do planeta, o signo baseado em zero que ele ocupa, os três signos do trígono desse signo, baseados em zero]. Usa uma derivação diferente da de `rudra`, e os dois podem indicar planetas diferentes.
trikonas	—	Os trígonos de cada signo: doze linhas, cada uma com três números de signo no intervalo 1–12: o próprio signo e o 5º e o 9º a partir dele. A linha 1 é [1, 5, 9]. Pura geometria — igual para todo mapa.
trishoola_rasis	—	Os Trishula rasis, o tridente de três signos usado para avaliar o momento do período mais danoso de um mapa: os trígonos do signo que o Rudra ocupa. Retorna três índices de signo baseados em zero.
upachayas	—	Doze linhas com quatro números de signo no intervalo 1–12. Conforme implementado, cada linha dá o próprio signo e o 4º, o 8º e o 9º a partir dele — a linha 1 é [1, 4, 8, 9] — em vez do 3º, do 6º, do 10º e do 11º que, na tradição clássica, compõem o conjunto upachaya.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/house_hora/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["trikonas"],"raasi":2,"planet":"Mars","node":"mean","date_time":"2025-02-12T09:35:49.036Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Resposta

{
  "data": {
    "trikonas": [
      [
        1,
        5,
        9
      ],
      [
        2,
        6,
        10
      ],
      [
        3,
        7,
        11
      ],
      [
        4,
        8,
        12
      ],
      [
        5,
        9,
        1
      ],
      [
        6,
        10,
        2
      ],
      [
        7,
        11,
        3
      ],
      [
        8,
        12,
        4
      ],
      [
        9,
        1,
        5
      ],
      [
        10,
        2,
        6
      ],
      [
        11,
        3,
        7
      ],
      [
        12,
        4,
        8
      ]
    ]
  },
  "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.