Períodos Retrógrados

Calculad los períodos retrógrados de los planetas dentro de un rango de fechas especificado, incluyendo los períodos de sombra pre-retrógrada y post-retrógrada.

Módulo Requerido

Requiere el módulo retrograde:calc.

Calcular Períodos Retrógrados

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	Obligatorio	Descripción
startDate	string	Sí	Fecha de inicio en formato YYYY-MM-DD
endDate	string	Sí	Fecha de fin en formato YYYY-MM-DD
points	array	No	Planetas para los que calcular los períodos retrógrados (ver valores por defecto a continuación)

Puntos por Defecto

Si no se especifica points, los períodos retrógrados se calculan para todos los planetas exteriores e interiores estándar:

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

Rango de Fechas

Los rangos de fechas más largos incluirán más períodos retrógrados, pero pueden tardar ligeramente más en calcularse. No hay un límite estricto en el rango de fechas, aunque los rangos de uno o dos años son los más habituales.

Respuesta

{
    "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 de la Respuesta

Campo	Tipo	Descripción
dateRange	object	Las fechas de inicio y fin del rango solicitado
periodsByPoint	object	Períodos retrógrados agrupados por nombre del planeta
periods	array	Todos los períodos retrógrados en orden cronológico

Objeto RetrogradePeriod

Campo	Tipo	Descripción
retrogradeStation	object	Datos de cuando el planeta estaciona retrógrado
directStation	object	Datos de cuando el planeta estaciona directo
durationDays	number	Duración del período retrógrado en días
signsTraversed	array	Signos zodiacales que el planeta atraviesa mientras está retrógrado
preRetrogradeShadow	object	Período de sombra antes del inicio del retrógrado
postRetrogradeShadow	object	Período de sombra después de que el planeta pasa a directo

Objeto Station

Campo	Tipo	Descripción
date	string	Marca de tiempo UTC de la estación
longitude	number	Longitud eclíptica (0–360) en la estación
sign	string	Signo zodiacal en la estación
degreesInSign	number	Grado dentro del signo (0–30)

Objeto Shadow Period

Campo	Tipo	Descripción
startDate	string	Inicio UTC del período de sombra
endDate	string	Fin UTC del período de sombra
durationDays	number	Duración del período de sombra en días

Explicación de los Períodos de Sombra

Cada retrógrado tiene dos períodos de sombra:

• Sombra pre-retrógrada: Comienza cuando el planeta alcanza por primera vez el grado donde eventualmente pasará a directo. El planeta "anticipa" el territorio que más tarde revisará.
• Sombra post-retrógrada: Termina cuando el planeta regresa al grado donde estacionó retrógrado por primera vez. El planeta está completando su revisión de la zona retrógrada.

Planificación con las Sombras

Muchos astrólogos aconsejan precaución no solo durante el retrógrado en sí, sino también durante ambos períodos de sombra. El ciclo retrógrado completo — pre-sombra, retrógrado, post-sombra — es el período completo de revisión de los temas de ese planeta.

Frecuencias Típicas de Retrógrado

Planeta	Frecuencia	Duración
Mercurio	3–4 veces al año	~3 semanas
Venus	Una vez cada ~18 meses	~6 semanas
Marte	Una vez cada ~2 años	~2–3 meses
Júpiter	Una vez al año	~4 meses
Saturno	Una vez al año	~4,5 meses
Urano	Una vez al año	~5 meses
Neptuno	Una vez al año	~5 meses
Plutón	Una vez al año	~5–6 meses
Quirón	Una vez al año	~5 meses