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

Panchang mensal

Uma linha por dia do calendário para um mês gregoriano inteiro — a grade impressa nos calendários de parede de panchang. Cada dia traz o nascer do sol, o pôr do sol, o nascer da lua e o pôr da lua, o dia da semana em sânscrito, o mês lunar nas duas contagens, os anos Vikram e Shaka com os nomes do ciclo de sessenta anos, e o tithi, o signo lunar e o nakshatra da Lua vigentes no nascer do sol daquele dia. Como um tithi ou um nakshatra costuma mudar no meio do dia, cada um desses três traz um exit_time: o instante exato em que dá lugar ao seguinte, ou null se durar além do nascer do sol seguinte. É isso que permite renderizar os conhecidos rótulos no estilo 'Vrishchika 01:08+'. Passe ano, mês, latitude, longitude e deslocamento UTC. moon_option define qual contagem o campo lunar_month de cada linha segue, 'purnimanta' (o padrão) ou 'amanta'; amanta_month e purnimanta_month vêm em todas as linhas de qualquer forma, então você pode trocar a apresentação sem uma segunda chamada. A resposta é {year, month, days}, com uma entrada por dia daquele mês.

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

Testar requisição

Dados de Panchang mensal 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
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.
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.
month	integer	obrigatório	Mês de nascimento como número, 1-12. Janeiro é 1. min 1 · max 12
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.
year	integer	obrigatório	Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400
moon_option	string	opcional	`purnimantaamanta`

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/monthly_panchang/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"latitude":26.9124,"longitude":75.7873,"month":9,"timezone_as_float":5.5,"year":2026,"moon_option":"purnimanta"}'

Resposta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2026, \"month\": 9, \"days\": [{\"date\": \"2026-09-01\", \"vaara\": \"Mangalavara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-01T06:09:56+05:30\", \"sunset\": \"2026-09-01T18:43:30+05:30\", \"moonrise\": \"2026-09-01T21:09:00+05:30\", \"moonset\": \"2026-09-01T09:53:10+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Chaturthi\", \"exit_time\": \"2026-09-01T07:42:57+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Ashwini\", \"exit_time\": \"2026-09-02T02:42:25+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-02\", \"vaara\": \"Budhavara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-02T06:10:22+05:30\", \"sunset\": \"2026-09-02T18:42:26+05:30\", \"moonrise\": \"2026-09-02T21:50:26+05:30\", \"moonset\": \"2026-09-02T10:57:09+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Panchami\", \"exit_time\": \"2026-09-02T06:13:35+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Bharani\", \"exit_time\": \"2026-09-03T01:43:16+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-03\", \"vaara\": \"Guruvara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-03T06:10:48+05:30\", \"sunset\": \"2026-09-03T18:41:21+05:30\", \"moonrise\": \"2026-09-03T22:38:43+05:30\", \"moonset\": \"2026-09-03T12:03:39+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Saptami\", \"exit_time\": \"2026-09-04T02:26:25+05:30\"}, \"moon_rashi\": {\"name\": \"Mesha\", \"exit_time\": \"2026-09-03T07:26:05+05:30\"}, \"moon_nakshatra\": {\"name\": \"Krittika\", \"exit_time\": \"2026-09-04T00:29:36+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-04\", \"vaara\": \"Shukravara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-04T06:11:14+05:30\", \"sunset\": \"2026-09-04T18:40:15+05:30\", \"moonrise\": \"2026-09-04T23:34:48+05:30\", \"moonset\": \"2026-09-04T13:10:53+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Ashtami\", \"exit_time\": \"2026-09-05T00:14:34+05:30\"}, \"moon_rashi\": {\"name\": \"Vrishabha\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Rohini\", \"exit_time\": \"2026-09-04T23:04:27+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-05\", \"vaara\": \"Shanivara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-05T06:11:40+05:30\", \"sunset\": \"2026-09-05T18:39:09+05:30\", \"moonrise\": \"2026-09-06T00:38:03+05:30\", \"moonset\": \"2026-09-05T14:15:49+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Navami\", \"exit_time\": \"2026-09-05T21:54:40+05:30\"}, \"moon_rashi\": {\"name\": \"Vrishabha\", \"exit_time\": \"2026-09-05T10:18:34+05:30\"}, \"moon_nakshatra\": {\"name\": \"Mrigasira\", \"exit_time\": \"2026-09-05T21:31:03+05:30\"}, \"sun_rashi\": \"Simha\"}, {\"date\": \"2026-09-06\", \"vaara\": \"Ravivara\", \"lunar_month\": \"Bhadrapada\", \"amanta_month\": \"Shravana\", \"purnimanta_month\": \"Bhadrapada\", \"vikram_samvat\": 2083, \"vikram_samvatsara\": \"Siddharthi\", \"shaka_samvat\": 1948, \"shaka_samvatsara\": \"Paraabhava\", \"sunrise\": \"2026-09-06T06:12:06+05:30\", \"sunset\": \"2026-09-06T18:38:03+05:30\", \"moonrise\": \"2026-09-07T01:45:53+05:30\", \"moonset\": \"2026-09-06T15:15:16+05:30\", \"tithi\": {\"paksha\": \"Krishna\", \"name\": \"Dashami\", \"exit_time\": \"2026-09-06T19:30:12+05:30\"}, \"moon_rashi\": {\"name\": \"Mithuna\", \"exit_time\": null}, \"moon_nakshatra\": {\"name\": \"Aardra\", \"exit_time\": \"2026-09-06T19:52:"
}

Capturada de uma chamada real, com exatamente a requisição acima. Os resultados ficam em data.

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.