Periodi di Retrogradazione

Calcola i periodi di retrogradazione dei pianeti all'interno di un intervallo di date specificato, inclusi i periodi d'ombra pre-retrogradazione e post-retrogradazione.

Modulo Richiesto

Richiede il modulo retrograde:calc.

Calcola i Periodi di Retrogradazione

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"]
  }'

Parametri

Parametro	Tipo	Obbligatorio	Descrizione
startDate	string	Sì	Data di inizio nel formato YYYY-MM-DD
endDate	string	Sì	Data di fine nel formato YYYY-MM-DD
points	array	No	Pianeti per cui calcolare i periodi di retrogradazione (vedi predefiniti sotto)

Punti Predefiniti

Se points non è specificato, i periodi di retrogradazione vengono calcolati per tutti i pianeti esterni e interni standard:

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

Intervallo di Date

Intervalli di date più lunghi includeranno più periodi di retrogradazione ma potrebbero richiedere leggermente più tempo per il calcolo. Non c'è un limite rigoroso sull'intervallo di date, ma intervalli di uno o due anni sono tipici.

Risposta

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

Campi della Risposta

Campo	Tipo	Descrizione
dateRange	object	Le date di inizio e fine dell'intervallo richiesto
periodsByPoint	object	Periodi di retrogradazione raggruppati per nome del pianeta
periods	array	Tutti i periodi di retrogradazione in ordine cronologico

Oggetto RetrogradePeriod

Campo	Tipo	Descrizione
retrogradeStation	object	Dati relativi a quando il pianeta staziona retrogrado
directStation	object	Dati relativi a quando il pianeta staziona diretto
durationDays	number	Durata del periodo di retrogradazione in giorni
signsTraversed	array	Segni zodiacali attraverso cui il pianeta si muove durante la retrogradazione
preRetrogradeShadow	object	Periodo d'ombra prima dell'inizio della retrogradazione
postRetrogradeShadow	object	Periodo d'ombra dopo che il pianeta ritorna diretto

Oggetto Station

Campo	Tipo	Descrizione
date	string	Timestamp UTC della stazione
longitude	number	Longitudine eclittica (0–360) alla stazione
sign	string	Segno zodiacale alla stazione
degreesInSign	number	Grado all'interno del segno (0–30)

Oggetto Shadow Period

Campo	Tipo	Descrizione
startDate	string	Inizio UTC del periodo d'ombra
endDate	string	Fine UTC del periodo d'ombra
durationDays	number	Durata del periodo d'ombra in giorni

Spiegazione dei Periodi d'Ombra

Ogni retrogradazione ha due periodi d'ombra:

• Ombra pre-retrogradazione: Inizia quando il pianeta raggiunge per la prima volta il grado in cui alla fine andrà diretto. Il pianeta "anticipa" il territorio che rivisiterà in seguito.
• Ombra post-retrogradazione: Termina quando il pianeta ritorna al grado in cui si è stazionato retrogrado per la prima volta. Il pianeta sta completando la sua revisione della zona di retrogradazione.

Pianificazione con le Ombre

Molti astrologi consigliano cautela non solo durante la retrogradazione stessa, ma anche durante entrambi i periodi d'ombra. Il ciclo completo di retrogradazione — pre-ombra, retrogradazione, post-ombra — è il periodo completo di revisione per i temi di quel pianeta.

Frequenze Tipiche di Retrogradazione

Pianeta	Frequenza	Durata
Mercurio	3–4 volte all'anno	~3 settimane
Venere	Una volta ogni ~18 mesi	~6 settimane
Marte	Una volta ogni ~2 anni	~2–3 mesi
Giove	Una volta all'anno	~4 mesi
Saturno	Una volta all'anno	~4,5 mesi
Urano	Una volta all'anno	~5 mesi
Nettuno	Una volta all'anno	~5 mesi
Plutone	Una volta all'anno	~5–6 mesi
Chirone	Una volta all'anno	~5 mesi