POST/api/astro/mundane/1 Credit

Mundanastrologie

Die Mundanastrologie deutet das Jahr für ein Land statt für eine Person. Ihr zentrales Werkzeug ist das Samvatsara-Kabinett: zehn „Amtsträger“ des Jahres, jeder davon ein Planet. Jeder wird durch den lokalen Wochentag bestimmt – gezählt von Sonnenaufgang bis Sonnenaufgang am angegebenen Ort –, auf den ein bestimmtes Sonnenereignis fällt: der König durch das Mond-Neujahr, der Minister durch den Eintritt der Sonne in den Widder, der Herrscher der Wolken durch ihren Eintritt in Ardra und so weiter bis zu den Herrschern des Getreides, der Schatzkammer und der Früchte. Ein Jahr mit Saturn als König wird ganz anders gedeutet als eines mit Jupiter. Übergib das gregorianische Jahr, in dem das Samvat-Jahr beginnt, dazu einen Ort und den UTC-Offset; das Kabinett gilt von Chaitra Shukla Pratipada dieses Jahres bis zum nächsten. das_adhikari liefert das ganze Kabinett in einem Objekt und ist der Key, mit dem du am besten beginnst; die einzelnen Keys – king_of_year, mantri_of_year, meghesha_of_year und die übrigen – liefern dieselben Planeten einzeln. vaahan_of_samvat liefert das symbolische Fahrzeug des Jahres, das sich aus dem König ergibt. Neben dem Kabinett liefert der Endpoint den astronomischen Rahmen des Jahres – Tagundnachtgleichen, Sonnenwenden, indian_ritus mit den sechs Jahreszeiten als echten Zeiträumen, chaitra_shukla_pratipada und ardra_entry – sowie vier Horoskope für bestimmte Ingresse: jagat_lagna_chart zum Eintritt der Sonne in den Widder, ardra_pravesh_chart für den Monsun sowie sharatsasya_chart und greeshmasasya_chart für die Winter- und die Sommerernte. sapta_nadi_chakra und samvatsara_purusha_chakra sind statische Referenztabellen, die sich von Jahr zu Jahr nicht ändern; nakshatra_lord_effects schlägt ein einzelnes Nakshatra in der ersten davon nach. Das Feld nakshatra dieses Keys verwendet eine ältere Transliteration und kennt nur sechsundzwanzig Namen – prüfe die Werteliste des Feldes, statt von modernen Schreibweisen auszugehen.

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

Anfrage testen

Ausgabe von Mundanastrologie 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
date_time	string (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.
keys	array	Pflicht	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.
latitude	number (double)	Pflicht	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. min -90 · max 90
longitude	number (double)	Pflicht	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. min -180 · max 180
nakshatra	string	Pflicht	`KrittikaVisaakhaAnooraadhaBharaniRohiniSwaatiJyeshthaAshwiniMrigasiraChitraMoolaRevati` Wird nur vom Key 'nakshatra_lord_effects' verwendet. EXAKTER Abgleich mit der Sapta-Nadi-Chakra-Tabelle, Groß-/Kleinschreibung wird beachtet – dies sind ältere Transliterationen, nicht die modernen Schreibweisen; beachte 'Aardra' (nicht Ardra), 'Aasresha' (nicht Ashlesha), 'Makha' (nicht Magha), 'Sravanam' (nicht Shravana), 'Visaakha', 'Anooraadha', 'Mrigasira', 'Pushyami', 'Satabhishak', 'Poorvaabhaadra', 'Uttaraashaadha'. Nur 26 der 28 Nakshatra-Namen kommen vor – 'Poorvaashaadha' und 'Uttaraabhaadra' fehlen in der Tabelle. Ein nicht passender Name führt NICHT zu einem Fehler: Die Methode liefert null.
timezone_as_float	number (double)	Pflicht	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
year	integer	Pflicht	Geburtsjahr als Zahl, z. B. 1990. Vier Ziffern.

Verfügbare Keys (24)

Liste in keys genau die Berechnungen auf, die du brauchst. Ein unbekannter Key lässt die ganze Anfrage scheitern. Du zahlst 1 Credit, ganz gleich, wie viele du anforderst – fass sie also in einer Anfrage zusammen.

Key	Zusätzliche Felder	Beschreibung
ardra_entry	—	Der exakte Zeitpunkt, an dem die Sonne 66°40' erreicht, also den Beginn des Nakshatras Ardra – der traditionelle Bezugspunkt für die Monsun-Deutung. Ein einzelner Zeitstempel.
ardra_pravesh_chart	—	Dieselbe Horoskopstruktur, erstellt für den Zeitpunkt, an dem die Sonne in das Nakshatra Ardra eintritt – das Horoskop, nach dem der Monsun gedeutet wird. Liefert {entry_time, chart, house_planets}.
chaitra_shukla_pratipada	—	Das hinduistische Mond-Neujahr: der lokale Sonnenaufgang, mit dem im angefragten Jahr der Tag Chaitra Shukla Pratipada beginnt. Chaitra beginnt mit dem letzten Neumond, bevor die Sonne in den siderischen Widder eintritt. Maßgeblich ist der erste Tag, an dessen Sonnenaufgang die erste Tithi der hellen Monatshälfte gilt – oder, falls diese Tithi keinen Sonnenaufgang berührt, der Tag, an dem sie beginnt. Ein einzelner Zeitstempel.
das_adhikari	—	Das ganze Kabinett des Jahres in einem Objekt, mit den Schlüsseln King, Minister, Lord of Clouds, Lord of Summer Crops, Lord of Defence, Lord of Treasury, Lord of Juicy Products, Lord of Food Grains, Lord of Metals, Lord of Fruits und Vehicle of Year. Die ersten zehn Werte sind Planetennamen, der letzte ist das Fahrzeug. Beginne hier, statt die zehn einzelnen Keys anzufordern.
dhaanyesha_of_year	—	Dhanyesha, Herrscher des Getreides: der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in den Schützen fällt. Ein einzelner englischer Planetenname.
dhanesha_of_year	—	Dhanesha, Herrscher der Schatzkammer: der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in die Jungfrau fällt. Ein einzelner englischer Planetenname.
durgesha_of_year	—	Durgesha, Herrscher der Festungen und der Verteidigung: der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in den Löwen fällt. Ein einzelner englischer Planetenname.
equinoxes	—	Die beiden Tagundnachtgleichen des Jahres als Zeitpunkte, bestimmt als die Durchgänge der Sonne durch 0 und 180 Grad tropischer Länge. Eine Liste mit zwei Elementen: zuerst die Frühlings-, dann die Herbst-Tagundnachtgleiche.
greeshmasasya_chart	—	Das Horoskop der Sommerernte, erstellt für den Eintritt der Sonne in die Fische. Liefert {entry_time, chart, house_planets}.
indian_ritus	—	Die sechs indischen Jahreszeiten als echte Zeiträume. Jede umfasst einen Bogen von sechzig Grad tropischer Sonnenlänge, so gelegt, dass jede Tagundnachtgleiche und jede Sonnenwende in die Mitte oder an den Rand einer Jahreszeit fällt. Liefert eine Liste von sechs Objekten – {ritu, name, subtitle, begins, ends, tropical_zodiac, note, image_url} – in der Reihenfolge Vasant, Grishma, Varsha, Sharad, Hemant, Shishir.
jagat_lagna_chart	—	Das Welthoroskop, erstellt für den exakten Zeitpunkt, an dem die Sonne in den Widder eintritt. Liefert {ingress_time, chart, house_planets}: chart ist ein vollständiges Rashi-Horoskop in Zeichen-und-Grad-Notation mit den Abschnitten celestial, houses und ascendant; house_planets ordnet jedem Haus die Planeten zu, die darin stehen.
king_of_year	—	Der Raja des Jahres – der Planet, der den lokalen Wochentag beherrscht, auf den Chaitra Shukla Pratipada fällt. Ein einzelner englischer Planetenname. In der Mundanastrologie gibt die Natur dieses Planeten den Grundton vor, in dem das ganze Jahr gedeutet wird.
mantri_of_year	—	Der Mantri, also der Minister des Jahres: der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in den Widder fällt. Ein einzelner englischer Planetenname.
meghesha_of_year	—	Meghesha, Herrscher der Wolken: der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in Ardra fällt. Ein einzelner englischer Planetenname; er wird für den Niederschlag des Jahres herangezogen.
nakshatra_lord_effects	nakshatra	Schlägt das übergebene Nakshatra im Sapta-Nadi-Chakra nach und liefert {lord, nadi, means, effect}: den herrschenden Planeten, den Namen der Nadi, was diese Nadi bedeutet und das Wetter, für das sie herangezogen wird. Liefert null für jeden Namen, der nicht in der Tabelle steht; diese verwendet ältere Transliterationen, umfasst sechsundzwanzig Namen und lässt Poorvaashaadha und Uttaraabhaadra aus.
neersesha_of_year	—	Der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in den Steinbock fällt. Ein einzelner englischer Planetenname. Klassisch ist dieses Amt der Herrscher der Gewässer; diese API bezeichnet es in das_adhikari als Lord of Metals, und die Beschreibung folgt dem Code statt dem klassischen Sprachgebrauch.
phalesha_of_year	—	Phalesha, Herrscher der Früchte: der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in die Fische am Ende des Samvat-Jahres fällt, also im März des folgenden gregorianischen Jahres. Ein einzelner englischer Planetenname.
rasesha_of_year	—	Rasesha, Herrscher der Säfte und flüssigen Erzeugnisse: der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in die Waage fällt. Ein einzelner englischer Planetenname.
samvatsara_purusha_chakra	—	Die Körperteile, die der Jahresperson zugeordnet sind. Liefert ein statisches Objekt mit Körperteilen als Schlüsseln – 'Entire body', 'Navel', 'Heart' und 'Vitality' –, jeweils mit einer Liste nakshatras, beim letzten zusätzlich mit einem Hinweis zur Bedeutung. Die Tabelle ist unvollständig: Sie umfasst sechs Nakshatras, nicht alle siebenundzwanzig.
sapta_nadi_chakra	—	Die vollständige Wettertabelle der sieben Nadis, in der nakshatra_lord_effects nachschlägt: ein Objekt mit den sieben Planeten als Schlüsseln, jeweils {nakshatras, nadi, means, effect}. Statische Referenzdaten, bei jeder Anfrage identisch. Beachte: Einige Nakshatras stehen unter mehr als einem Planeten, und beim Nachschlagen gilt der erste Treffer.
sashyesha_of_year	—	Sasyesha, Herrscher der Ernte: der Planet, der den lokalen Wochentag (von Sonnenaufgang bis Sonnenaufgang) beherrscht, auf den der Eintritt der Sonne in den Krebs fällt. Ein einzelner englischer Planetenname; das_adhikari führt ihn als Lord of Summer Crops.
sharatsasya_chart	—	Das Horoskop der Winterernte, erstellt für den Eintritt der Sonne in die Jungfrau. Liefert {entry_time, chart, house_planets}, also dieselbe Struktur wie die anderen Horoskope der Mundanastrologie.
solstices	—	Die beiden Sonnenwenden des Jahres als Zeitpunkte. Eine Liste mit zwei Elementen – Achtung, die Reihenfolge ist nicht chronologisch: zuerst die Wintersonnenwende (Sonne bei 270 Grad, im Dezember des angefragten Jahres), dann die Sommersonnenwende (Sonne bei 90 Grad, im Juni).
vaahan_of_samvat	—	Das symbolische Fahrzeug des Jahres, abgeleitet vom König des Jahres – Horse für die Sonne, Elephant für den Mond, Ox/boat für Mars, Swing für Merkur, Boat für Jupiter, Elephant/Frog für Venus, Horse/Buffalo für Saturn. Ein einzelner String.

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/mundane/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["nakshatra_lord_effects"],"year":2025,"date_time":"2025-02-13T05:00:37.682Z","nakshatra":"Krittika","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Antwort

{
  "data": {
    "nakshatra_lord_effects": {
      "lord": "Saturn",
      "nadi": "Chandaa",
      "means": "Aggressive",
      "effect": "Heat, Wind"
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Aus einem echten Aufruf mit genau dieser Anfrage. Die Ergebnisse stehen unter data, jeweils unter dem Key, den du angefordert hast.

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.