Playground lädt
curl -X POST https://api.occultapi.com/api/astro/planet-positions/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"datetime":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873,"ayanamsa":"LAHIRI"}'Siderische Positionen der neun Grahas für einen Zeitpunkt und einen Ort: Länge, Zeichen, Nakshatra, Pada und Haus jedes Grahas, dazu der Aszendent und das tatsächlich angewandte Ayanamsa. Die Planeten kommen als LISTE in traditioneller Reihenfolge zurück, jeder Eintrag mit `name` – nicht verschachtelt unter einem Horoskopnamen und mit Planeten als Schlüsseln. Du kannst also direkt darüber iterieren oder eine Tabelle rendern. Abgeleitet von /api/astro/chart/, das bei jedem Aufruf chart_name, notation, ayanamsa und ascendant_pos verlangt. Hier sind diese standardmäßig RashiChart, degree, LAHIRI und cusp – du sendest nur ein Datum und einen Ort. `ayanamsa` solltest du trotzdem bewusst setzen: Es verschiebt jede Länge in der Antwort, und Lahiri und Raman liegen etwa ein Grad auseinander – genug, um einen Planeten in ein anderes Nakshatra zu verschieben. Alle 48 Ayanamsas, die der Horoskop-Endpoint unterstützt, werden auch hier akzeptiert.
| Feld | Typ | Pflicht | Hinweise |
|---|---|---|---|
| chart_name | string | Pflicht | |
| datetime | 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. Bedeutet dasselbe wie date_time; andere Endpoints verwenden für dasselbe Feld nur einen anderen Namen. |
| 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 -89.9 · max 89.9 |
| 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 |
| aberration | boolean | optional | |
| apply_correction | boolean | optional | |
| ascendant_pos | string | optional | cuspstartend |
| ayanamsa | string | optional | |
| background_color | string | optional | Hex-Farbe für den SVG-Hintergrund. |
| chart_style | string | optional | Diagrammstil bei render='svg'. 'north' ist das Rautenlayout mit festen Häusern und wandernden Zeichen; 'south' ist das Raster mit festen Zeichen und wandernden Häusern. northsouth |
| correction_deg | integer | optional | min 0 |
| correction_direction | string | optional | addsubtract |
| correction_min | integer | optional | min 0 · max 59 |
| correction_sec | integer | optional | min 0 · max 59 |
| extended_bodies | array | optional | Welche Gruppen von Himmelskörpern einbezogen werden: 'asteroids', 'planetary_moons', 'fictitious_bodies'. |
| label_style | string | optional | Wie die Planeten beschriftet werden: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) oder 'symbol' (☉, ☽, ...). englishsanskritsymbol |
| line_color | string | optional | Hex-Farbe für die Rasterlinien des Horoskops. |
| notation | string | optional | astrologicaldegree |
| nutation | boolean | optional | |
| planet_color | string | optional | Hex-Farbe für die Planetenbeschriftungen, z. B. '#111827'. Standardmäßig die Farbe des Themes. |
| rahu | string | optional | Welche Mondknoten einbezogen werden. 'true' liefert nur die wahren, 'mean' nur die mittleren Mondknoten, 'both' liefert beide. truemeanboth |
| refraction | boolean | optional | |
| render | string | optional | Setze den Wert auf 'svg', um zusätzlich ein gerendertes Horoskopdiagramm (siehe chart_style) samt der zugrunde liegenden Geometrie zu erhalten. Lässt du das Feld ganz weg, bleibt die Antwort unverändert. nonesvg |
| show_degrees | boolean | optional | Zeigt neben der Beschriftung jedes Himmelskörpers seinen Grad im Zeichen an. |
| sign_color | string | optional | Hex-Farbe für Zeichennummern/-abkürzungen. |
| svg_size | integer | optional | Breite und Höhe der quadratischen SVG-viewBox in Pixeln. min 100 · max 2000 |
| theme | string | optional | lightdark |
| true_mean | string | optional | TrueMean |
| use_28_nakshatras | boolean | optional |