Períodos de Retrogradação

Calcula períodos de retrogradação para planetas dentro de um intervalo de datas especificado, incluindo períodos de sombra pré-retrogradação e pós-retrogradação.

Módulo Necessário

Requer o módulo retrograde:calc.

Calcular Períodos de Retrogradação

curl -X POST "https://api.astroapi.cloud/api/calc/retrograde" \
  -H "X-Api-Key: your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "startDate": "2024-01-01",
    "endDate": "2024-12-31",
    "points": ["mercury", "venus", "mars"]
  }'

Parâmetros

Parâmetro	Tipo	Obrigatório	Descrição
startDate	string	Sim	Data de início no formato YYYY-MM-DD
endDate	string	Sim	Data de fim no formato YYYY-MM-DD
points	array	Não	Planetas para os quais calcular períodos de retrogradação (ver padrões abaixo)

Pontos Padrão

Se points não for especificado, os períodos de retrogradação são calculados para todos os planetas exteriores e interiores padrão:

mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, chiron

Intervalo de Datas

Intervalos de datas mais longos incluirão mais períodos de retrogradação, mas podem demorar um pouco mais a calcular. Não há limite estrito para o intervalo de datas, mas intervalos de um ou dois anos são típicos.

Resposta

{
    "data": {
        "dateRange": {
            "startDate": "2024-01-01",
            "endDate": "2024-12-31"
        },
        "periodsByPoint": {
            "mercury": [
                {
                    "retrogradeStation": {
                        "date": "2024-04-01T15:14:00Z",
                        "longitude": 27.3,
                        "sign": "aries",
                        "degreesInSign": 27.3
                    },
                    "directStation": {
                        "date": "2024-04-25T08:54:00Z",
                        "longitude": 15.6,
                        "sign": "aries",
                        "degreesInSign": 15.6
                    },
                    "durationDays": 24,
                    "signsTraversed": ["aries"],
                    "preRetrogradeShadow": {
                        "startDate": "2024-03-18T00:00:00Z",
                        "endDate": "2024-04-01T15:14:00Z",
                        "durationDays": 14
                    },
                    "postRetrogradeShadow": {
                        "startDate": "2024-04-25T08:54:00Z",
                        "endDate": "2024-05-13T00:00:00Z",
                        "durationDays": 18
                    }
                }
            ],
            "mars": [
                {
                    "retrogradeStation": {
                        "date": "2024-12-06T09:33:00Z",
                        "longitude": 86.0,
                        "sign": "gemini",
                        "degreesInSign": 6.0
                    },
                    "directStation": {
                        "date": "2025-02-23T22:00:00Z",
                        "longitude": 47.2,
                        "sign": "cancer",
                        "degreesInSign": 17.2
                    },
                    "durationDays": 79,
                    "signsTraversed": ["gemini", "cancer"],
                    "preRetrogradeShadow": {
                        "startDate": "2024-10-26T00:00:00Z",
                        "endDate": "2024-12-06T09:33:00Z",
                        "durationDays": 41
                    },
                    "postRetrogradeShadow": {
                        "startDate": "2025-02-23T22:00:00Z",
                        "endDate": "2025-05-01T00:00:00Z",
                        "durationDays": 66
                    }
                }
            ]
        },
        "periods": [
            {
                "point": "mercury",
                "retrogradeStation": {
                    "date": "2024-04-01T15:14:00Z",
                    "longitude": 27.3,
                    "sign": "aries",
                    "degreesInSign": 27.3
                },
                "directStation": {
                    "date": "2024-04-25T08:54:00Z",
                    "longitude": 15.6,
                    "sign": "aries",
                    "degreesInSign": 15.6
                },
                "durationDays": 24,
                "signsTraversed": ["aries"],
                "preRetrogradeShadow": {
                    "startDate": "2024-03-18T00:00:00Z",
                    "endDate": "2024-04-01T15:14:00Z",
                    "durationDays": 14
                },
                "postRetrogradeShadow": {
                    "startDate": "2024-04-25T08:54:00Z",
                    "endDate": "2024-05-13T00:00:00Z",
                    "durationDays": 18
                }
            }
        ]
    }
}

Campos da Resposta

Campo	Tipo	Descrição
dateRange	object	As datas de início e fim do intervalo solicitado
periodsByPoint	object	Períodos de retrogradação agrupados por nome de planeta
periods	array	Todos os períodos de retrogradação em ordem cronológica

Objecto RetrogradePeriod

Campo	Tipo	Descrição
retrogradeStation	object	Dados de quando o planeta estaciona retrógrado
directStation	object	Dados de quando o planeta estaciona directo
durationDays	number	Duração do período de retrogradação em dias
signsTraversed	array	Signos do zodíaco pelos quais o planeta se move durante a retrogradação
preRetrogradeShadow	object	Período de sombra antes de a retrogradação começar
postRetrogradeShadow	object	Período de sombra após o planeta ficar directo

Objecto Station

Campo	Tipo	Descrição
date	string	Timestamp UTC da estação
longitude	number	Longitude eclíptica (0–360) na estação
sign	string	Signo zodiacal na estação
degreesInSign	number	Grau dentro do signo (0–30)

Objecto Shadow Period

Campo	Tipo	Descrição
startDate	string	Início UTC do período de sombra
endDate	string	Fim UTC do período de sombra
durationDays	number	Duração do período de sombra em dias

Explicação dos Períodos de Sombra

Cada retrogradação tem dois períodos de sombra:

• Sombra pré-retrogradação: Começa quando o planeta atinge pela primeira vez o grau onde acabará por ficar directo. O planeta "antecipa" o território que mais tarde irá rever.
• Sombra pós-retrogradação: Termina quando o planeta regressa ao grau onde estacionou retrógrado pela primeira vez. O planeta está a terminar a sua revisão da zona de retrogradação.

Planeamento com as Sombras

Muitos astrólogos aconselham precaução não apenas durante a retrogradação em si, mas também durante ambos os períodos de sombra. O ciclo completo de retrogradação — pré-sombra, retrogradação, pós-sombra — é o período completo de revisão dos temas daquele planeta.

Frequências Típicas de Retrogradação

Planeta	Frequência	Duração
Mercúrio	3–4 vezes por ano	~3 semanas
Vénus	Uma vez a cada ~18 meses	~6 semanas
Marte	Uma vez a cada ~2 anos	~2–3 meses
Júpiter	Uma vez por ano	~4 meses
Saturno	Uma vez por ano	~4,5 meses
Urano	Uma vez por ano	~5 meses
Neptuno	Uma vez por ano	~5 meses
Plutão	Uma vez por ano	~5–6 meses
Quíron	Uma vez por ano	~5 meses