POST/api/astro/chart_analysis/1 Credit

Horoskopanalyse

Vierzehn strukturelle Auswertungen eines Geburtshoroskops in einem Aufruf, dazu ein Vergleich zwischen Geburts- und Transithoroskop. Das ist die Deutungsebene über /api/astro/chart/: Du erhältst keine Positionen, sondern das, was diese Positionen ergeben. Die Antwort enthält immer dieselben Felder. `house_from_reference_chart` gibt an, in welches Haus `target_celestial` im Transithoroskop fällt, gezählt ab `ref_celestial` im Geburtshoroskop. `kendras` gruppiert die Radixkörper nach Eckhäusern. `argala` und `virodhargala` liefern für jeden Himmelskörper die eingreifenden bzw. behindernden Planeten, mit dem 2., 4., 5. und 11. Haus bzw. dem 12., 10., 9. und 3. Haus als Schlüsseln. `bhava_arudhas` und `ghara_arudhas` sind die projizierten Abbilder der Häuser und der Planeten. `temporary_relationships` und `compound_relationships` sind die Freundschaften in diesem konkreten Horoskop. `karakas` sind die Chara-Karakas, `nakshatra_count` der Nakshatra-Abstand vom Referenzkörper, und `exaltation`, `debilitation`, `mooltrikona`, `own_rashi` und `pachakadi_relations` prüfen die Würden. Beide Horoskope sind immer Rashi-Horoskope: `chart_name_natal` und `chart_name_transit` sind trotz ihrer Namen nur Freitext-Labels und wählen kein Teilhoroskop aus. `mode` wählt acht oder sieben Chara-Karakas, und `rahu` wählt wahre oder mittlere Mondknoten – nur für den Karaka-Block. `ref_celestial` darf 'ascendant' sein; dann sind die beiden Beziehungsfelder null, weil sie per Definition nur zwischen Planeten gelten.

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

Feld	Typ	Pflicht	Hinweise
chart_name_natal	string	Pflicht	FREITEXT-Label, KEINE Auswahl des Horoskoptyps. Trotz des Namens erstellt dieser Endpoint immer ein RashiChart; der String dient nur als Anzeigelabel und wird nie validiert. Jeder nicht leere String ist zulässig.
chart_name_transit	string	Pflicht	FREITEXT-Label, KEINE Auswahl des Horoskoptyps. Wie chart_name_natal.
date_time_natal	string (date-time)	Pflicht	FORMATVORGABE. DRF DateTimeField: nur ISO-8601 (Standard-Eingabeformate von DRF), z. B. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" oder "2026-09-01 06:00:00" (ohne Zeitzone wird UTC angenommen).
date_time_transit	string (date-time)	Pflicht	FORMATVORGABE. DRF DateTimeField: nur ISO-8601 (Standard-Eingabeformate von DRF), z. B. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" oder "2026-09-01 06:00:00" (ohne Zeitzone wird UTC angenommen).
latitude_natal	number (double)	Pflicht	min -180 · max 180
latitude_transit	number (double)	Pflicht	min -180 · max 180
longitude_natal	number (double)	Pflicht	min -180 · max 180
longitude_transit	number (double)	Pflicht	min -180 · max 180
mode	integer	Pflicht	`78` Ganzzahl, kein String, aber mit festen Werten: 8 = acht Chara-Karakas (mit Pitri Karaka und Rahu), 7 = sieben Karakas (ohne Rahu). Nur 7 und 8 sind sinnvoll.
rahu	string	Pflicht	`truemean` Groß-/Kleinschreibung wird beachtet; nur Kleinbuchstaben. Nur 'true' wird explizit geprüft; jeder andere Wert (einschließlich 'mean') landet im else-Zweig und verhält sich wie 'mean'. Betrifft nur den Block `karakas`.
ref_celestial	string	Pflicht	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannode` Groß-/Kleinschreibung wird beachtet; nur Kleinbuchstaben. 'ascendant' funktioniert für house_from_reference_chart und nakshatra_count; bei ref_celestial='ascendant' sind die Felder temporary_relationships und compound_relationships absichtlich null. Ein unbekannter Name liefert 400 (KeyError).
target_celestial	string	Pflicht	`sunmoonmercuryvenusmarsjupitersaturnuranusneptuneplutonorthtruenodenorthmeannode` Dieselben Werte wie ref_celestial.
bhava_arudha_exceptions	boolean	optional
graha_arudha_exceptions	boolean	optional
nakshatras	string	optional

Beispielanfrage

curl -X POST https://api.occultapi.com/api/astro/chart_analysis/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time_natal":"2025-11-21T05:45:23.715Z","date_time_transit":"2024-11-21T05:45:23.715Z","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":"mercury","target_celestial":"mars","rahu":"true","mode":0}'

Antwort

{
  "_truncated": true,
  "_note": "Response shortened for the catalogue.",
  "preview": "{\"data\": {\"house_from_reference_chart\": {\"house_from_ref\": 9, \"zodiac_sign_in_ref\": \"Cn\"}, \"kendras\": [[\"venus\", \"jupiter\", \"pluto\"], [\"sun\", \"moon\", \"mercury\", \"mars\", \"uranus\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], [\"saturn\", \"neptune\"]], \"argala\": {\"sun\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"moon\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"mercury\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"venus\": {\"2\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"4\": [\"pluto\"], \"5\": [\"northtruenode\", \"northmeannode\"], \"11\": [\"southtruenode\", \"southmeannode\"]}, \"mars\": {\"2\": null, \"4\": [\"northtruenode\", \"northmeannode\"], \"5\": [\"saturn\", \"neptune\"], \"11\": null}, \"jupiter\": {\"2\": [\"southtruenode\", \"southmeannode\"], \"4\": [\"venus\"], \"5\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"11\": [\"uranus\"]}, \"saturn\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"uranus\": {\"2\": null, \"4\": [\"southtruenode\", \"southmeannode\"], \"5\": null, \"11\": [\"saturn\", \"neptune\"]}, \"neptune\": {\"2\": null, \"4\": null, \"5\": [\"jupiter\"], \"11\": [\"pluto\"]}, \"pluto\": {\"2\": [\"northtruenode\", \"northmeannode\"], \"4\": null, \"5\": [\"uranus\"], \"11\": [\"sun\", \"moon\", \"mercury\", \"mars\"]}, \"northtruenode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"northmeannode\": {\"2\": [\"saturn\", \"neptune\"], \"4\": [\"uranus\"], \"5\": null, \"11\": null}, \"southtruenode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}, \"southmeannode\": {\"2\": null, \"4\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"5\": null, \"11\": null}}, \"virodhargala\": {\"sun\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"moon\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"mercury\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"venus\": {\"3\": null, \"9\": null, \"10\": [\"jupiter\"], \"12\": null}, \"mars\": {\"3\": [\"pluto\"], \"9\": [\"jupiter\"], \"10\": [\"southtruenode\", \"southmeannode\"], \"12\": [\"venus\"]}, \"jupiter\": {\"3\": null, \"9\": [\"saturn\", \"neptune\"], \"10\": null, \"12\": null}, \"saturn\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"uranus\": {\"3\": [\"jupiter\"], \"9\": [\"pluto\"], \"10\": [\"northtruenode\", \"northmeannode\"], \"12\": null}, \"neptune\": {\"3\": [\"uranus\"], \"9\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"10\": null, \"12\": [\"northtruenode\", \"northmeannode\"]}, \"pluto\": {\"3\": [\"saturn\", \"neptune\"], \"9\": null, \"10\": [\"venus\"], \"12\": null}, \"northtruenode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"northmeannode\": {\"3\": null, \"9\": [\"venus\"], \"10\": [\"sun\", \"moon\", \"mercury\", \"mars\"], \"12\": [\"pluto\"]}, \"southtruenode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}, \"southmeannode\": {\"3\": [\"venus\"], \"9\": null, \"10\": [\"uranus\"], \"12\": [\"jupiter\"]}}, \"bhava_arudhas\": {\"A1\": \"Taurus\", \"A2\": \"Aries\", \"A3\": \"Scorpio\", \"A4\": \"Gemini\", \"A5\": \"Pisces\", \"A6\": \"Aries\", \"A7\": \"Pisces\", \"A8\": \"Scorpio\", \"A9\": \"Capricorn\", \"A10\": \"Cancer\", \"A11\": \"Leo\", \"A12\": \"Aquarius\"}, \"ghara_arudhas\": {\"A1\": \"Leo\", \"A2\": \"Leo\", \"A3\": \"Leo\", \"A4\": \"Cancer\", \"A5\": \"Leo\", \"A6\": \"Pisces\", \"A7\": \"Scorpio\", \"A8\": \"Pisces\", \"A9\": \"Scorpio\", \"A10\": \"Taurus\", \"A11\": \"Aries\", \"A12\": \"Aries\"}, \"temporary_relationships\": {\"friends\": [\"venus\", \"pluto\", \"northtruenode\", \"northmeannode\", \"southtruenode\", \"southmeannode\"], \"enemies\": [\"sun\", \"moon\", \"mars\", \"jupiter\", \"saturn\", \"uranus\", \"neptune\"]}, \"compound_relationships\": \"Satru\", \"karakas\": {\"ak\": {\"venus\": {\"degree\": 23, \"sign\": \"Li\", \"minutes\": 42, \"seconds\": 43}}, \"amk\": {\"mars\": {\"degree\": 17, \"sign\": \"Sc\", \"minutes\": 52, \"seconds\": 44}}, \"bk\": {\"moon\": {\"degree\": 15, \"sign\": \"Sc\", \"minutes\": 20, \"seconds\": 27}}, \"mk\": {\"northtruenode\""
}

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.