Chargement du Playground
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"}'Positions sidérales des neuf grahas pour un moment et un lieu : longitude, signe, nakshatra, pada et maison pour chacun, ainsi que l’ascendant et l’ayanamsa réellement appliqué. Les planètes sont renvoyées sous forme de LISTE dans l’ordre traditionnel, avec `name` sur chaque entrée, au lieu d’être imbriquées sous un nom de thème et indexées par planète : vous pouvez donc les parcourir ou les afficher directement dans un tableau. Cet endpoint dérive de /api/astro/chart/, qui exige chart_name, notation, ayanamsa et ascendant_pos à chaque appel. Ici, ces champs valent par défaut RashiChart, degree, LAHIRI et cusp - envoyez simplement une date et un lieu. Choisissez tout de même `ayanamsa` en connaissance de cause : il décale toutes les longitudes de la réponse, et Lahiri et Raman diffèrent d’environ un degré, assez pour faire passer une planète dans un autre nakshatra. Les 48 ayanamsas pris en charge par l’endpoint du thème sont tous acceptés ici.
| Champ | Type | Obligatoire | Remarques |
|---|---|---|---|
| chart_name | string | obligatoire | |
| datetime | string (date-time) | obligatoire | Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC. Même signification que date_time, que d’autres endpoints désignent sous un autre nom. |
| latitude | number (double) | obligatoire | Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -89.9 · max 89.9 |
| longitude | number (double) | obligatoire | Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180 |
| aberration | boolean | facultatif | |
| apply_correction | boolean | facultatif | |
| ascendant_pos | string | facultatif | cuspstartend |
| ayanamsa | string | facultatif | |
| background_color | string | facultatif | Couleur hexadécimale de l’arrière-plan SVG. |
| chart_style | string | facultatif | Style de diagramme lorsque render='svg'. 'north' est la disposition en losange, avec maisons fixes et signes tournants ; 'south' est la grille à signes fixes, avec maisons tournantes. northsouth |
| correction_deg | integer | facultatif | min 0 |
| correction_direction | string | facultatif | addsubtract |
| correction_min | integer | facultatif | min 0 · max 59 |
| correction_sec | integer | facultatif | min 0 · max 59 |
| extended_bodies | array | facultatif | Groupes de corps à inclure : 'asteroids', 'planetary_moons', 'fictitious_bodies'. |
| label_style | string | facultatif | Manière de libeller les planètes : 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) ou 'symbol' (☉, ☽, ...). englishsanskritsymbol |
| line_color | string | facultatif | Couleur hexadécimale des lignes de la grille du thème. |
| notation | string | facultatif | astrologicaldegree |
| nutation | boolean | facultatif | |
| planet_color | string | facultatif | Couleur hexadécimale des libellés des planètes, p. ex. '#111827'. Par défaut : la couleur propre au thème visuel. |
| rahu | string | facultatif | Type de nœud à inclure. 'true' ne renvoie que les nœuds vrais, 'mean' que les nœuds moyens, 'both' renvoie les deux. truemeanboth |
| refraction | boolean | facultatif | |
| render | string | facultatif | Mettre à 'svg' pour renvoyer aussi un diagramme du thème rendu (voir chart_style) et la géométrie qui le sous-tend. Si vous l’omettez entièrement, la réponse reste inchangée. nonesvg |
| show_degrees | boolean | facultatif | Afficher, à côté du libellé de chaque corps, son degré dans le signe. |
| sign_color | string | facultatif | Couleur hexadécimale des numéros et abréviations des signes. |
| svg_size | integer | facultatif | Largeur et hauteur du viewBox SVG carré, en pixels. min 100 · max 2000 |
| theme | string | facultatif | lightdark |
| true_mean | string | facultatif | TrueMean |
| use_28_nakshatras | boolean | facultatif |