curl -X POST https://api.occultapi.com/api/astro/ashtakvarga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["samudhaya_ashtaka_varga"],"latitude":26.1046,"longitude":74.319,"timezone_as_float":5.5,"chart_name":"RashiChart","date_time":"2026-09-01T06:00:00+05:30"}'Аштакаварга оцінює кожен знак карти за шкалою до восьми балів. Сім планет і восьме джерело балів голосують за всі дванадцять знаків: знак із великою кількістю балів підтримує справи, якими він відає, а знак із малою — ні. Це стандартний ведичний спосіб визначити, які доми й транзити справді варто брати до уваги, не тлумачачи карту самостійно. Усі ключі тут повертають числа, а не текст. Типовий сценарій: `samudhaya_ashtaka_varga`, щоб швидко впорядкувати дванадцять знаків за силою, а потім `binna_ashtaka_varga` для потрібної планети — напр. бали Юпітера в знаку, яким він зараз проходить транзитом. Примітка щодо восьмого рядка: у таблицях за знаками він називається `Rahu`, а в таблицях за домами (`trikona_sodhana_house`, `ekadhipatya_sodhana_house`) той самий рядок називається `Ascendant`. За класикою це джерело балів — асцендент. Якщо читаєте обидва види таблиць, орієнтуйтеся на позицію рядка, а не на назву. Таблиці будуються за дробовою картою з `chart_name`, зазвичай RashiChart. На арифметику впливають два поля запиту: `apply_ekadhipatya_reductions` і `use_eight_ashtakavargas_in_sav`. Класичні джерела розходяться щодо обох, тож значення обираєте ви.
| Поле | Тип | Обов’язкове | Примітки |
|---|---|---|---|
| chart_name | string | обов’язковий | BhavaChartRashiChartHoraChartJagannathHoraChartParivrittidwayaHoraChartParivrittitrayaDrekkanaChartDrekkanaChartSomnathDrekkanaChartJagannathDrekkanaChartChaturthamsaChartPanchamsaChartShashthamsaChartУ цьому поданні немає явного списку (на відміну від /api/astro/chart/), тому тут «ймовірно», а не «напевно». З урахуванням регістру; для невідомої назви повертається "Item '<x>' is not supported". На практиці аштакаваргу обчислюють для 'RashiChart'. |
| date_time | string (date-time) | обов’язковий | Момент, для якого виконується розрахунок, у форматі ISO 8601. ЗАВЖДИ вказуйте зміщення або Z у кінці: значення без часового поясу читається як Asia/Kolkata (UTC+05:30), а не UTC, і може повернути результат за попередній день із кодом 200. '2026-09-01T06:00:00Z' і '2026-09-01 06:00:00' — різні моменти, і відповіді для них різні. Обмеження ФОРМАТУ, а не перелік значень. DRF DateTimeField: лише ISO-8601 (типові формати введення DRF), напр. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" або "2026-09-01 06:00:00" (без часового поясу вважається UTC). |
| keys | array | обов’язковий | Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. binna_ashtaka_vargasamudhaya_ashtaka_vargaprastara_ashtaka_vargatrikona_sodhana_rashitrikona_sodhana_houseekadhipatya_sodhana_rashia_ashtaka_vargaekadhipatya_sodhana_housepindas |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14 |
| apply_ekadhipatya_reductions | boolean | необов’язковий | |
| latitude | number (double) | необов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -89.9 · max 89.9 |
| longitude | number (double) | необов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| use_eight_ashtakavargas_in_sav | boolean | необов’язковий |
Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.
| Ключ | Додаткові поля | Опис | |
|---|---|---|---|
| binna_ashtaka_varga | — | Бхіннаштакаварга: по рядку на кожне джерело балів, у кожному рядку дванадцять чисел від 0 до 8. Рядки: Сонце, Місяць, Марс, Меркурій, Юпітер, Венера, Сатурн і восьмий, підписаний `Rahu`; дванадцять значень ідуть від Овна до Риб. Значення 3 у рядку `Sun` означає, що варга Сонця дає Овну 3 бали. Саме з цієї таблиці починається більшість тлумачень. | |
| ekadhipatya_sodhana_house | — | Та сама повністю редукована таблиця, але зсунута так, щоб першим ішов знак асцендента, а не Овен. Числа ті самі, що й у `ekadhipatya_sodhana_rashia_ashtaka_varga`, лише впорядковані за домами. Восьмий рядок тут підписано `Ascendant`, а в таблиці за знаками — `Rahu`. | |
| ekadhipatya_sodhana_rashia_ashtaka_varga | — | Бхіннаштакаварга після обох редукцій: спершу трікона, потім екадхіпатья, яка скорочує бали у двох знаках, що мають одного володаря. Ключі — планети, у кожної дванадцять значень від Овна до Риб. Саме з цієї таблиці обчислюються пінди. | |
| pindas | — | Три підсумкові зважені величини, по сім чисел у кожній — по одному на планету від Сонця до Сатурна, без восьмого рядка. `raasi_pindas` зважує редуковані бали за знаками, `graha_pindas` — за положеннями самих планет, а `sodhya_pindas` — сума цих двох. Саме содх’я-піндою класичні тексти оцінюють загальну силу планети, тож якщо вам потрібне одне число, беріть її. | |
| prastara_ashtaka_varga | — | Хід обчислення бхіннаштакаварги: для кожної планети видно, яке з восьми джерел дало який бал. Два рівні вкладення: планета, у ній джерело балів, у ньому дванадцять значень. Ця таблиця більша за інші й знадобиться, лише якщо ви показуєте, як отримано результат, а не тільки сам результат. | |
| samudhaya_ashtaka_varga | — | Сарваштакаварга: підсумки, по одному числу на знак, з ключами від `Raasi 1` до `Raasi 12` (від Овна до Риб). Кожне число — сума балів усіх планет у цьому знаку, тож за класичною схемою дванадцять чисел у сумі дають 337. Використовуйте її, щоб одним викликом упорядкувати знаки за силою. | |
| trikona_sodhana_house | — | Та сама таблиця після трікона-редукції, але зсунута так, щоб першим ішов знак асцендента, а не Овен. Числа ті самі, що й у `trikona_sodhana_rashi`, лише впорядковані за домами. Зручна, коли ви розкладаєте доми від 1 до 12. Восьмий рядок тут підписано `Ascendant`, а в таблиці за знаками той самий рядок підписано `Rahu`. | |
| trikona_sodhana_rashi | — | Бхіннаштакаварга після трікона-редукції (за тригонами) — першої з двох класичних редукцій, які виконують перед обчисленням пінд. Ключі — планети, у кожної дванадцять значень від Овна до Риб. |