/api/astro/dasha/vimshottari/1 créditoVimshottari dasha
O ciclo de 120 anos que serve de base para quase toda leitura védica. O Vimshottari parte do nakshatra que a Lua ocupava no nascimento, o que determina tanto o planeta cujo mahadasha estava em curso no nascimento quanto a parte dele que ainda restava. Depois, percorre os nove grahas ao longo de 120 anos, em ordem fixa e com durações fixas: Ketu 7, Vênus 20, Sol 6, Lua 10, Marte 7, Rahu 18, Júpiter 16, Saturno 19, Mercúrio 17. É retornado como uma linha do tempo aninhada — mahadasha, depois antardasha, depois pratyantardasha —, cada período com seu senhor e seu início e fim exatos. Ao contrário dos outros dashas nakshatra, o Vimshottari é incondicional: vale para todo mapa.
https://api.occultapi.com/api/astro/dasha/vimshottari/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 |
|---|---|---|---|
| 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 |
| dasha_direction | string | opcional | forwardbackward |
| dasha_start | string | opcional | Ciclo em que a linha do tempo começa. currentnextprevious |
| date_time | string (date-time) | opcional | 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. |
| datetime | string (date-time) | opcional | 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. Equivale a date_time, nome que outros endpoints usam para o mesmo valor. |
| days_in_year | number (double) | opcional | Duração do ano usada para medir os períodos. 360 para o ano savana clássico, 365.25 para o ano juliano. min 360 · max 365.256364 |
| levels | integer | opcional | Profundidade de aninhamento: 1 só mahadasha, 2 acrescenta antardasha, 3 acrescenta pratyantardasha. O limite é 4 porque a resposta cresce cerca de dez vezes a cada nível. min 1 · max 4 |
| node | string | opcional | Modelo do nodo lunar. Obrigatório no endpoint pai de rashi, que não define um padrão; aqui, há um padrão. truemean |
| timezone_as_float | number (double) | opcional | 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 |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/dasha/vimshottari/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"1990-08-15T10:30:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"levels":3}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"system\": \"Vimshottari\", \"engine_id\": \"VimshottariDasha\", \"family\": \"nakshatra\", \"lord_type\": \"planet\", \"levels\": 3, \"level_names\": [\"mahadasha\", \"antardasha\", \"pratyantardasha\"], \"cycle_years\": 120, \"conditional\": false, \"periods\": [{\"lord\": \"moon\", \"start\": \"1983-12-03 22:34:05.606114+00:00\", \"end\": \"1993-12-03 10:34:05.606114+00:00\", \"children\": [{\"lord\": \"moon\", \"start\": \"1983-12-03 22:34:05.606114+00:00\", \"end\": \"1984-10-03 06:34:05.606114+00:00\", \"children\": [{\"lord\": \"moon\", \"start\": \"1983-12-03 22:34:05.606114+00:00\", \"end\": \"1983-12-29 06:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mars\", \"start\": \"1983-12-29 06:34:05.606114+00:00\", \"end\": \"1984-01-16 00:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"rahu\", \"start\": \"1984-01-16 00:10:05.606114+00:00\", \"end\": \"1984-03-01 14:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"jupiter\", \"start\": \"1984-03-01 14:34:05.606114+00:00\", \"end\": \"1984-04-11 03:22:05.606114+00:00\", \"children\": []}, {\"lord\": \"saturn\", \"start\": \"1984-04-11 03:22:05.606114+00:00\", \"end\": \"1984-05-29 06:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"1984-05-29 06:34:05.606114+00:00\", \"end\": \"1984-07-11 08:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"ketu\", \"start\": \"1984-07-11 08:10:05.606114+00:00\", \"end\": \"1984-07-29 01:46:05.606114+00:00\", \"children\": []}, {\"lord\": \"venus\", \"start\": \"1984-07-29 01:46:05.606114+00:00\", \"end\": \"1984-09-17 17:46:05.606114+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"1984-09-17 17:46:05.606114+00:00\", \"end\": \"1984-10-02 22:34:05.606114+00:00\", \"children\": []}]}, {\"lord\": \"mars\", \"start\": \"1984-10-03 06:34:05.606114+00:00\", \"end\": \"1985-05-04 07:22:05.606114+00:00\", \"children\": [{\"lord\": \"mars\", \"start\": \"1984-10-03 06:34:05.606114+00:00\", \"end\": \"1984-10-15 16:46:05.606114+00:00\", \"children\": []}, {\"lord\": \"rahu\", \"start\": \"1984-10-15 16:46:05.606114+00:00\", \"end\": \"1984-11-16 15:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"jupiter\", \"start\": \"1984-11-16 15:34:05.606114+00:00\", \"end\": \"1984-12-15 01:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"saturn\", \"start\": \"1984-12-15 01:10:05.606114+00:00\", \"end\": \"1985-01-17 18:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"1985-01-17 18:34:05.606114+00:00\", \"end\": \"1985-02-16 22:46:05.606114+00:00\", \"children\": []}, {\"lord\": \"ketu\", \"start\": \"1985-02-16 22:46:05.606114+00:00\", \"end\": \"1985-03-01 08:58:05.606114+00:00\", \"children\": []}, {\"lord\": \"venus\", \"start\": \"1985-03-01 08:58:05.606114+00:00\", \"end\": \"1985-04-05 20:58:05.606114+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"1985-04-05 20:58:05.606114+00:00\", \"end\": \"1985-04-16 12:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"moon\", \"start\": \"1985-04-16 12:34:05.606114+00:00\", \"end\": \"1985-05-04 06:34:05.606114+00:00\", \"children\": []}]}, {\"lord\": \"rahu\", \"start\": \"1985-05-04 07:22:05.606114+00:00\", \"end\": \"1986-11-03 02:34:05.606114+00:00\", \"children\": [{\"lord\": \"rahu\", \"start\": \"1985-05-04 07:22:05.606114+00:00\", \"end\": \"1985-07-25 08:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"jupiter\", \"start\": \"1985-07-25 08:34:05.606114+00:00\", \"end\": \"1985-10-06 06:58:05.606114+00:00\", \"children\": []}, {\"lord\": \"saturn\", \"start\": \"1985-10-06 06:58:05.606114+00:00\", \"end\": \"1985-12-31 21:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mercury\", \"start\": \"1985-12-31 21:34:05.606114+00:00\", \"end\": \"1986-03-19 09:22:05.606114+00:00\", \"children\": []}, {\"lord\": \"ketu\", \"start\": \"1986-03-19 09:22:05.606114+00:00\", \"end\": \"1986-04-20 07:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"venus\", \"start\": \"1986-04-20 07:10:05.606114+00:00\", \"end\": \"1986-07-20 11:10:05.606114+00:00\", \"children\": []}, {\"lord\": \"sun\", \"start\": \"1986-07-20 11:10:05.606114+00:00\", \"end\": \"1986-08-16 19:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"moon\", \"start\": \"1986-08-16 19:34:05.606114+00:00\", \"end\": \"1986-10-01 09:34:05.606114+00:00\", \"children\": []}, {\"lord\": \"mars\", \"start\": \"1986-10-01 09:34:05.606114+00:00\", \"end\": \"1986-11-02 07:"
}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.