Direkt zum Inhalt
POST/api/astro/mundane-charts/1 Credit

Ingress-Horoskope der Mundanastrologie

Die Ingress-Horoskope, nach denen ein vedisches Jahr beurteilt wird. Das Welt-Aszendenten-Horoskop zum Sonnen-Ingress, das Ardra-Pravesh-Horoskop für den Monsun und die Ernte-Horoskope für Sommer und Herbst. Jedes enthält den genauen Zeitpunkt, für den es erstellt wird, und sämtliche Planetenpositionen zu diesem Zeitpunkt – aus genau diesen Horoskopen werden die Jahresvorhersagen der Almanache gedeutet. Eine große Antwort: vier vollständige Horoskope und eine Ingress-Zeit.

https://api.occultapi.com/api/astro/mundane-charts/
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.

latitudenumber (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

longitudenumber (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

timezone_as_floatnumber (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

yearintegerPflicht

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

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.

nakshatrastringoptional

Wird nur von /nakshatra-chakras/ ausgewertet, sonst ignoriert.

Beispielanfrage

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

Antwort

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"year\": 2025, \"charts\": [{\"chart\": \"jagat_lagna_chart\", \"describes\": \"World ascendant chart, cast at the solar ingress\", \"result\": {\"ingress_time\": \"2025-04-13T21:51:25Z\", \"chart\": {\"celestial\": {\"sun\": {\"longitude\": {\"degree\": 0, \"sign\": \"Ar\", \"minutes\": 0, \"seconds\": 0}, \"latitude\": -0.0, \"nakshatra\": \"Ashwini\", \"pada\": 1, \"kakshya\": \"saturn\", \"zodiac_name\": \"Aries\", \"house\": 3}, \"moon\": {\"longitude\": {\"degree\": 9, \"sign\": \"Li\", \"minutes\": 42, \"seconds\": 32}, \"latitude\": -3.122, \"nakshatra\": \"Swaati\", \"pada\": 1, \"kakshya\": \"mars\", \"zodiac_name\": \"Libra\", \"house\": 9}, \"mercury\": {\"longitude\": {\"degree\": 4, \"sign\": \"Pi\", \"minutes\": 22, \"seconds\": 15}, \"latitude\": -1.443, \"nakshatra\": \"Uttaraabhaadra\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"venus\": {\"longitude\": {\"degree\": 0, \"sign\": \"Pi\", \"minutes\": 25, \"seconds\": 44}, \"latitude\": 4.46, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"mars\": {\"longitude\": {\"degree\": 4, \"sign\": \"Cn\", \"minutes\": 4, \"seconds\": 4}, \"latitude\": 2.355, \"nakshatra\": \"Pushyami\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Cancer\", \"house\": 6}, \"jupiter\": {\"longitude\": {\"degree\": 23, \"sign\": \"Ta\", \"minutes\": 55, \"seconds\": 8}, \"latitude\": -0.276, \"nakshatra\": \"Mrigasira\", \"pada\": 1, \"kakshya\": \"moon\", \"zodiac_name\": \"Taurus\", \"house\": 4}, \"saturn\": {\"longitude\": {\"degree\": 1, \"sign\": \"Pi\", \"minutes\": 47, \"seconds\": 31}, \"latitude\": -1.959, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"uranus\": {\"longitude\": {\"degree\": 1, \"sign\": \"Ta\", \"minutes\": 10, \"seconds\": 37}, \"latitude\": -0.219, \"nakshatra\": \"Krittika\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Taurus\", \"house\": 4}, \"neptune\": {\"longitude\": {\"degree\": 6, \"sign\": \"Pi\", \"minutes\": 19, \"seconds\": 1}, \"latitude\": -1.269, \"nakshatra\": \"Uttaraabhaadra\", \"pada\": 1, \"kakshya\": \"jupiter\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"pluto\": {\"longitude\": {\"degree\": 9, \"sign\": \"Cp\", \"minutes\": 30, \"seconds\": 25}, \"latitude\": -3.489, \"nakshatra\": \"Uttaraashaadha\", \"pada\": 4, \"kakshya\": \"mars\", \"zodiac_name\": \"Capricorn\", \"house\": 12}, \"northtruenode\": {\"longitude\": {\"degree\": 3, \"sign\": \"Pi\", \"minutes\": 4, \"seconds\": 22}, \"latitude\": -0.0, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"northmeannode\": {\"longitude\": {\"degree\": 1, \"sign\": \"Pi\", \"minutes\": 50, \"seconds\": 16}, \"latitude\": 0.0, \"nakshatra\": \"Poorvaabhaadra\", \"pada\": 4, \"kakshya\": \"saturn\", \"zodiac_name\": \"Pisces\", \"house\": 2}, \"southtruenode\": {\"longitude\": {\"degree\": 3, \"sign\": \"Vi\", \"minutes\": 4, \"seconds\": 22}, \"latitude\": -0.0, \"nakshatra\": \"Uttara Phalguni\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Virgo\", \"house\": 8}, \"southmeannode\": {\"longitude\": {\"degree\": 1, \"sign\": \"Vi\", \"minutes\": 50, \"seconds\": 16}, \"latitude\": 0.0, \"nakshatra\": \"Uttara Phalguni\", \"pada\": 2, \"kakshya\": \"saturn\", \"zodiac_name\": \"Virgo\", \"house\": 8}}, \"houses\": {\"1\": {\"start\": \"18 Cp 10 4\", \"cusp\": \"3 Aq 10 4\", \"end\": \"18 Aq 10 4\"}, \"2\": {\"start\": \"18 Aq 10 4\", \"cusp\": \"3 Pi 10 4\", \"end\": \"18 Pi 10 4\"}, \"3\": {\"start\": \"18 Pi 10 4\", \"cusp\": \"3 Ar 10 4\", \"end\": \"18 Ar 10 4\"}, \"4\": {\"start\": \"18 Ar 10 4\", \"cusp\": \"3 Ta 10 4\", \"end\": \"18 Ta 10 4\"}, \"5\": {\"start\": \"18 Ta 10 4\", \"cusp\": \"3 Ge 10 4\", \"end\": \"18 Ge 10 4\"}, \"6\": {\"start\": \"18 Ge 10 4\", \"cusp\": \"3 Cn 10 4\", \"end\": \"18 Cn 10 4\"}, \"7\": {\"start\": \"18 Cn 10 4\", \"cusp\": \"3 Le 10 4\", \"end\": \"18 Le 10 4\"}, \"8\": {\"start\": \"18 Le 10 4\", \"cusp\": \"3 Vi 10 4\", \"end\": \"18 Vi 10 4\"}, \"9\": {\"start\": \"18 Vi 10 4\", \"cusp\": \"3 Li 10 4\", \"end\": \"18 Li 10 4\"}, \"10\": {\"start\": \"18 Li 10 4\", \"cusp\": \"3 Sc 10 4\", \"end\": \"18 Sc 10 4\"}, \"11\": {\"start\": \"18 Sc 10 4\", \"cusp\": \"3 Sg 10 4\", \"end\": \"18 Sg 10 4\"}, \"12\": {\"start\": \"18 Sg 10 4\", \"cusp\": \"3 Cp 10 4\", \"end\": \"18 Cp 10 4\"}}, \"ascendant\": {\"longitude\": {\"degree\": 3, \"sign\": \"Aq\", \"minutes\": 10, \"seconds\": 4}, \"zodia"
}

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.