Retrograde perioden

Bereken retrograde perioden voor planeten binnen een opgegeven datumbereik, inclusief pre-retrograde schaduw- en post-retrograde schaduwperioden.

Vereiste module

Vereist de retrograde:calc module.

Retrograde perioden berekenen

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

Parameters

Parameter	Type	Verplicht	Beschrijving
startDate	string	Ja	Startdatum in YYYY-MM-DD formaat
endDate	string	Ja	Einddatum in YYYY-MM-DD formaat
points	array	Nee	Planeten waarvoor retrograde perioden worden berekend (zie standaardwaarden hieronder)

Standaard punten

Als points niet is opgegeven, worden retrograde perioden berekend voor alle standaard buiten- en binnenplaneten:

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

Datumbereik

Langere datumbereiken bevatten meer retrograde perioden maar kunnen iets langer duren om te berekenen. Er is geen strikte limiet op het datumbereik, maar bereiken van een of twee jaar zijn gebruikelijk.

Response

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

Responsevelden

Veld	Type	Beschrijving
dateRange	object	De start- en einddatums van het gevraagde bereik
periodsByPoint	object	Retrograde perioden gegroepeerd per planeet
periods	array	Alle retrograde perioden in chronologische volgorde

RetrogradePeriod-object

Veld	Type	Beschrijving
retrogradeStation	object	Gegevens voor wanneer de planeet retrograde wordt
directStation	object	Gegevens voor wanneer de planeet direct wordt
durationDays	number	Duur van de retrograde periode in dagen
signsTraversed	array	Dierenriemtekens waar de planeet doorheen beweegt tijdens retrograde
preRetrogradeShadow	object	Schaduwperiode voor het begin van de retrograde
postRetrogradeShadow	object	Schaduwperiode nadat de planeet direct gaat

Station-object

Veld	Type	Beschrijving
date	string	UTC-tijdstempel van het station
longitude	number	Ecliptische lengtegraad (0-360) bij het station
sign	string	Dierenriemteken bij het station
degreesInSign	number	Graad binnen het teken (0-30)

Schaduwperiode-object

Veld	Type	Beschrijving
startDate	string	UTC-start van de schaduwperiode
endDate	string	UTC-einde van de schaduwperiode
durationDays	number	Duur van de schaduwperiode in dagen

Schaduwperioden uitgelegd

Elke retrograde heeft twee schaduwperioden:

• Pre-retrograde schaduw: Begint wanneer de planeet voor het eerst de graad bereikt waar deze uiteindelijk direct zal gaan. De planeet "previewed" het gebied dat later opnieuw wordt bezocht.
• Post-retrograde schaduw: Eindigt wanneer de planeet terugkeert naar de graad waar deze voor het eerst retrograde werd. De planeet rondt de herziening van de retrograde zone af.

Plannen met schaduwperioden

Veel astrologen adviseren voorzichtigheid niet alleen tijdens de retrograde zelf, maar ook tijdens beide schaduwperioden. De volledige retrograde cyclus — pre-schaduw, retrograde, post-schaduw — is de complete herzieningsperiode voor de thema's van die planeet.

Typische retrograde-frequenties

Planeet	Frequentie	Duur
Mercurius	3-4 keer per jaar	~3 weken
Venus	Eens per ~18 maanden	~6 weken
Mars	Eens per ~2 jaar	~2-3 maanden
Jupiter	Eens per jaar	~4 maanden
Saturnus	Eens per jaar	~4,5 maanden
Uranus	Eens per jaar	~5 maanden
Neptunus	Eens per jaar	~5 maanden
Pluto	Eens per jaar	~5-6 maanden
Chiron	Eens per jaar	~5 maanden