/api/astro/nakshatra_transitions/1 créditoTransições de nakshatra
O movimento de cada planeta de um nakshatra para o seguinte ao longo de um ano civil, com cada cruzamento calculado com precisão de cerca de um segundo. Esta é a tabela 'planet nakshatra gochar': quando Saturno deixa Purva Bhadrapada, quando Júpiter entra em Pushya, quando a Lua muda de estrela — os eventos que marcam o momento das previsões de trânsito. granularity define a resolução. 'nakshatra' usa as divisões de 13°20' e retorna from e to como nomes simples; 'pada' usa os quartos de 3°20' e, nesse caso, retorna from e to como objetos {nakshatra, pada}. Defina use_28_nakshatras como true para incluir Abhijit como vigésima oitava divisão. Passe year e timezone_as_float. O deslocamento define quando o ano local começa e termina, mas os timestamps retornados estão em UTC — converta-os você mesmo antes de exibir. A resposta é {year, granularity, planets}, em que planets é indexado por nome (sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu, ketu), cada um com uma lista cronológica de {from, to, datetime}. Só a Lua produz mais de trezentas transições de nakshatra em um ano e cerca de mil e quatrocentas transições de pada, então as respostas por pada são grandes.
https://api.occultapi.com/api/astro/nakshatra_transitions/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 |
|---|---|---|---|
| granularity | string | obrigatório | nakshatrapada |
| year | integer | obrigatório | Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400 |
| 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. |
| use_28_nakshatras | boolean | opcional |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/nakshatra_transitions/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"granularity":"nakshatra","year":2026,"timezone_as_float":5.5}'Resposta
{
"_truncated": true,
"_note": "Response shortened for the catalogue.",
"preview": "{\"data\": {\"year\": 2026, \"granularity\": \"nakshatra\", \"planets\": {\"jupiter\": [{\"from\": \"Punarvasu\", \"to\": \"Pushyami\", \"datetime\": \"2026-06-18 15:31:55\"}, {\"from\": \"Pushyami\", \"to\": \"Aasresha\", \"datetime\": \"2026-08-18 21:42:28\"}, {\"from\": \"Aasresha\", \"to\": \"Makha\", \"datetime\": \"2026-10-31 06:32:43\"}], \"sun\": [{\"from\": \"Poorvaashaadha\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-01-11 03:06:16\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-01-24 05:20:24\"}, {\"from\": \"Sravanam\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-02-06 08:35:04\"}, {\"from\": \"Dhanishtha\", \"to\": \"Satabhishak\", \"datetime\": \"2026-02-19 13:03:28\"}, {\"from\": \"Satabhishak\", \"to\": \"Poorvaabhaadra\", \"datetime\": \"2026-03-04 19:24:10\"}, {\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-03-18 03:51:12\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-03-31 14:40:06\"}, {\"from\": \"Revati\", \"to\": \"Ashwini\", \"datetime\": \"2026-04-14 04:02:39\"}, {\"from\": \"Ashwini\", \"to\": \"Bharani\", \"datetime\": \"2026-04-27 19:47:57\"}, {\"from\": \"Bharani\", \"to\": \"Krittika\", \"datetime\": \"2026-05-11 14:01:16\"}, {\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"2026-05-25 10:07:52\"}, {\"from\": \"Rohini\", \"to\": \"Mrigasira\", \"datetime\": \"2026-06-08 08:03:01\"}, {\"from\": \"Mrigasira\", \"to\": \"Aardra\", \"datetime\": \"2026-06-22 06:56:07\"}, {\"from\": \"Aardra\", \"to\": \"Punarvasu\", \"datetime\": \"2026-07-06 06:33:36\"}, {\"from\": \"Punarvasu\", \"to\": \"Pushyami\", \"datetime\": \"2026-07-20 05:58:19\"}, {\"from\": \"Pushyami\", \"to\": \"Aasresha\", \"datetime\": \"2026-08-03 04:54:24\"}, {\"from\": \"Aasresha\", \"to\": \"Makha\", \"datetime\": \"2026-08-17 02:28:46\"}, {\"from\": \"Makha\", \"to\": \"Poorva Phalguni\", \"datetime\": \"2026-08-30 22:29:09\"}, {\"from\": \"Poorva Phalguni\", \"to\": \"Uttara Phalguni\", \"datetime\": \"2026-09-13 16:17:57\"}, {\"from\": \"Uttara Phalguni\", \"to\": \"Hasta\", \"datetime\": \"2026-09-27 07:49:50\"}, {\"from\": \"Hasta\", \"to\": \"Chitra\", \"datetime\": \"2026-10-10 20:50:07\"}, {\"from\": \"Chitra\", \"to\": \"Swaati\", \"datetime\": \"2026-10-24 07:20:48\"}, {\"from\": \"Swaati\", \"to\": \"Visaakha\", \"datetime\": \"2026-11-06 15:33:21\"}, {\"from\": \"Visaakha\", \"to\": \"Anooraadha\", \"datetime\": \"2026-11-19 21:33:50\"}, {\"from\": \"Anooraadha\", \"to\": \"Jyeshtha\", \"datetime\": \"2026-12-03 01:58:15\"}, {\"from\": \"Jyeshtha\", \"to\": \"Moola\", \"datetime\": \"2026-12-16 04:55:02\"}, {\"from\": \"Moola\", \"to\": \"Poorvaashaadha\", \"datetime\": \"2026-12-29 07:14:19\"}], \"rahu\": [{\"from\": \"Satabhishak\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-08-01 21:41:47\"}], \"pluto\": [{\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-02-18 02:18:30\"}, {\"from\": \"Sravanam\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-07-29 15:00:03\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-12-28 01:39:54\"}], \"saturn\": [{\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-01-20 05:22:43\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-05-17 09:07:48\"}, {\"from\": \"Revati\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-10-09 15:21:10\"}], \"uranus\": [{\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"2026-07-11 23:54:01\"}, {\"from\": \"Rohini\", \"to\": \"Krittika\", \"datetime\": \"2026-11-12 10:52:56\"}], \"mars\": [{\"from\": \"Poorvaashaadha\", \"to\": \"Uttaraashaadha\", \"datetime\": \"2026-01-11 15:40:42\"}, {\"from\": \"Uttaraashaadha\", \"to\": \"Sravanam\", \"datetime\": \"2026-01-28 19:08:49\"}, {\"from\": \"Sravanam\", \"to\": \"Dhanishtha\", \"datetime\": \"2026-02-14 19:08:16\"}, {\"from\": \"Dhanishtha\", \"to\": \"Satabhishak\", \"datetime\": \"2026-03-03 17:24:52\"}, {\"from\": \"Satabhishak\", \"to\": \"Poorvaabhaadra\", \"datetime\": \"2026-03-20 15:51:47\"}, {\"from\": \"Poorvaabhaadra\", \"to\": \"Uttaraabhaadra\", \"datetime\": \"2026-04-06 16:26:20\"}, {\"from\": \"Uttaraabhaadra\", \"to\": \"Revati\", \"datetime\": \"2026-04-23 20:52:02\"}, {\"from\": \"Revati\", \"to\": \"Ashwini\", \"datetime\": \"2026-05-11 07:08:41\"}, {\"from\": \"Ashwini\", \"to\": \"Bharani\", \"datetime\": \"2026-05-29 00:55:31\"}, {\"from\": \"Bharani\", \"to\": \"Krittika\", \"datetime\": \"2026-06-16 04:02:43\"}, {\"from\": \"Krittika\", \"to\": \"Rohini\", \"datetime\": \"20"
}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.