Direkt zum Inhalt
POST/api/astro/chinese/bazi/1 Credit

BaZi-Horoskop mit den Zehn Göttern

Die vollständige BaZi-Deutung: verborgene Stämme, Zehn Götter und Elementbilanz. Alles, was in den Vier Säulen steckt, plus die Deutungsebene, die sie lesbar macht. VERBORGENE STÄMME: Jeder Zweig enthält einen bis drei weitere Stämme, und eine Deutung zählt sie mit. Ein Horoskop, dem nach den sichtbaren Stämmen das Feuer zu fehlen scheint, kann reichlich davon haben, sobald man die Zweige öffnet. ZEHN GÖTTER: Jeder Stamm wird nicht nach sich selbst benannt, sondern nach seiner Beziehung zum Tagesmeister – Direct Officer, Seven Killings, Eating God und so weiter. Das ist das gesamte Deutungsvokabular des Systems; deshalb muss zuerst der Tagesmeister bestimmt werden. ELEMENTBILANZ: über sichtbare und verborgene Stämme zusammen gezählt und in beiden Varianten geliefert, damit du siehst, was die Zweige ausmachen. Eine Deutung hängt davon ab, welches der fünf Elemente stark ist und welches fehlt.

https://api.occultapi.com/api/astro/chinese/bazi/
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
date_timestring (date-time)Pflicht

Der Zeitpunkt, für den gerechnet wird, im Format ISO 8601. Gib IMMER einen Offset oder ein abschließendes Z an – ein Wert ohne Zone wird als Asia/Kolkata (UTC+05:30) gelesen, nicht als UTC, und kann mit Status 200 das Ergebnis des Vortags liefern. '2026-09-01T06:00:00Z' und '2026-09-01 06:00:00' sind verschiedene Zeitpunkte und ergeben verschiedene Antworten.

day_boundarystringoptional

Wann die Tagessäule wechselt. 'zi_hour' bedeutet 23:00, die traditionelle Regel; 'midnight' verwendet die meiste Software. Für Geburten zwischen 23:00 und 24:00 ergeben sie unterschiedliche Ergebnisse.

zi_hourmidnight
keysarrayoptional

Welche Berechnungen zurückgegeben werden, als Liste von Namen. Siehe die Key-Tabelle dieses Endpoints; ein unbekannter Name lässt die ganze Anfrage scheitern. Ein Aufruf kostet einen Credit, egal wie viele Keys du anforderst – fordere also alles, was du brauchst, auf einmal an, statt mehrere Aufrufe zu machen.

latitudenumber (double)optional

Breitengrad des Ortes in Dezimalgrad. Positiv ist Nord, negativ ist Süd. Beispiel: 26.9124 für Jaipur, 40.7128 für New York. Minuten und Sekunden werden nicht akzeptiert – vorher umrechnen.

longitudenumber (double)optional

Längengrad des Ortes in Dezimalgrad. Positiv ist Ost, negativ ist West. Beispiel: 75.7873 für Jaipur, -74.0060 für New York. Achte auf das Vorzeichen: Ein fehlendes Minus verlegt New York nach China.

orb_factornumber (double)optional

Skaliert alle Aspektorben. 0.5 halbiert sie, 2 verdoppelt sie.

min 0.1 · max 2

timezone_as_floatnumber (double)optional

UTC-Offset des Ortes in Stunden, als Dezimalzahl. Beispiel: 5.5 für Indien (UTC+05:30), -5 für New York im Winter, 5.75 für Nepal. Wird NICHT gegen date_time validiert – stimmen beide nicht überein, erhältst du eine erfolgreiche Antwort für den falschen Zeitpunkt; leite daher beide aus derselben Quelle ab. Nutze den an diesem Datum gültigen Offset, nicht den heutigen: Eine Sommergeburt in einem Land mit Sommerzeit braucht den Sommer-Offset.

min -12 · max 14

true_solar_timebooleanoptional

Korrigiert die Stunde um den Abstand des Längengrads vom Zeitzonenmeridian. Traditionell rechnet man mit der wahren Ortssonnenzeit, und das kann die Stundensäule um eine Stelle verschieben.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/chinese/bazi/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1984-06-15T14:30:00+08:00","latitude":39.9042,"longitude":116.4074,"timezone_as_float":8}'

Antwort

{
  "data": {
    "system": "Chinese Four Pillars (BaZi)",
    "local_time": "1984-06-15T14:30:00+08:00",
    "chinese_year": 1984,
    "day_master": {
      "index": 7,
      "name": "Geng",
      "pinyin": "geng",
      "element": "metal",
      "polarity": "yang",
      "note": "The day stem. Every other stem in the chart is read as its relationship to this."
    },
    "pillars": [
      {
        "pillar": "year",
        "stem": {
          "index": 1,
          "name": "Jia",
          "pinyin": "jia",
          "element": "wood",
          "polarity": "yang",
          "ten_god": "Indirect Wealth"
        },
        "branch": {
          "index": 1,
          "name": "Zi",
          "animal": "Rat",
          "element": "water",
          "polarity": "yang",
          "element_note": "The branch's own element; its hidden stems may differ."
        },
        "name": "Jia-Zi",
        "animal": "Rat",
        "hidden_stems": [
          {
            "index": 10,
            "name": "Gui",
            "pinyin": "gui",
            "element": "water",
            "polarity": "yin",
            "ten_god": "Hurting Officer"
          }
        ]
      },
      {
        "pillar": "month",
        "stem": {
          "index": 7,
          "name": "Geng",
          "pinyin": "geng",
          "element": "metal",
          "polarity": "yang",
          "ten_god": "Friend"
        },
        "branch": {
          "index": 7,
          "name": "Wu",
          "animal": "Horse",
          "element": "fire",
          "polarity": "yang",
          "element_note": "The branch's own element; its hidden stems may differ."
        },
        "name": "Geng-Wu",
        "animal": "Horse",
        "hidden_stems": [
          {
            "index": 4,
            "name": "Ding",
            "pinyin": "ding",
            "element": "fire",
            "polarity": "yin",
            "ten_god": "Direct Officer"
          },
          {
            "index": 6,
            "name": "Ji",
            "pinyin": "ji",
            "element": "earth",
            "polarity": "yin",
            "ten_god": "Direct Resource"
          }
        ]
      },
      {
        "pillar": "day",
        "stem": {
          "index": 7,
          "name": "Geng",
          "pinyin": "geng",
          "element": "metal",
          "polarity": "yang",
          "ten_god": "Day Master"
        },
        "branch": {
          "index": 5,
          "name": "Chen",
          "animal": "Dragon",
          "element": "earth",
          "polarity": "yang",
          "element_note": "The branch's own element; its hidden stems may differ."
        },
        "name": "Geng-Chen",
        "animal": "Dragon",
        "hidden_stems": [
          {
            "index": 5,
            "name": "Wu",
            "pinyin": "wu",
            "element": "earth",
            "polarity": "yang",
            "ten_god": "Indirect Resource"
          },
          {
            "index": 2,
            "name": "Yi",
            "pinyin": "yi",
            "element": "wood",
            "polarity": "yin",
            "ten_god": "Direct Wealth"
          },
          {
            "index": 10,
            "name": "Gui",
            "pinyin": "gui",
            "element": "water",
            "polarity": "yin",
            "ten_god": "Hurting Officer"
          }
        ]
      },
      {
        "pillar": "hour",
        "stem": {
          "index": 10,
          "name": "Gui",
          "pinyin": "gui",
          "element": "water",
          "polarity": "yin",
          "ten_god": "Hurting Officer"
        },
        "branch": {
          "index": 8,
          "name": "Wei",
          "animal": "Goat",
          "element": "earth",
          "polarity": "yin",
          "element_note": "The branch's own element; its hidden stems may differ."
        },
        "name": "Gui-Wei",
        "animal": "Goat",
        "hidden_stems": [
          {
            "index": 6,
            "name": "Ji",
            "pinyin": "ji",
            "element": "earth",
            "polarity": "yin",
            "ten_god": "Direct Resource"
          },
          {
            "index": 4,
            "name": "Ding",
            "pinyin": "ding",
            "element": "fire",
            "polarity": "yin",
            "ten_god": "Direct Officer"
          },
          {
            "index": 2,
            "name": "Yi",
            "pinyin": "yi",
            "element": "wood",
            "polarity": "yin",
            "ten_god": "Direct Wealth"
          }
        ]
      }
    ],
    "element_balance": {
      "visible_stems_only": {
        "wood": 1,
        "fire": 0,
        "earth": 0,
        "metal": 2,
        "water": 1
      },
      "including_hidden_stems": {
        "wood": 3,
        "fire": 2,
        "earth": 3,
        "metal": 2,
        "water": 3
      },
      "strongest": "wood",
      "missing": []
    },
    "cycles": {
      "produces": {
        "wood": "fire",
        "fire": "earth",
        "earth": "metal",
        "metal": "water",
        "water": "wood"
      },
      "controls": {
        "wood": "earth",
        "earth": "water",
        "water": "fire",
        "fire": "metal",
        "metal": "wood"
      }
    },
    "note": "Element counts are given with and without the hidden stems, because a chart can look short of an element on its visible stems and be full of it in the branches."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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.