Перейти до вмісту
POST/api/astro/ashtakvarga/1 кредит

Аштакаварга

Аштакаварга оцінює кожен знак карти за шкалою до восьми балів. Сім планет і восьме джерело балів голосують за всі дванадцять знаків: знак із великою кількістю балів підтримує справи, якими він відає, а знак із малою — ні. Це стандартний ведичний спосіб визначити, які доми й транзити справді варто брати до уваги, не тлумачачи карту самостійно. Усі ключі тут повертають числа, а не текст. Типовий сценарій: `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`. Класичні джерела розходяться щодо обох, тож значення обираєте ви.

https://api.occultapi.com/api/astro/ashtakvarga/
Спробувати запит

Автентифікація

Передавайте ключ у заголовку X-API-Key. Ключ — це серверні облікові дані: ніколи не вставляйте його в JavaScript, що виконується в браузері, чи в мобільний застосунок.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

Поля запиту

ПолеТипОбов’язковеПримітки
chart_namestringобов’язковий
BhavaChartRashiChartHoraChartJagannathHoraChartParivrittidwayaHoraChartParivrittitrayaDrekkanaChartDrekkanaChartSomnathDrekkanaChartJagannathDrekkanaChartChaturthamsaChartPanchamsaChartShashthamsaChart

У цьому поданні немає явного списку (на відміну від /api/astro/chart/), тому тут «ймовірно», а не «напевно». З урахуванням регістру; для невідомої назви повертається "Item '<x>' is not supported". На практиці аштакаваргу обчислюють для 'RashiChart'.

date_timestring (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).

keysarrayобов’язковий

Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами.

binna_ashtaka_vargasamudhaya_ashtaka_vargaprastara_ashtaka_vargatrikona_sodhana_rashitrikona_sodhana_houseekadhipatya_sodhana_rashia_ashtaka_vargaekadhipatya_sodhana_housepindas
timezone_as_floatnumber (double)обов’язковий

Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення.

min -12 · max 14

apply_ekadhipatya_reductionsbooleanнеобов’язковий
latitudenumber (double)необов’язковий

Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси.

min -89.9 · max 89.9

longitudenumber (double)необов’язковий

Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї.

min -180 · max 180

use_eight_ashtakavargas_in_savbooleanнеобов’язковий

Доступні ключі (8)

Перелічіть у 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—Бхіннаштакаварга після трікона-редукції (за тригонами) — першої з двох класичних редукцій, які виконують перед обчисленням пінд. Ключі — планети, у кожної дванадцять значень від Овна до Риб.

Приклад запиту

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"}'

Відповідь

{
  "data": {
    "samudhaya_ashtaka_varga": {
      "Raasi 1": 28,
      "Raasi 2": 36,
      "Raasi 3": 40,
      "Raasi 4": 25,
      "Raasi 5": 24,
      "Raasi 6": 23,
      "Raasi 7": 26,
      "Raasi 8": 25,
      "Raasi 9": 28,
      "Raasi 10": 34,
      "Raasi 11": 25,
      "Raasi 12": 23
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data під тими ключами, які ви запитали.

Помилки

Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.