Загружаем песочницу
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"}'Сидерические позиции девяти грах для заданного момента и места: долгота, знак, накшатра, пада и дом каждой, а также асцендент и фактически применённая аянамша. Планеты возвращаются СПИСКОМ в традиционном порядке, с `name` в каждой записи, а не вложенными под названием карты с ключами по планетам, так что их можно сразу перебирать в цикле или выводить таблицей. Эндпоинт построен на основе /api/astro/chart/, который при каждом вызове требует chart_name, notation, ayanamsa и ascendant_pos. Здесь у них есть значения по умолчанию — RashiChart, degree, LAHIRI и cusp, — так что достаточно передать дату и место. `ayanamsa` всё же стоит выбирать осознанно: она сдвигает все долготы в ответе, а Lahiri и Raman различаются примерно на градус — этого хватает, чтобы планета оказалась в другой накшатре. Здесь принимаются все 48 аянамш, которые поддерживает эндпоинт карты.
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| chart_name | string | обязательный | |
| datetime | string (date-time) | обязательный | Момент расчёта в формате ISO 8601. ВСЕГДА указывайте смещение или суффикс Z: значение без часового пояса интерпретируется как Asia/Kolkata (UTC+05:30), а не UTC. То же, что date_time: другие эндпоинты называют это поле иначе. |
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -89.9 · max 89.9 |
| longitude | number (double) | обязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180 |
| aberration | boolean | необязательный | |
| apply_correction | boolean | необязательный | |
| ascendant_pos | string | необязательный | cuspstartend |
| ayanamsa | string | необязательный | |
| background_color | string | необязательный | Hex-цвет фона SVG. |
| chart_style | string | необязательный | Стиль диаграммы при render='svg'. 'north' — ромбовидная схема с фиксированными домами и смещающимися знаками; 'south' — сетка с фиксированными знаками и смещающимися домами. northsouth |
| correction_deg | integer | необязательный | min 0 |
| correction_direction | string | необязательный | addsubtract |
| correction_min | integer | необязательный | min 0 · max 59 |
| correction_sec | integer | необязательный | min 0 · max 59 |
| extended_bodies | array | необязательный | Какие группы тел включить: 'asteroids', 'planetary_moons', 'fictitious_bodies'. |
| label_style | string | необязательный | Как подписываются планеты: 'english' (Su, Mo, ...), 'sanskrit' (Surya, Chandra, ...) или 'symbol' (☉, ☽, ...). englishsanskritsymbol |
| line_color | string | необязательный | Hex-цвет линий сетки карты. |
| notation | string | необязательный | astrologicaldegree |
| nutation | boolean | необязательный | |
| planet_color | string | необязательный | Hex-цвет подписей планет, например '#111827'. По умолчанию — собственный цвет темы. |
| rahu | string | необязательный | Какие узлы включить. 'true' — только истинные узлы, 'mean' — только средние, 'both' — оба типа. truemeanboth |
| refraction | boolean | необязательный | |
| render | string | необязательный | Укажите 'svg', чтобы дополнительно получить отрисованную диаграмму карты (см. chart_style) и лежащую в её основе геометрию. Если параметр не передавать, ответ не изменится. nonesvg |
| show_degrees | boolean | необязательный | Показывать рядом с подписью каждого тела его градус в знаке. |
| sign_color | string | необязательный | Hex-цвет номеров и сокращений знаков. |
| svg_size | integer | необязательный | Ширина и высота квадратного SVG viewBox в пикселях. min 100 · max 2000 |
| theme | string | необязательный | lightdark |
| true_mean | string | необязательный | TrueMean |
| use_28_nakshatras | boolean | необязательный |