curl -X POST https://api.occultapi.com/api/astro/dasha/drill/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"latitude":26.9124,"longitude":75.7873,"dasha_direction":"forward","dasha_start":"current","date_time":"2026-09-01 06:00:00","node":"true","timezone_as_float":5.5}'Um ramo de uma árvore de dasha, em vez da árvore inteira. Nos outros endpoints de dasha, levels limita a PROFUNDIDADE, mas ainda retorna todos os períodos nessa profundidade: levels=3 no Vimshottari significa todos os pratyantardashas sob todos os antardashas sob todos os mahadashas, cerca de 95 KB. Uma tela em que alguém toca em um mahadasha para expandi-lo só precisa de um ramo disso. Informe a cadeia de senhores a seguir, e este endpoint retorna só o que está sob o período indicado. {"lords": ["moon", "mars"], "levels": 1} retorna os pratyantardashas dentro do antardasha de Marte do mahadasha da Lua — cerca de 1.8 KB, contra os 95 KB da árvore que o contém. Os nomes dos senhores são comparados sem diferenciar maiúsculas de minúsculas, e path na resposta devolve a cadeia que de fato foi encontrada. Use um nome de planeta para os dashas nakshatra e um nome de signo para os dashas rashi de Jaimini; um senhor não reconhecido retorna 400, com a lista do que estava disponível naquele nível. Isso economiza TRANSFERÊNCIA, não CÁLCULO. O motor continua construindo a árvore até a profundidade pedida, e este endpoint descarta o resto; por isso, um detalhamento não é mais rápido de calcular do que a chamada equivalente com levels=. O que ele economiza é largura de banda, parse de JSON e a memória que um navegador ou celular gasta para guardar uma árvore da qual mostra só um ramo.
| 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 | Número de níveis ABAIXO do período localizado a retornar. 1 retorna os filhos diretos. min 1 · max 4 |
| lords | array | opcional | A cadeia de senhores de período a seguir a partir do topo, começando pelo mais externo — por exemplo, ["moon", "mars"] significa "dentro do mahadasha da Lua, dentro do seu antardasha de Marte". Um nome de planeta para dashas nakshatra, um nome de signo para dashas rashi. Vazio retorna o nível superior. |
| 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 |
| system | string | opcional | Sistema de dasha. Veja /api/astro/dasha/systems/. Padrão: Vimshottari. |
| 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 |