Direkt zum Inhalt
POST/api/astro/shani_analysis/1 Credit

Saturn-Transitphasen

Auf seinem langsamen Umlauf durch den Tierkreis durchläuft Saturn vier benannte Phasen, die die indische Astrologie genau verfolgt; alle werden vom Radix-Mond oder vom Radix-Aszendenten aus gemessen: Sade Sati, die siebeneinhalb Jahre rund um Saturns Durchgang über diesen Punkt; Ashtama Shani, Saturn im 8. Haus davon; Kantaka Shani, Saturn im 4., 7. oder 10. Haus; und Dhaiya, auch Ardhashtama genannt, Saturn im 4. oder 8. Haus. Dieser Endpoint gibt für einen beliebigen Zeitpunkt an, ob die jeweilige Phase läuft, wann sie endet und wann die nächste beginnt. Sende zwei Horoskope: die Geburtsdaten als `date_time_natal`, `latitude_natal`, `longitude_natal` und `chart_name_natal` und den gefragten Zeitpunkt über die entsprechenden `_transit`-Felder. `ref_celestial` legt fest, ob die Phasen vom Radix-Mond oder vom Radix-Aszendenten aus gemessen werden. `mode` bestimmt, wie streng geprüft wird – 0 prüft die Stellung in Ganzzeichenhäusern, höhere Werte prüfen stattdessen ein Gradfenster um den Bezugspunkt und liefern deutlich engere Beginn- und Enddaten. Die Antwort enthält acht Objekte. `ashtama_shani`, `kantaka_shani`, `dhaiya_shani` und `sade_sati_shani` sind jeweils `{status, end_date}`: ein boolescher Wert, ob die Phase zum Transitzeitpunkt läuft, und, falls ja, ein Enddatum in ISO 8601 UTC, sonst null. `next_ashtama_shani`, `next_kantaka_shani` und `next_dhaiya_shani` sind `{date, ref_house_from_natal}`: wann das nächste Auftreten beginnt und welches Haus ab dem Bezugspunkt es auslöst; `next_sade_sati_shani` liefert nur `{date}`. Die Vorwärtssuche reicht hundert Jahre ab dem Transitzeitpunkt. Da Kantaka und Dhaiya beide das 4. Haus umfassen, melden sie oft dieselben Daten. Das ist so gewollt und kein Duplikat.

https://api.occultapi.com/api/astro/shani_analysis/
Anfrage testen

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

FeldTypPflichtHinweise
chart_name_natalstringPflicht
chart_name_transitstringPflicht
date_time_natalstring (date-time)Pflicht
date_time_transitstring (date-time)Pflicht
latitude_natalnumber (double)Pflicht

min -180 · max 180

latitude_transitnumber (double)Pflicht

min -180 · max 180

longitude_natalnumber (double)Pflicht

min -180 · max 180

longitude_transitnumber (double)Pflicht

min -180 · max 180

modeintegerPflicht
ref_celestialstringPflicht
ascendantmoon

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/shani_analysis/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time_natal":"2025-11-21T05:41:58.124Z","date_time_transit":"2024-11-21T05:41:58.124Z","longitude_natal":77.5946,"latitude_natal":12.9716,"longitude_transit":26.1046,"latitude_transit":26.9124,"chart_name_natal":"RashiChart","chart_name_transit":"RashiChart","ref_celestial":"ascendant","mode":0}'

Antwort

{
  "data": {
    "ashtama_shani": {
      "status": false,
      "end_date": null
    },
    "kantaka_shani": {
      "status": false,
      "end_date": null
    },
    "dhaiya_shani": {
      "status": false,
      "end_date": null
    },
    "sade_sati_shani": {
      "status": true,
      "end_date": "2025-03-09T10:21:25Z"
    },
    "next_ashtama_shani": {
      "date": "2036-08-08T03:38:39Z",
      "ref_house_from_natal": 8
    },
    "next_kantaka_shani": {
      "date": "2027-05-11T00:01:56Z",
      "ref_house_from_natal": 4
    },
    "next_dhaiya_shani": {
      "date": "2027-05-11T00:01:56Z",
      "ref_house_from_natal": 4
    },
    "next_sade_sati_shani": {
      "date": "2046-02-22T02:59:10Z"
    }
  },
  "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.