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

Panchanga

O panchanga é o almanaque hindu para um momento em um local: cinco 'membros' — tithi, vaara, nakshatra, yoga e karana — e tudo o mais que um panchang impresso traz. É o maior endpoint da API, com cinquenta e sete chaves, e a maioria dos clientes usa só algumas. Comece com tithi, vaara, nakshatra_segments, yogam e karana para os cinco membros, e com day_length, night_length, midday e midnight para a estrutura do dia. As chaves *_segments — tithi_segments, karana_segments, yoga_segments, nakshatra_segments — diferem das equivalentes no singular de um jeito que costuma causar erro: a chave no singular responde 'o que está em vigor neste instante', enquanto a chave de segmentos lista todos os períodos que coincidem com o dia inteiro do calendário local, com horários exatos de início e fim, que é o que uma página de calendário precisa. O restante se divide em grupos. Divisões do tempo: choghadiya e gauri_choghadiya em oitavos, hora em horas planetárias, do_ghati nos trinta muhurtas, trikalam em terços. Janelas nomeadas: abhijit_muhurta, brahma_muhurta, vijaya_muhurta, nishita_muhurta, godhuli_muhurta, amrit_kalam e os dois sandhyas, de um lado, e rahu_kaalam, yamaganda_kaalam, gulika_kaalam e durmuhurata, do outro. Calendário: lunar_month e lunar_month_poornima (o mesmo mês nas duas contagens), shaka_samvat, vikram_samvat, kali_samvat, samvatsara_name, ritu, sankranti_dates e tamil_solar_month_date. Posições, e não horários: upagraha_longitudes, special_longitudes, lagnas, sree_lagna e as duas variantes de bhaava_madhya. Vereditos sobre a qualidade do dia: tarabala, chandrabalam, panchaka_rahita, disha_shool, agni_vasa_segments, shiva_vasa_segments, yogas e shunya_nakshatra. Toda chamada requer date_time e timezone_as_float, e tudo o que depende do nascer do sol também requer latitude e longitude. Vários campos opcionais mudam a resposta, e não só a formatação: samvata_type é exigido por samvatsara_name, mode define como ritu é obtido, e gulika_rises_at, mandi_rises_at, gulika_portion, mandi_portion, kala_mrityu_rise_at e dhuma_vyatipata_relation escolhem entre convenções clássicas concorrentes para as posições dos upagrahas. Uma chamada custa um crédito, não importa quantas chaves você peça, então solicite de uma vez tudo o que uma página inteira precisa.

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

Testar requisição

Dados de Panchanga exibidos numa interface — Os dados deste endpoint exibidos numa interface real. A API entrega os valores; o layout é você quem monta.

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.
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.
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
dhuma_vyatipata_relation	string	opcional	`360_minus_dhumadhuma_plus_53_20` Padrão: '360_minus_dhuma'. Encaminhado em.
eccentric_anomaly	number (double)	opcional
eccentricity	number (double)	opcional
gulika_portion	string	opcional	`saturneighth` Padrão: 'saturn'. Encaminhado em.
gulika_rises_at	string	opcional	`beginningmiddleend` Padrão: 'beginning'. Encaminhado ao objeto Panchanga do motor em.
kala_mrityu_rise_at	string	opcional	`beginningmiddleend` Padrão: 'middle'. Encaminhado em.
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
mandi_portion	string	opcional	`saturneighth` Padrão: 'saturn'. Encaminhado em.
mandi_rises_at	string	opcional	`beginningmiddleend` Padrão: 'middle'. Encaminhado em.
mean_anomaly	number (double)	opcional
mode	string	opcional	`vedicdrik` Usado apenas pela chave 'ritu'. 'vedic' deriva a estação do mês lunar; 'drik', do signo tropical do Sol. O padrão do motor é 'drik'. ATENÇÃO: a função não lança exceção diante de um valor inválido - qualquer outra string passa silenciosamente pelos dois ramos e a chave retorna null (o exemplo publicado no catálogo chega a enviar mode=0 e recebe um 200 com resultado null).
nakshatras	string	opcional	`special` No motor, o único valor com significado é a string literal 'special', que troca a tabela `nakshatras` de 27 entradas pela tabela `nakshatras_special` de 28 entradas, que inclui Abhijit e usa grafias modernas. Como o valor nunca é repassado, a chave 'yogas' deste endpoint hoje retorna 500 com "'Panchanga' object has no attribute 'nakshatras'".
samvata_type	string	opcional	`shakavikram` Usado apenas pela chave 'samvatsara_name'.
tolerance	number (double)	opcional

Chaves disponíveis (57)

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
abhijit_muhurta	—	Abhijit: o oitavo dos quinze muhurtas diurnos, que cobre o ponto médio do período diurno — a janela auspiciosa de uso geral. Retorna {start, end}.
agni_vasa_segments	—	Onde se diz que Agni, a divindade do fogo, reside — a verificação feita antes de um homa, derivada do tithi e do dia da semana e que, portanto, muda quando o tithi muda. Retorna uma lista de {state, is_patala, start_time, end_time}, uma entrada por segmento de tithi do dia, em que state é 'Prithvi (Earth)', 'Akasha (Heaven)' ou 'Patala (Nadir)'. Homas feitos com um objetivo específico devem ser realizados enquanto Agni está em Prithvi; is_patala sinaliza o estado que alguns panchangs chamam de Bhadravasa.
amrit_kalam	—	Os períodos do Gowri Panchangam do tipo Amrit que coincidem com o dia — as linhas mais favoráveis dessa tabela. Retorna uma lista de {start, end}, normalmente dois, um de dia e outro à noite. Vem das mesmas tabelas por dia da semana que gauri_choghadiya e não tem relação com o Amrita Gadiya baseado em nakshatras de alguns outros panchangs.
bhaava_madhya_sripati	—	As doze cúspides no mesmo formato {degree, sign, minutes, seconds, nakshatra, pada} de bhaava_madhya_swe. Embora o sistema Sripati seja, na tradição clássica, uma divisão por quadrantes, esta implementação toma dele apenas o ascendente e depois soma trinta graus repetidamente; assim, para um dado momento, retorna os mesmos doze valores que bhaava_madhya_swe.
bhaava_madhya_swe	—	As doze cúspides das casas no sistema de casas iguais, no zodíaco sideral, começando pela primeira casa. Retorna uma lista de doze objetos, cada um {degree, sign, minutes, seconds, nakshatra, pada}, sendo sign uma abreviação de duas letras, como 'Ar' ou 'Cp'.
brahma_muhurta	—	Brahma Muhurta: os dois últimos muhurtas da noite antes do nascer do sol, cada um com a décima quinta parte da duração da noite — o momento tradicional para estudo, oração e meditação. Retorna {start, end}.
calcualte_special_tithi	—	O tithi com seus nomes especiais clássicos: o mesmo objeto da chave tithi, mais um campo special_name com uma string separada por vírgulas de todos os rótulos em que o tithi do dia se enquadra, ou null quando não há nenhum. Na prática, os rótulos que de fato aparecem são os que dependem de o tithi estar em vigor no nascer do sol ou ao meio-dia (Udayayvapini, Madhyanaha) e os específicos de Amavasya (Sinivaali, Vriddhigami); muitas entradas da tabela subjacente são indexadas por nomes de tithi em telugu que o próprio cálculo de tithi deste endpoint não produz, então nunca há correspondência. Observe que o nome da chave é grafado com a transposição mostrada.
chandrabalam	—	Chandra Bala: quais dos signos ascendentes do dia estão bem posicionados em relação ao signo atual da Lua e, portanto, são favoráveis para começar algo. Retorna uma lista de nomes de signos na ordem de Áries a Peixes, normalmente seis dos doze, extraídos das janelas udaya_lagna_muhurta que começam antes do próximo nascer do sol.
choghadiya	—	Os períodos do Choghadiya: o período diurno e a noite, cada um dividido em oito partes iguais, nomeadas segundo uma rotação que começa pelo Choghadiya próprio do dia da semana. Retorna {day_choghadiyas, night_choghadiyas, current_choghadiya, day_periods, night_periods}. As duas listas de nomes têm oito entradas cada — o ciclo de sete nomes rotacionado para começar pelo nome inicial do dia, com esse nome repetido no final —; day_periods e night_periods trazem os mesmos oito como {name, start, end}, e current_choghadiya é o nome que cobre o instante solicitado.
day_length	—	A diferença entre o pôr e o nascer do sol no dia em que cai o momento solicitado, como duração em segundos. Vem como uma STRING JSON, não como número - "48927.0" -, então converta antes de fazer contas. A maioria dos valores deste endpoint baseados na divisão do dia — choghadiya, hora, rahu_kaalam, os muhurtas diurnos — são oitavos, doze avos ou quinze avos deste número.
disha_shool	—	A direção para a qual não se deve viajar hoje, que depende apenas do dia da semana. Uma única string: East, South, West, North ou uma das quatro direções intermediárias.
do_ghati	—	A tabela completa dos trinta muhurtas — quinze entre o nascer e o pôr do sol e quinze entre o pôr do sol e o nascer do sol seguinte. Retorna {day_muhurtas, night_muhurtas, current}. Cada muhurta é {index, number, muhurta, auspicious, name, division, special, start, end}: muhurta é a divindade regente, number é sua posição (1-30) ao longo de todo o dia e de toda a noite, name é o nakshatra associado, division é a parte do dia (Pratah, Sangava, Madhyahna e assim por diante), auspicious é um booleano e special sinaliza as janelas nomeadas, como Abhijit. current é a entrada que contém o instante solicitado, ou null.
durmuhurata	—	Durmuhurta: as janelas curtas e desfavoráveis do dia, uma ou duas. Retorna {first, second, interval}, em que first e second são timestamps ISO e second é null nos dias da semana que têm apenas uma. `interval` é a duração de cada uma em segundos e, como as outras durações aqui, é uma STRING JSON - "2880.0" para os 48 minutos habituais. Observe que os deslocamentos em relação ao nascer do sol são horas fixas de relógio lidas de uma tabela por dia da semana, não divisões proporcionais da duração do dia.
eccentric_anomaly	mean_anomaly, eccentricity, tolerance	Um auxiliar genérico de mecânica orbital, e não uma grandeza astrológica: resolve a equação de Kepler por iteração de Newton. Recebe mean_anomaly em graus, eccentricity e, opcionalmente, tolerance (padrão 1e-6), e retorna um único número em graus.
gauri_choghadiya	—	Gowri Panchangam, a divisão óctupla sul-indiana usada na prática tâmil: oito períodos diurnos e oito noturnos, cada um equivalente a um oitavo do período diurno ou da noite, cada um com nome e marcado como bom ou ruim segundo uma tabela indexada por dia da semana. Retorna {day_gowri, night_gowri}, cada um uma lista de oito {name, status, start, end}, em que status é 'Good' ou 'Bad'.
godhuli_muhurta	—	Godhuli, a hora da poeira das vacas, em torno do pôr do sol: de um quarto de muhurta diurno antes do pôr do sol até um quarto de muhurta noturno depois dele. Retorna {start, end}.
gulika_kaalam	—	Gulika Kaalam, também chamado Kulika: a oitava parte do período diurno atribuída à sombra de Saturno. Ao contrário dos outros dois, é considerado favorável para coisas que devem durar ou se repetir. Retorna {gulika_start, gulika_end}. Não confunda com a entrada 'gulika' em special_longitudes, que é uma posição no zodíaco, e não uma janela de tempo.
hora	—	As vinte e quatro horas planetárias: doze divisões iguais do período diurno e doze da noite, cada uma regida por um planeta na ordem clássica, a partir do próprio senhor do dia da semana. Retorna {day_horas, night_horas}, cada um com uma lista de doze {planet, start, end}. As horas diurnas e noturnas têm durações diferentes, exceto nos equinócios.
kali_samvat	—	O ano do Kali Yuga: shaka_samvat mais 3179; muda no Chaitra Shukla Pratipada. Um único inteiro.
karana	—	O karana em vigor no instante solicitado — metade de um tithi, seis graus da elongação Lua menos Sol. Retorna um de onze nomes: os sete móveis, Bava, Balava, Kaulava, Taitula, Garaja, Vanija e Vishti, e os quatro fixos, Kimstughna, Shakuni, Chatushpada e Naga. Vishti, em geral chamado Bhadra, é o que se evita.
karana_segments	—	Todos os períodos de karana que se sobrepõem ao dia do calendário local, como uma lista de {name, start_time, end_time} em ordem. Um karana dura de onze a treze horas, então conte com duas ou três entradas por dia.
lagnas	—	Cinco ascendentes especiais que avançam mais rápido que o signo ascendente, todos medidos a partir do nascer do sol. Retorna um objeto com 'Bhava Lagna' (um signo a cada duas horas), 'Hora Lagna' (um signo por hora, usado para avaliar ganhos), 'Ghati Lagna' (um signo a cada vinte e quatro minutos, usado para avaliar status e autoridade), 'Indu Lagna' (o ponto de riqueza calculado com os senhores da nona casa contada a partir do ascendente e a partir da Lua) e 'Bhrigu Lagna' (o ponto médio Lua-Rahu, geralmente chamado Bhrigu Bindu), cada um no formato {degree, sign, minutes, seconds, nakshatra, pada}.
lunar_month	—	O mês lunar amanta que contém a data solicitada — de lua nova a lua nova —, nomeado pelo signo da Lua na lua nova que o iniciou. Uma única string entre as doze, de Vaisakha a Chaitra. Os meses adhika (intercalares) não são sinalizados separadamente.
lunar_month_poornima	—	O mesmo mês pela contagem purnimanta, que vai de uma lua cheia à seguinte e é nomeado pelo signo do Sol na lua cheia que o abre. Uma única string. Os calendários do norte da Índia usam esta contagem e, durante a quinzena escura, ela dá ao mês um nome diferente do de lunar_month para o mesmo dia.
lunar_phase	—	A elongação entre o Sol e a Lua e a quinzena que ela indica. Retorna {paksha, moon_phase}, em que moon_phase é o ângulo em graus, de 0 a 360, e paksha é 'Shukla' abaixo de 180 e 'Krishna' de 180 em diante.
midday	—	Meio-dia aparente local — o momento em que o Sol cruza o meridiano superior no local informado, que fica a alguns minutos, para mais ou para menos, do meio-dia do relógio. Um único timestamp no deslocamento passado em timezone_as_float.
midnight	—	O trânsito do Sol pelo meridiano inferior, ou seja, a meia-noite local verdadeira. Um único timestamp no deslocamento solicitado. Não é o mesmo que o ponto médio da noite entre o pôr e o nascer do sol, em torno do qual nishita_muhurta é construído.
nakshatra_segments	—	Todos os nakshatras da Lua que se sobrepõem ao dia do calendário local, como uma lista de {name, start_time, end_time}. Os limites são os cruzamentos exatos da longitude da Lua, encontrados por bisseção. Os nomes usam as grafias modernas — Shatabhisha, Purva Bhadrapada — em vez das transliterações mais antigas usadas por alguns outros endpoints desta API.
night_length	—	Do pôr do sol ao nascer do sol seguinte, como uma duração em segundos e, assim como day_length, retornado como uma STRING JSON em vez de número - "37464.0". É a contraparte de day_length e a base das metades noturnas de choghadiya, hora e do_ghati, bem como de brahma_muhurta e nishita_muhurta.
nishita_muhurta	—	Nishita, um ghati de cada lado do ponto médio da noite entre o pôr do sol e o nascer do sol seguinte, sendo um ghati, aqui, um trigésimo da duração da noite. Retorna {start, end}. O meio da noite não é o mesmo instante que a meia-noite.
panchaka_rahita	—	O dia dividido em janelas, cada uma com o rótulo do panchaka em que cai, segundo a regra clássica (tithi + nakshatra + dia da semana + signo ascendente) mod 9. Retorna uma lista de {panchaka, start, end} do nascer do sol ao nascer do sol seguinte, em que panchaka é null para uma janela limpa e, caso contrário, um de 'Mrityu Panchaka', 'Agni Panchaka', 'Raja Panchaka', 'Chora Panchaka' ou 'Roga Panchaka'. As janelas se dividem a cada mudança de signo ascendente e a cada mudança de tithi ou nakshatra no meio delas, então o normal é haver cerca de catorze entradas.
pratah_sandhya	—	A janela de observância do crepúsculo matutino: de dois ghatis antes do nascer do sol até um depois, sendo um ghati, aqui, um trigésimo da duração do dia. Retorna {start, end}.
rahu_kaalam	—	Rahu Kaalam: a oitava parte do período diurno considerada imprópria para iniciar qualquer coisa, com sua posição dentro do dia fixada pelo dia da semana. Retorna {rahu_start, rahu_end}, separados por um oitavo de day_length.
ritu	mode	A estação do ano. mode seleciona o método: 'drik' a obtém do signo tropical do Sol, 'vedic' do mês lunar. Retorna {ritu, season, lord}, por exemplo {'Vasanta', 'Spring', 'Venus'}. O padrão do motor é 'drik', e qualquer valor diferente desses dois retorna null silenciosamente em vez de gerar um erro.
samvatsara_name	samvata_type	O nome do ano no ciclo joviano de sessenta anos, de Prabhava a Kshaya. Requer samvata_type: 'vikram' dá o nome usado no norte da Índia (o samvatsara de Júpiter médio vigente no Mesha sankranti do ano), e 'shaka', o nome usado no sul, vinculado ao ano lunar; por isso, os dois podem diferir. Retorna uma única string e gera erro se samvata_type for omitido.
sankranti_dates	—	Os ingressos do Sol nos signos imediatamente antes e depois do momento solicitado — os limites do mês solar em que você está. Retorna {'Previous Sankranti', 'Next Sankranti'} como timestamps no deslocamento solicitado.
sayahna_sandhya	—	A janela de observância do crepúsculo vespertino: de um ghati antes do pôr do sol até dois depois, novamente com ghatis baseados na duração do dia. Retorna {start, end}.
shaka_samvat	—	O ano da era Shaka. Muda no Chaitra Shukla Pratipada: de janeiro até essa data, é o ano gregoriano menos 79; depois dela, o ano gregoriano menos 78. Um único inteiro.
shiva_vasa_segments	—	Onde Shiva reside, a verificação equivalente antes de um Rudrabhisheka, derivada apenas do tithi. Retorna uma lista de {state, start_time, end_time}, uma por segmento de tithi do dia; state é um de sete — with Gowri, in Kailasha, on Vrishabha (Nandi), at Bhojanam, in Sabha, at Work/Play ou in Shmashana —, dos quais os três primeiros são os favoráveis.
shunya_nakshatra	—	Se a Lua ocupa no momento um dos dois ou três nakshatras considerados vazios para o mês lunar amanta em curso, nos quais se evitam novos empreendimentos. Retorna a string 'shunya_nakshatra' quando isso acontece e null caso contrário — uma flag, sem nome nem janela na resposta.
special_longitudes	—	Os seis upagrahas derivados do tempo. O período diurno ou a noite é dividido em oito partes planetárias, e o signo ascendente é tomado em um ponto escolhido dentro de uma parte específica. Retorna um objeto com as chaves 'kaala', 'mrityu', 'artha_praharaka', 'yama_ghantaka', 'maandi' e 'gulika', cada uma {degree, sign, minutes, seconds, nakshatra, pada}. Kaala usa a parte do Sol, Mrityu a parte de Marte, Artha Praharaka e Yama Ghantaka os pontos médios das partes de Mercúrio e Júpiter, e Gulika e Maandi a parte de Saturno — é por isso que os campos da requisição kala_mrityu_rise_at, gulika_rises_at e mandi_rises_at importam: escolher o início, o meio ou o fim da parte é o que distingue Gulika de Maandi.
sree_lagna	—	Sree Lagna, o ponto de prosperidade: o ascendente avançado pela fração do seu nakshatra que a Lua já percorreu, aplicando-se essa fração ao zodíaco inteiro. Retorna um {degree, sign, minutes, seconds, nakshatra, pada}.
tamil_solar_month_date	—	A data do calendário solar tâmil. Retorna {'Tamil Solar Month', 'Tamil Solar Date'} — o nome do mês, de Chithirai a Panguni, e o dia como inteiro. Esta implementação conta os dias a partir de um ano-novo fixo em 14 de abril, em blocos de trinta dias, em vez de a partir dos instantes reais de sankranti, então pode diferir em um ou dois dias de um panchangam tâmil publicado.
tarabala	—	Tara Bala: quais dos vinte e sete nakshatras de nascimento estão favoravelmente posicionados em relação ao nakshatra da Lua em trânsito. Retorna {good_nakshatras, valid_until, good_nakshatras_tier2, tier2_valid_until}. A primeira lista contém quinze nomes e vale até a Lua sair do nakshatra atual, em valid_until; o par tier2 aplica a mesma regra ao nakshatra seguinte e vale até o próximo nascer do sol. Os dois campos tier2 são null quando a Lua não muda de nakshatra ao longo do dia.
tithi	—	O dia lunar no instante solicitado: {paksha, name, number, start_time, end_time, remaining_time}. number é 1-15 para Shukla, 16-29 para Krishna e 30 para Amavasya, e remaining_time é {hours, minutes, seconds} até o fim do tithi. Na lua cheia e na lua nova, o campo paksha traz 'Purnima' ou 'Amavasya' em vez do nome da quinzena. Para todos os tithis que coincidem com o dia, use tithi_segments.
tithi_segments	—	Todos os tithis que se sobrepõem ao dia do calendário local, como uma lista de {paksha, name, number, start_time, end_time}. number é 1-15 na quinzena clara, 16-29 na escura e 30 para Amavasya. Observe que, na lua cheia e na lua nova, o campo paksha traz 'Purnima' ou 'Amavasya' em vez de 'Shukla' ou 'Krishna'. Um tithi dura em média 23.6 horas, então a maioria dos dias retorna uma entrada e alguns, duas.
trikalam	—	O período diurno dividido em três partes iguais. Retorna {morning, afternoon, evening}, cada um {start, end}. É uma simples divisão do dia em terços, não o trio Rahu/Yamaganda/Gulika que a palavra designa em alguns panchangams tâmeis.
true_anomaly	eccentric_anomaly, eccentricity	O conversor complementar: recebe eccentric_anomaly em graus e eccentricity e retorna a anomalia verdadeira em graus, como um único número. Observe que ele lê a anomalia excêntrica do campo da requisição com esse nome — não encadeia o resultado da chave eccentric_anomaly na mesma chamada.
udaya_lagna_muhurta	—	As doze janelas consecutivas de signo ascendente que cobrem o dia, a partir do signo que já está ascendendo pouco antes do nascer do sol. Retorna uma lista de doze {rashi, start, end} em ordem, abrangendo aproximadamente um dia sideral — cerca de quatro minutos a menos que o intervalo de um nascer do sol ao seguinte. chandrabalam e panchaka_rahita são calculados a partir desta lista.
upagraha_longitudes	—	Os cinco pontos de sombra derivados aritmeticamente da longitude sideral do Sol, cada um decorrente do anterior: Dhuma no Sol mais 133°20', depois Vyatipata, Parivesha, Indrachapa e Upaketu. Retorna um objeto com as chaves 'Dhuma', 'Vyatipata', 'Parivesha', 'Indrachapa' e 'Upaketu', cada uma {degree, sign, minutes, seconds, nakshatra, pada}. O campo dhuma_vyatipata_relation escolhe qual das duas fórmulas clássicas liga Vyatipata a Dhuma e, com isso, desloca todos os quatro pontos que vêm depois dele.
vaara	—	O dia da semana, nomeado a partir do nascer do sol e não da meia-noite, de modo que um momento entre a meia-noite e o nascer do sol ainda pertence ao vaara anterior. Uma única string: Ravivara, Somavara, Mangalavara, Budhavara, Guruvara, Shukravara ou Shanivara.
vijaya_muhurta	—	Vijaya Muhurta, o 11º dos quinze muhurtas iguais entre o nascer e o pôr do sol, à tarde — a janela para tudo o que precisa dar certo apesar de oposição. Retorna {start, end}.
vikram_samvat	—	O ano Vikram Samvat. Muda no Chaitra Shukla Pratipada: de janeiro até essa data, é o ano gregoriano mais 56; depois dela, o ano gregoriano mais 57. Um único inteiro.
yamaganda_kaalam	—	Yamaganda Kaalam, uma segunda oitava parte inauspiciosa do período diurno, determinada pelo dia da semana. Retorna {yamaganda_start, yamaganda_end}.
yoga_segments	—	Todos os períodos de Nityayoga que se sobrepõem ao dia do calendário local, como uma lista de {name, start_time, end_time} em ordem. Um yoga dura em média cerca de 22.6 horas, então um dia costuma abranger dois. Os limites são os instantes exatos de cruzamento da soma das longitudes do Sol e da Lua, sem arredondamento para o dia.
yogam	—	O Nityayoga: as longitudes siderais do Sol e da Lua somadas e o total dividido em vinte e sete arcos iguais de 13°20'. Retorna um único nome, de Vishkambha a Vaidhriti, para o instante solicitado. Para os períodos antes e depois desse instante, use yoga_segments.
yogas	—	As combinações nomeadas de tithi, nakshatra e dia da semana em vigor — os 'yogas' auspiciosos e inauspiciosos que um panchang lista para o dia, como Sarvartha Siddhi, Amrit Siddhi, Dwipushkara, Tripushkara, Guru Pushya, Ravi Pushya, Panchaka, Dagdha, Yama Ghanta e dezenas de outros, vindos de cerca de vinte tabelas clássicas. Retorna {yogas: [...]}, uma lista de nomes que fica vazia quando nenhum se aplica. Não confunda com yogam, que é o Nityayoga único do momento.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-06-02T06:30:52.786Z","keys":["midday"],"latitude":26.849,"longitude":75.768,"timezone_as_float":5.5,"samvata_type":"shaka","mode":0,"mean_anomaly":0,"eccentricity":1,"tolerance":0.000001,"gulika_rises_at":"beginning","mandi_rises_at":"middle","kala_mrityu_rise_at":"middle","dhuma_vyatipata_relation":"360_minus_dhuma"}'

Resposta

{
  "data": {
    "midday": "2026-06-02T12:24:53+05:30"
  },
  "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.