Périodes de Rétrograde
Calculez les périodes de rétrograde pour les planètes dans une plage de dates spécifiée, incluant les périodes d'ombre pré-rétrograde et post-rétrograde.
Module Requis
Nécessite le module retrograde:calc.
Calculer des Périodes de Rétrograde
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"]
}'Paramètres
| Paramètre | Type | Requis | Description |
|---|---|---|---|
startDate | string | Oui | Date de début au format YYYY-MM-DD |
endDate | string | Oui | Date de fin au format YYYY-MM-DD |
points | array | Non | Planètes pour lesquelles calculer les périodes de rétrograde (voir défauts ci-dessous) |
Points par Défaut
Si points n'est pas spécifié, les périodes de rétrograde sont calculées pour toutes les planètes externes et internes standard :
mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, chiron
Plage de Dates
Les plages de dates plus longues incluront plus de périodes de rétrograde mais peuvent prendre légèrement plus de temps à calculer. Il n'y a pas de limite stricte sur la plage de dates, mais des plages d'un ou deux ans sont typiques.
Réponse
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
}
}
]
}
}Champs de Réponse
| Champ | Type | Description |
|---|---|---|
dateRange | object | Les dates de début et de fin de la plage demandée |
periodsByPoint | object | Périodes de rétrograde groupées par nom de planète |
periods | array | Toutes les périodes de rétrograde en ordre chronologique |
Objet RetrogradePeriod
| Champ | Type | Description |
|---|---|---|
retrogradeStation | object | Données quand la planète stationne en rétrograde |
directStation | object | Données quand la planète stationne directe |
durationDays | number | Durée de la période de rétrograde en jours |
signsTraversed | array | Signes zodiacaux que la planète traverse en étant rétrograde |
preRetrogradeShadow | object | Période d'ombre avant le début du rétrograde |
postRetrogradeShadow | object | Période d'ombre après que la planète passe directe |
Objet Station
| Champ | Type | Description |
|---|---|---|
date | string | Horodatage UTC de la station |
longitude | number | Longitude écliptique (0–360) à la station |
sign | string | Signe zodiacal à la station |
degreesInSign | number | Degré dans le signe (0–30) |
Objet de Période d'Ombre
| Champ | Type | Description |
|---|---|---|
startDate | string | Début UTC de la période d'ombre |
endDate | string | Fin UTC de la période d'ombre |
durationDays | number | Durée de la période d'ombre en jours |
Explication des Périodes d'Ombre
Chaque rétrograde a deux périodes d'ombre :
- Ombre pré-rétrograde : Commence quand la planète atteint pour la première fois le degré où elle finira par passer directe. La planète "prévisualise" le territoire qu'elle revisitера ensuite.
- Ombre post-rétrograde : Se termine quand la planète revient au degré où elle a d'abord stationné en rétrograde. La planète termine sa révision de la zone de rétrograde.
Planifier avec les Ombres
De nombreux astrologues conseillent la prudence non seulement pendant le rétrograde lui-même, mais aussi pendant les deux périodes d'ombre. Le cycle complet de rétrograde — pré-ombre, rétrograde, post-ombre — est la période complète de révision pour les thèmes de cette planète.
Fréquences Typiques de Rétrograde
| Planète | Fréquence | Durée |
|---|---|---|
| Mercure | 3–4 fois par an | ~3 semaines |
| Vénus | Une fois tous les ~18 mois | ~6 semaines |
| Mars | Une fois tous les ~2 ans | ~2–3 mois |
| Jupiter | Une fois par an | ~4 mois |
| Saturne | Une fois par an | ~4,5 mois |
| Uranus | Une fois par an | ~5 mois |
| Neptune | Une fois par an | ~5 mois |
| Pluton | Une fois par an | ~5–6 mois |
| Chiron | Une fois par an | ~5 mois |