Завантаження 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"}'Сидеричні положення дев’яти грах для моменту й місця: довгота, знак, накшатра, пада й дім для кожної, а також асцендент і фактично застосована аянамша. Планети повертаються СПИСКОМ у традиційному порядку з `name` у кожному записі, а не вкладеними під назвою карти з ключами за планетами, тож їх можна одразу перебирати або виводити таблицею. Ендпоінт побудовано на основі /api/astro/chart/, який вимагає chart_name, notation, ayanamsa і ascendant_pos у кожному виклику. Тут вони мають значення за замовчуванням RashiChart, degree, LAHIRI і cusp — досить надіслати дату й місце. `ayanamsa` усе ж варто задавати свідомо: вона зсуває кожну довготу у відповіді, а Лахірі й Раман відрізняються приблизно на градус — цього досить, щоб планета опинилася в іншій накшатрі. Тут приймаються всі 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 | необов’язковий | Колір фону SVG у форматі hex. |
| 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 | необов’язковий |