Rückläufige Perioden

Berechnen Sie rückläufige Perioden für Planeten innerhalb eines bestimmten Datumsbereichs, einschließlich Vor- und Nach-Schattenperioden.

Erforderliches Modul

Erfordert das Modul retrograde:calc.

Rückläufige Perioden berechnen

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

Parameter

Parameter	Typ	Erforderlich	Beschreibung
startDate	string	Ja	Startdatum im Format YYYY-MM-DD
endDate	string	Ja	Enddatum im Format YYYY-MM-DD
points	array	Nein	Planeten, für die rückläufige Perioden berechnet werden sollen (siehe Standardwerte unten)

Standardpunkte

Wenn points nicht angegeben ist, werden rückläufige Perioden für alle Standard-Außen- und Innenplaneten berechnet:

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

Datumsbereich

Längere Datumsbereiche umfassen mehr rückläufige Perioden, können aber etwas länger für die Berechnung benötigen. Es gibt keine strenge Begrenzung des Datumsbereichs, aber Bereiche von einem oder zwei Jahren sind typisch.

Antwort

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

Antwortfelder

Feld	Typ	Beschreibung
dateRange	object	Start- und Enddaten des angeforderten Bereichs
periodsByPoint	object	Rückläufige Perioden gruppiert nach Planetenname
periods	array	Alle rückläufigen Perioden in chronologischer Reihenfolge

RetrogradePeriod-Objekt

Feld	Typ	Beschreibung
retrogradeStation	object	Daten für den Zeitpunkt, zu dem der Planet rückläufig wird
directStation	object	Daten für den Zeitpunkt, zu dem der Planet wieder direktläufig wird
durationDays	number	Dauer der rückläufigen Periode in Tagen
signsTraversed	array	Tierkreiszeichen, die der Planet während der Rückläufigkeit durchquert
preRetrogradeShadow	object	Schattenperiode vor Beginn der Rückläufigkeit
postRetrogradeShadow	object	Schattenperiode nachdem der Planet wieder direktläufig wird

Station-Objekt

Feld	Typ	Beschreibung
date	string	UTC-Zeitstempel der Station
longitude	number	Ekliptikale Länge (0–360) bei der Station
sign	string	Tierkreiszeichen bei der Station
degreesInSign	number	Grad innerhalb des Zeichens (0–30)

Schattenperioden-Objekt

Feld	Typ	Beschreibung
startDate	string	UTC-Beginn der Schattenperiode
endDate	string	UTC-Ende der Schattenperiode
durationDays	number	Dauer der Schattenperiode in Tagen

Schattenperioden erklärt

Jede Rückläufigkeit hat zwei Schattenperioden:

• Vor-Rückläufigkeits-Schatten: Beginnt, wenn der Planet erstmals den Grad erreicht, bis zu dem er schließlich wieder direktläufig wird. Der Planet „skizziert" das Territorium, das er später erneut durchqueren wird.
• Nach-Rückläufigkeits-Schatten: Endet, wenn der Planet zum Grad zurückkehrt, bei dem er erstmals rückläufig wurde. Der Planet schließt seine Überprüfung der rückläufigen Zone ab.

Planung mit Schatten

Viele Astrologen raten zur Vorsicht nicht nur während der eigentlichen Rückläufigkeit, sondern auch während beider Schattenperioden. Der vollständige Rückläufigkeitszyklus – Vor-Schatten, Rückläufigkeit, Nach-Schatten – ist die vollständige Überprüfungsperiode für die Themen dieses Planeten.

Typische Rückläufigkeitshäufigkeiten

Planet	Häufigkeit	Dauer
Merkur	3–4 Mal pro Jahr	ca. 3 Wochen
Venus	Einmal alle ca. 18 Monate	ca. 6 Wochen
Mars	Einmal alle ca. 2 Jahre	ca. 2–3 Monate
Jupiter	Einmal pro Jahr	ca. 4 Monate
Saturn	Einmal pro Jahr	ca. 4,5 Monate
Uranus	Einmal pro Jahr	ca. 5 Monate
Neptun	Einmal pro Jahr	ca. 5 Monate
Pluto	Einmal pro Jahr	ca. 5–6 Monate
Chiron	Einmal pro Jahr	ca. 5 Monate