/api/astro/pancha_pakshi_hora/1 créditoPancha Pakshi (atividade das aves por hora)
O Pancha Pakshi Shastra é um sistema tâmil que atribui a cada pessoa uma de cinco aves — abutre, coruja, corvo, galo ou pavão — a partir do nakshatra e da quinzena do seu nascimento, e então avalia cada momento do dia pelo que essa ave está fazendo. Cada ave passa por cinco atividades — reinar, comer, caminhar, dormir e morrer —, da mais favorável para a menos favorável, e cada parte do dia é boa ou ruim conforme a relação entre a atividade da sua ave e a que está em vigor no momento. Use get_birth_bird_from_nakshathra para obter a ave; get_birth_nakshathra e get_paksha retornam as duas entradas das quais ela é derivada, úteis se você quiser mostrar o cálculo. As três retornam inteiros simples, e não nomes. get_matching_pancha_pakshi_data_from_db retorna a tabela bruta de atividades dessa ave no dia da semana e na quinzena do momento consultado: cinquenta linhas numéricas que cobrem cinco períodos principais do dia e cinco da noite, cada um dividido em cinco subperíodos. As colunas são índices e frações, não horários do relógio — você mesmo monta os horários a partir do nascer do sol, do pôr do sol e dos fatores de duração. O campo nakshatras da requisição é aceito pelo serializador, mas não é usado por este endpoint.
https://api.occultapi.com/api/astro/pancha_pakshi_hora/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/jsonCampos 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. |
| 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_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 |
| nakshatras | string | opcional | specialPARÂMETRO MORTO na camada HTTP - PanchaPakshaHoraView passa apenas date_time, geopos e o caminho do CSV pancha_pakshi_db. No motor, o único valor significativo é o literal 'special' (troca para a tabela nakshatras_special, de 28 entradas. |
Chaves disponíveis (4)
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 |
|---|---|---|
| get_birth_bird_from_nakshathra | — | A ave de nascimento como um único inteiro de 1 a 5 — 1 abutre, 2 coruja, 3 corvo, 4 galo, 5 pavão —, derivada do nakshatra de nascimento junto com a quinzena, então o mesmo nakshatra dá aves diferentes nas duas metades do mês. |
| get_birth_nakshathra | — | O nakshatra de nascimento como um único inteiro de 1 a 27, contando a partir de Ashwini — a entrada de que as demais consultas deste endpoint precisam. Nenhum nome é retornado, apenas o número. |
| get_matching_pancha_pakshi_data_from_db | — | A tabela bruta de atividades da ave de nascimento no dia da semana e na quinzena do momento solicitado: cinquenta linhas, cada uma com uma lista de catorze números, nesta ordem de colunas: índice do dia da semana, índice do paksha, índice dia/noite, ave principal, atividade principal, ave secundária, atividade secundária, fator de duração, relação, fator de força, efeito, classificação, padu pakshi, bharana pakshi. As aves vão de 0-4, nesta ordem: abutre, coruja, corvo, galo, pavão; as atividades vão de 0-4, nesta ordem: reinar, comer, caminhar, dormir, morrer; a relação é 0 inimigo, 1 mesmo, 2 amigo; o efeito vai de 0 a 4, de muito ruim a muito bom. As linhas vêm em grupos de cinco — cinco períodos principais por metade do dia, cada um subdividido em cinco — e o fator de duração indica a fração do período principal ocupada por cada subperíodo. Nenhum horário do relógio é incluído; monte-os a partir do nascer do sol, do pôr do sol e dos fatores. |
| get_paksha | — | Em qual quinzena lunar o momento cai, como um único inteiro: 1 para Shukla (crescente), 2 para Krishna (minguante). O Pancha Pakshi atribui uma ave diferente ao mesmo nakshatra em cada quinzena, então este valor muda a resposta. |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/pancha_pakshi_hora/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01 06:00:00","keys":["get_birth_bird_from_nakshathra","get_birth_nakshathra","get_matching_pancha_pakshi_data_from_db"],"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"nakshatras":"special"}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"get_birth_bird_from_nakshathra\": 1, \"get_birth_nakshathra\": 27, \"get_matching_pancha_pakshi_data_from_db\": [[2.0, 1.0, 0.0, 0.0, 2.0, 0.0, 2.0, 0.208333333, 1.0, 0.36, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 2.0, 3.0, 1.0, 0.208333333, 0.0, 0.48, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 2.0, 1.0, 4.0, 0.25, 2.0, 0.12, 1.0, 2.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 2.0, 4.0, 3.0, 0.166666667, 2.0, 0.24, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 2.0, 2.0, 0.0, 0.166666667, 0.0, 0.6, 2.0, 5.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 0.0, 1.0, 0.208333333, 1.0, 0.64, 3.0, 6.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 3.0, 4.0, 0.25, 0.0, 0.16, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 1.0, 3.0, 0.166666667, 2.0, 0.32, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 4.0, 0.0, 0.166666667, 2.0, 0.8, 4.0, 9.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 1.0, 2.0, 2.0, 0.208333333, 0.0, 0.48, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 0.0, 4.0, 0.25, 1.0, 0.04, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 3.0, 3.0, 0.166666667, 0.0, 0.08, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 1.0, 0.0, 0.166666667, 2.0, 0.2, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 4.0, 2.0, 0.208333333, 2.0, 0.12, 1.0, 2.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 4.0, 2.0, 1.0, 0.208333333, 0.0, 0.16, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 0.0, 3.0, 0.166666667, 1.0, 0.16, 1.0, 2.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 3.0, 0.0, 0.166666667, 0.0, 0.4, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 1.0, 2.0, 0.208333333, 2.0, 0.24, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 4.0, 1.0, 0.208333333, 2.0, 0.32, 2.0, 4.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 3.0, 2.0, 4.0, 0.25, 0.0, 0.08, 0.0, 1.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.0, 0.166666667, 1.0, 1.0, 4.0, 10.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 3.0, 2.0, 0.208333333, 0.0, 0.6, 2.0, 5.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 1.0, 1.0, 0.208333333, 2.0, 0.8, 4.0, 9.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 4.0, 4.0, 0.25, 2.0, 0.2, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 0.0, 0.0, 0.0, 2.0, 3.0, 0.166666667, 0.0, 0.4, 2.0, 3.0, 0.0, 3.0], [2.0, 1.0, 1.0, 0.0, 1.0, 0.0, 1.0, 0.208333333, 1.0, 0.64, 3.0, 6.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 1.0, 4.0, 3.0, 0.125, 2.0, 0.32, 2.0, 4.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 1.0, 3.0, 2.0, 0.25, 0.0, 0.48, 2.0, 4.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 1.0, 2.0, 4.0, 0.083333333, 2.0, 0.16, 2.0, 3.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 1.0, 1.0, 0.0, 0.333333333, 0.0, 0.8, 3.0, 7.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 0.0, 3.0, 0.125, 1.0, 0.16, 1.0, 2.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 4.0, 2.0, 0.25, 2.0, 0.24, 2.0, 3.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 3.0, 4.0, 0.083333333, 0.0, 0.08, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 2.0, 0.0, 0.333333333, 2.0, 0.4, 2.0, 5.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 3.0, 1.0, 1.0, 0.208333333, 0.0, 0.32, 1.0, 2.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 0.0, 2.0, 0.25, 1.0, 0.36, 2.0, 4.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 4.0, 4.0, 0.083333333, 2.0, 0.12, 1.0, 2.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 3.0, 0.0, 0.333333333, 0.0, 0.6, 2.0, 5.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 2.0, 1.0, 0.208333333, 2.0, 0.48, 3.0, 6.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 2.0, 1.0, 3.0, 0.125, 0.0, 0.24, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 0.0, 4.0, 0.083333333, 1.0, 0.04, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 4.0, 0.0, 0.333333333, 2.0, 0.2, 2.0, 3.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 3.0, 1.0, 0.208333333, 0.0, 0.16, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 2.0, 3.0, 0.125, 2.0, 0.08, 1.0, 2.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 4.0, 1.0, 2.0, 0.25, 0.0, 0.12, 0.0, 1.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 0.0, 0.0, 0.333333333, 1.0, 1.0, 4.0, 10.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 4.0, 1.0, 0.208333333, 2.0, 0.8, 4.0, 9.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 3.0, 3.0, 0.125, 0.0, 0.4, 2.0, 3.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 2.0, 2.0, 0.25, 2.0, 0.6, 3.0, 7.0, 0.0, 0.0], [2.0, 1.0, 1.0, 0.0, 0.0, 1"
}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.