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

Cúspides das casas

As doze divisões de casas para um momento e um local, no sistema de casas que você indicar. A prática védica costuma usar os signos inteiros como casas, mas este endpoint oferece todos os sistemas das efemérides — Placidus, Koch, Campanus, Regiomontanus, Sripati, Porfírio, casas iguais e de signo inteiro, entre duas dezenas —, para que você levante o mesmo mapa no sistema que uma dada tradição espera. As posições são siderais. O ponto a não confundir é cúspide versus intervalo. A cúspide é o grau único que o sistema atribui a uma casa; o intervalo é a extensão que a casa de fato ocupa, calculada aqui pelos pontos médios entre cúspides vizinhas, de modo que uma casa vai da metade do caminho de volta à cúspide anterior até a metade do caminho rumo à próxima. `house_cusps` traz as doze cúspides, `house_starts` e `house_ends` as duas bordas, `house_ranges` as duas bordas juntas e `houses` os três de uma vez. `notation` define as unidades de toda a resposta: 'degree' para graus decimais brutos ao longo da eclíptica, 'astrological' para signo mais graus, minutos e segundos. `method_name` diferencia maiúsculas de minúsculas, e vários valores contêm espaços ou pontuação, então copie-os exatamente. O sistema já é aplicado a partir de `method_name` quando a requisição é montada; por isso, `set_house_method` e `change_house_system` só servem para trocar de sistema no meio de uma chamada com várias chaves.

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

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. `set_house_methodhouseshouse_rangeshouse_startshouse_cuspshouse_endschange_house_system` Array de strings. 'set_house_method' e 'change_house_system' consomem `method_name`; as outras cinco consomem `notation`.
method_name	string	obrigatório	`equalalcabitiuscampanusequal (mc)carter poli-equ.gauquelin sectorshorizon/azimutsunshinesavard-akochpullen sdmorinus` Diferencia maiúsculas de minúsculas; em minúsculas. Vários valores contêm espaços, barras ou pontuação - copie-os exatamente, por exemplo 'equal (mc)', 'carter poli-equ.', 'horizon/azimut'.
notation	string	obrigatório	`astrologicaldegree` Diferencia maiúsculas de minúsculas; em minúsculas. 'degree' retorna graus decimais brutos; 'astrological' retorna signo + g/m/s. Qualquer outro valor retorna 400.
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
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

Chaves disponíveis (7)

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
change_house_system	method_name	A mesma operação de `set_house_method`: muda para o sistema indicado em `method_name` e retorna null. As duas chaves chamam o mesmo código e não há diferença entre elas.
house_cusps	notation	As doze cúspides das casas conforme definidas pelo sistema de casas escolhido, como uma lista plana na ordem das casas. São os próprios graus das cúspides, não os limites das casas — os limites estão em `house_starts` e `house_ends` e ficam a meio caminho entre cúspides consecutivas.
house_ends	notation	Apenas a borda final de cada casa, como uma lista plana de doze valores na ordem das casas. Cada um é o ponto médio entre a cúspide dessa casa e a seguinte, então o fim da casa n é igual ao início da casa n+1.
house_ranges	notation	A extensão que cada casa ocupa, como um objeto com chaves de '1' a '12', com `start` e `end` para cada uma. As bordas são os pontos médios entre cúspides vizinhas, de modo que uma casa começa na metade do caminho de volta à cúspide anterior e termina na metade do caminho rumo à próxima. Na notação 'degree' os valores são graus decimais; em 'astrological' são objetos de signo, graus, minutos e segundos.
house_starts	notation	Apenas a borda inicial de cada casa, como uma lista plana de doze valores na ordem das casas — não um objeto indexado pelo número da casa, como o que `house_ranges` retorna. Graus decimais na notação 'degree', objetos de signo e g/m/s em 'astrological'.
houses	notation	Doze casas com chaves de `1` a `12`, cada uma `{start, cusp, end}` - os dois limites mais a cúspide entre eles. Observe que o formato difere da chave `houses` em /api/astro/krishnamurti/, que retorna `{start, mid, end}` e não tem cúspide. `notation` controla as unidades: `degree` fornece floats, `astrological` fornece strings como `"Aries 12 30 15"`.
set_house_method	method_name	Recalcula as cúspides no sistema de casas indicado em `method_name`. É um seletor, e não um valor — retorna null e só afeta as chaves listadas depois dele no array. O sistema já é aplicado a partir de `method_name` quando a requisição é montada, então esta chave é redundante, a menos que você troque de sistema no meio da chamada.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/house/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["set_house_method"],"latitude":26.9124,"longitude":26.1046,"timezone_as_float":5.5,"method_name":"equal","notation":"astrological","date_time":"2024-11-18"}'

Resposta

{
  "data": {
    "set_house_method": null
  },
  "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.