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