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.
Campos 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 |
Referência completa deste endpoint