POST/api/astro/retrograde/1 Credit

Rückläufige Perioden

Alle rückläufigen Perioden eines Jahres in einer kompakten Antwort. Rückläufige Bewegung (Vakri) ist das scheinbare Rückwärtswandern eines Planeten vor dem Sternhintergrund; in der astrologischen Praxis gelten diese Zeiträume als eigene Phase im Verhalten des Planeten. Sende nur `year`. Die Antwort ist `data.planets`, ein Objekt mit den Planetennamen als Schlüsseln, jeweils mit einer Liste von `{start, end}`-Zeitstempeln in UTC. Perioden, die über eine Jahresgrenze reichen, werden auf den 1. Januar bzw. den 31. Dezember gekürzt: Ein Zeitfenster, das um `01-01 00:00:00` beginnt, hat also tatsächlich schon im Vorjahr begonnen. Ein Planet, der in diesem Jahr nie rückläufig wird, erhält eine leere Liste. Geliefert werden zehn Schlüssel: mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, rahu und ketu. Sonne und Mond fehlen, weil sie von der Erde aus gesehen nie rückläufig sind. Rahu und Ketu werden aus dem mittleren Mondknoten abgeleitet, der das ganze Jahr gleichmäßig und ohne Station rückwärts läuft; beide zeigen daher immer ein einziges Zeitfenster über das gesamte Jahr. Mit dem wahren Mondknoten ergäben sich Dutzende unechter Einträge von wenigen Tagen. Für die Stationszeiten wird zuerst der Tag eingegrenzt, an dem die Geschwindigkeit in Länge ihr Vorzeichen wechselt, und dann innerhalb dieses Tages verfeinert; die Zeiten sind daher auf deutlich unter eine Minute genau. Dieselben Werte stehen auch in `/api/planetary_details/`, dort gebündelt mit acht weiteren Berechnungen; dieser Endpoint liefert nur die Rückläufigkeitsdaten.

https://api.occultapi.com/api/astro/retrograde/

Anfrage testen

Ausgabe von Rückläufige Perioden in einer Benutzeroberfläche — So sehen die Daten dieses Endpoints in einer echten Oberfläche aus. Die API liefert die Werte, das Layout baust du selbst.

Authentifizierung

Schick deinen Schlüssel im Header X-API-Key mit. API-Schlüssel sind Zugangsdaten für den Server: Sie gehören nie in Browser-JavaScript oder in eine mobile App.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Felder der Anfrage

Feld	Typ	Pflicht	Hinweise
year	integer	Pflicht	Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern. min 1800 · max 2400

Feld

Typ

Pflicht

Hinweise

year

integer

Pflicht

Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern.

min 1800 · max 2400

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/retrograde/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"year":2026}'

Antwort

{
  "data": {
    "year": 2026,
    "planets": {
      "mercury": [
        {
          "start": "2026-02-26 06:47:34",
          "end": "2026-03-20 19:33:02"
        },
        {
          "start": "2026-06-29 17:34:35",
          "end": "2026-07-23 22:58:49"
        },
        {
          "start": "2026-10-24 07:12:44",
          "end": "2026-11-13 15:54:27"
        }
      ],
      "venus": [
        {
          "start": "2026-10-03 07:13:14",
          "end": "2026-11-14 00:29:50"
        }
      ],
      "mars": [],
      "jupiter": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-03-11 03:53:41"
        },
        {
          "start": "2026-12-13 00:30:39",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "saturn": [
        {
          "start": "2026-07-26 18:57:26",
          "end": "2026-12-11 00:30:23"
        }
      ],
      "uranus": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-02-04 02:56:33"
        },
        {
          "start": "2026-09-10 18:24:34",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "neptune": [
        {
          "start": "2026-07-07 09:57:49",
          "end": "2026-12-13 00:46:51"
        }
      ],
      "pluto": [
        {
          "start": "2026-05-06 12:13:55",
          "end": "2026-10-16 05:33:46"
        }
      ],
      "rahu": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-12-31 00:00:00"
        }
      ],
      "ketu": [
        {
          "start": "2026-01-01 00:00:00",
          "end": "2026-12-31 00:00:00"
        }
      ]
    }
  },
  "message": "successful",
  "is_error": false
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data.

Fehler

Abrechnungsfehler liefern { "error": "…", "message": "<code>", "is_error": true }. Zeig deinen Nutzern error an und verzweige im Code anhand von message. Details in der Fehlerreferenz.