POST/api/astro/mundane-charts/1 crédito

Mapas de ingresso mundanos

Os mapas de ingresso usados para julgar um ano védico. O mapa do ascendente mundial levantado no ingresso solar, o mapa de Ardra pravesh lido para a monção e os mapas das safras de verão e de outono. Cada um traz o momento exato para o qual é levantado e um conjunto completo de posições planetárias naquele instante — é deles que de fato saem as previsões anuais dos almanaques. Uma resposta grande: quatro mapas completos mais um horário de ingresso.

https://api.occultapi.com/api/astro/mundane-charts/

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.
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
year	integer	obrigatório	Ano de nascimento como número, por exemplo 1990. Quatro dígitos.
keys	array	opcional	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.
nakshatra	string	opcional	Lido apenas por /nakshatra-chakras/; ignorado nos demais.

Exemplo de requisição

curl -X POST https://api.occultapi.com/api/astro/mundane-charts/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2025,"date_time":"2025-02-13T05:00:37Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Resposta

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2025, \"charts\": [{\"chart\": \"jagat_lagna_chart\", \"describes\": \"World ascendant chart, cast at the solar ingress\", \"result\": {\"ingress_time\": \"2025-04-13T21:51:25Z\", \"chart\": {\"celestial\": {\"sun\": {\"longitude\": {\"degree\": 0, \"sign\": \"Ar\", \"minutes\": 0, \"seconds\": 0}, \"latitude\": -0.0, \"nakshatra\": \"Ashwini\", \"pada\": 1, \"kakshya\": \"saturn\", \"zodiac_name\": \"Aries\", \"house\": 3}, \"moon\": {\"longitude\": {\"degree\": 9, \"sign\": \"Li\", \"minutes\": 42, \"seconds\": 32}, \"latitude\": -3.122, \"nakshatra\": \"Swaati\", \"pada\": 1, \"kakshya\": \"mars\", \"zodiac_name\": \"Libra\", \"house\": 9}, \"mercury\": {\"longitude\": {\"degree\": 4, \"sign\": \"Pi\", \"minutes\": 22, \"seconds\": 15}, \"latitude\": -1.443, \"nakshatra\": \"Uttaraabhaadra\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"venus\": {\"longitude\": {\"degree\": 0, \"sign\": \"Pi\", \"minutes\": 25, \"seconds\": 44}, \"latitude\": 4.46, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"mars\": {\"longitude\": {\"degree\": 4, \"sign\": \"Cn\", \"minutes\": 4, \"seconds\": 4}, \"latitude\": 2.355, \"nakshatra\": \"Pushyami\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Cancer\", \"house\": 6}, \"jupiter\": {\"longitude\": {\"degree\": 23, \"sign\": \"Ta\", \"minutes\": 55, \"seconds\": 8}, \"latitude\": -0.276, \"nakshatra\": \"Mrigasira\", \"pada\": 1, \"kakshya\": \"moon\", \"zodiac_name\": \"Taurus\", \"house\": 4}, \"saturn\": {\"longitude\": {\"degree\": 1, \"sign\": \"Pi\", \"minutes\": 47, \"seconds\": 31}, \"latitude\": -1.959, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"uranus\": {\"longitude\": {\"degree\": 1, \"sign\": \"Ta\", \"minutes\": 10, \"seconds\": 37}, \"latitude\": -0.219, \"nakshatra\": \"Krittika\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Taurus\", \"house\": 4}, \"neptune\": {\"longitude\": {\"degree\": 6, \"sign\": \"Pi\", \"minutes\": 19, \"seconds\": 1}, \"latitude\": -1.269, \"nakshatra\": \"Uttaraabhaadra\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"pluto\": {\"longitude\": {\"degree\": 9, \"sign\": \"Cp\", \"minutes\": 30, \"seconds\": 25}, \"latitude\": -3.489, \"nakshatra\": \"Uttaraashaadha\", \"pada\": 4, \"kakshya\": \"mars\", \"zodiac_name\": \"Capricorn\", \"house\": 12}, \"northtruenode\": {\"longitude\": {\"degree\": 3, \"sign\": \"Pi\", \"minutes\": 4, \"seconds\": 22}, \"latitude\": -0.0, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"northmeannode\": {\"longitude\": {\"degree\": 1, \"sign\": \"Pi\", \"minutes\": 50, \"seconds\": 16}, \"latitude\": 0.0, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"southtruenode\": {\"longitude\": {\"degree\": 3, \"sign\": \"Vi\", \"minutes\": 4, \"seconds\": 22}, \"latitude\": -0.0, \"nakshatra\": \"Uttara Phalguni\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Virgo\", \"house\": 8}, \"southmeannode\": {\"longitude\": {\"degree\": 1, \"sign\": \"Vi\", \"minutes\": 50, \"seconds\": 16}, \"latitude\": 0.0, \"nakshatra\": \"Uttara Phalguni\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Virgo\", \"house\": 8}}, \"houses\": {\"1\": {\"start\": \"18 Cp 10 4\", \"cusp\": \"3 Aq 10 4\", \"end\": \"18 Aq 10 4\"}, \"2\": {\"start\": \"18 Aq 10 4\", \"cusp\": \"3 Pi 10 4\", \"end\": \"18 Pi 10 4\"}, \"3\": {\"start\": \"18 Pi 10 4\", \"cusp\": \"3 Ar 10 4\", \"end\": \"18 Ar 10 4\"}, \"4\": {\"start\": \"18 Ar 10 4\", \"cusp\": \"3 Ta 10 4\", \"end\": \"18 Ta 10 4\"}, \"5\": {\"start\": \"18 Ta 10 4\", \"cusp\": \"3 Ge 10 4\", \"end\": \"18 Ge 10 4\"}, \"6\": {\"start\": \"18 Ge 10 4\", \"cusp\": \"3 Cn 10 4\", \"end\": \"18 Cn 10 4\"}, \"7\": {\"start\": \"18 Cn 10 4\", \"cusp\": \"3 Le 10 4\", \"end\": \"18 Le 10 4\"}, \"8\": {\"start\": \"18 Le 10 4\", \"cusp\": \"3 Vi 10 4\", \"end\": \"18 Vi 10 4\"}, \"9\": {\"start\": \"18 Vi 10 4\", \"cusp\": \"3 Li 10 4\", \"end\": \"18 Li 10 4\"}, \"10\": {\"start\": \"18 Li 10 4\", \"cusp\": \"3 Sc 10 4\", \"end\": \"18 Sc 10 4\"}, \"11\": {\"start\": \"18 Sc 10 4\", \"cusp\": \"3 Sg 10 4\", \"end\": \"18 Sg 10 4\"}, \"12\": {\"start\": \"18 Sg 10 4\", \"cusp\": \"3 Cp 10 4\", \"end\": \"18 Cp 10 4\"}}, \"ascendant\": {\"longitude\": {\"degree\": 3, \"sign\": \"Aq\", \"minutes\": 10, \"seconds\": 4}, \"zodia"
}

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.