/api/astro/retrograde/1 créditoPeríodos retrógrados
Todos os períodos retrógrados de um ano, em uma resposta compacta. O movimento retrógrado, ou vakri, é o deslocamento aparente de um planeta para trás em relação às estrelas, e a prática astrológica trata esses intervalos como uma fase à parte no comportamento do planeta. Envie apenas `year`. A resposta é `data.planets`, um objeto indexado pelo nome do planeta, cada um com uma lista de timestamps `{start, end}` em UTC. Os períodos que atravessam a virada do ano são cortados em 1º de janeiro e 31 de dezembro; assim, uma janela que começa em `01-01 00:00:00` na verdade começou no ano anterior. Um planeta que não fica retrógrado naquele ano recebe uma lista vazia. São retornadas dez chaves: mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu e ketu. O Sol e a Lua ficam de fora porque, vistos da Terra, nunca ficam retrógrados. Rahu e Ketu são derivados do nodo lunar médio, que recua de forma constante o ano todo, sem estação; por isso, ambos sempre mostram uma única janela cobrindo o ano inteiro. Com o nodo verdadeiro, surgiriam dezenas de entradas espúrias de poucos dias. Para encontrar os horários das estações, o motor delimita o dia em que a velocidade longitudinal muda de sinal e depois refina a busca dentro dele; por isso, a precisão fica bem abaixo de um minuto. Os mesmos valores aparecem em `/api/planetary_details/`, junto com outros oito cálculos; este endpoint retorna só os dados de retrogradação.
https://api.occultapi.com/api/astro/retrograde/
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 |
|---|---|---|---|
| year | integer | obrigatório | Ano de nascimento como número, por exemplo 1990. Quatro dígitos. min 1800 · max 2400 |
Exemplo de requisição
curl -X POST https://api.occultapi.com/api/astro/retrograde/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"year":2026}'Resposta
{
"data": {
"year": 2026,
"planets": {
"mercury": [
{
"start": "2026-02-26 06:47:34",
"end": "2026-03-20 19:33:02"
},
{
"start": "2026-06-29 17:34:35",
"end": "2026-07-23 22:58:49"
},
{
"start": "2026-10-24 07:12:44",
"end": "2026-11-13 15:54:27"
}
],
"venus": [
{
"start": "2026-10-03 07:13:14",
"end": "2026-11-14 00:29:50"
}
],
"mars": [],
"jupiter": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-03-11 03:53:41"
},
{
"start": "2026-12-13 00:30:39",
"end": "2026-12-31 00:00:00"
}
],
"saturn": [
{
"start": "2026-07-26 18:57:26",
"end": "2026-12-11 00:30:23"
}
],
"uranus": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-02-04 02:56:33"
},
{
"start": "2026-09-10 18:24:34",
"end": "2026-12-31 00:00:00"
}
],
"neptune": [
{
"start": "2026-07-07 09:57:49",
"end": "2026-12-13 00:46:51"
}
],
"pluto": [
{
"start": "2026-05-06 12:13:55",
"end": "2026-10-16 05:33:46"
}
],
"rahu": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-12-31 00:00:00"
}
],
"ketu": [
{
"start": "2026-01-01 00:00:00",
"end": "2026-12-31 00:00:00"
}
]
}
},
"message": "successful",
"is_error": false
}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.