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

bash

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

json

{
    "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

Períodos de Retrogradação ​

Calcular Períodos de Retrogradação ​

Parâmetros ​

Pontos Padrão ​

Resposta ​

Campos da Resposta ​

Objecto RetrogradePeriod ​

Objecto Station ​

Objecto Shadow Period ​

Explicação dos Períodos de Sombra ​

Frequências Típicas de Retrogradação ​