POST/api/astro/strength/1 кредит

Шадбала та сила планет

Шадбала, «шість сил», — класичний спосіб виразити числом, наскільки планета здатна справді дати свої результати. Шість джерел сили оцінюються окремо — положення, час, напрямок, рух, природний ранг і отримані аспекти — і підсумовуються. Сума виражається у вірупах, а шістдесят віруп становлять одну рупу; для кожної планети є поріг у рупах, який вона має подолати, і практичну відповідь дає відношення набраного до потрібного. Ендпоінт надає цю суму, усі її складові й підскладові, а також кілька пов’язаних систем оцінки сили. Почніть із `shad_bala`. Він повертає масив із дев’яти елементів: шість списків складових, далі суми у вірупах, ті самі суми в рупах і, нарешті, руп кожної планети, поділені на її мінімальну вимогу (Сонце 5, Місяць 6, Марс 5, Меркурій 7, Юпітер 6.5, Венера 5.5, Сатурн 5). Відношення понад 1 означає, що планета виконала вимогу. Усі списки із семи елементів на цьому ендпоінті йдуть у порядку Сонце, Місяць, Марс, Меркурій, Юпітер, Венера, Сатурн; усі списки з дванадцяти елементів — доми з першого по дванадцятий. Надішліть `date_time`, `latitude`, `longitude` і `timezone`. Зверніть увагу: тут поле називається `timezone`, а не `timezone_as_float`, як на більшості інших ендпоінтів. `asc_house` обов’язкове, але потрібне лише трьом ключам класифікації домів, а `planet_index`, `include_houses` і `use_epoch_table` — лише тим ключам, де вони згадані. Крім шадбали, ендпоінт містить п’ятикратну й дванадцятикратну сили Таджики, благотворний бал Ішта Пхала, показники променів Рашмі та харша-балу. Бхава-бала (сила домів, а не планет) є в списку ключів, але три її складові — нереалізовані заглушки, які повертають нулі, тож `bhava_bala` теж повертає нулі.

https://api.occultapi.com/api/astro/strength/

Спробувати запит

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

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

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

Поля запиту

Поле	Тип	Обов’язкове	Примітки
asc_house	integer	обов’язковий
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' — різні моменти, і відповіді для них різні.
keys	array	обов’язковий	Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами.
latitude	number (double)	обов’язковий	Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -90 · max 90
longitude	number (double)	обов’язковий	Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180
timezone	number (double)	обов’язковий	Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30). Означає те саме, що й timezone_as_float, — інші ендпоінти просто називають це поле інакше. min -12 · max 14
include_houses	boolean	необов’язковий
planet_index	integer	необов’язковий
use_epoch_table	boolean	необов’язковий

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

Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.

Ключ	Додаткові поля	Опис
abda_bala	—	Сила володаря року: планета, що управляє роком, отримує 15 віруп, решта — нуль. Повертає сім значень, від Сонця до Сатурна, з яких рівно одне дорівнює 15. Зверніть увагу: ця реалізація визначає володаря за днем тижня `date_time`; `abdadhipathi` обчислює володаря року класичним способом, за кількістю днів, що минули, і саме йому варто віддавати перевагу.
abdadhipathi	—	Володар року, визначений класичним способом з ахаргани — кількості днів, що минули від базової епохи, — а не за днем тижня. Планета-управитель отримує 15 віруп, решта — нуль. Повертає сім значень, від Сонця до Сатурна, з яких рівно одне дорівнює 15. Віддавайте перевагу цьому ключу, а не `abda_bala`.
apoklimas	asc_house	Чотири спадні доми — 3-й, 6-й, 9-й і 12-й, — відраховані від дому асцендента, який ви передаєте в `asc_house`. Повертає чотири цілі числа, `(asc_house + n - 1) mod 12` для n, що дорівнює 3, 6, 9 і 12, з нумерацією від 0, як у `panapharas`. Вважається, що планети тут найслабші за положенням у домі, тому кендра-бала дає їм найменше балів.
ayana_bala	—	Сила схилення — за відстанню кожної планети на північ чи на південь від небесного екватора: схилення плюс 24, помножене на 1.25, причому результат Сонця подвоюється. Повертає сім чисел у вірупах, від Сонця до Сатурна.
bhava_adhipathi_bala	—	Складова бхава-бали від володаря дому: внесок, який дім отримує від сили власного володаря. Повертає дванадцять чисел, доми з першого по дванадцятий. Наразі це нереалізована заглушка, яка повертає нулі.
bhava_bala	—	Бхава-бала — сила домів, а не планет; складається з бхава-адхіпаті-бали, бхава-діг-бали та бхава-дрік-бали. Повертає масив із трьох елементів (дванадцять значень у вірупах, ті самі значення в рупах і кожне з них, поділене на мінімум 5 руп) для домів з першого по дванадцятий. У поточному ядрі всі три складові — нереалізовані заглушки, тож усі значення тут поки що нульові.
bhava_dig_bala	—	Напрямкова складова бхава-бали: сила, яку дім отримує, коли справи, якими він опікується, відповідають напрямку, у якому він розташований. Повертає дванадцять чисел, доми з першого по дванадцятий. Наразі це нереалізована заглушка, яка повертає нулі.
bhava_drik_bala	—	Аспектна складова бхава-бали: баланс благотворних і шкідливих аспектів, що падають на кожен дім. Повертає дванадцять чисел, доми з першого по дванадцятий. Наразі це нереалізована заглушка, яка повертає нулі.
bhava_madhya	—	Дванадцять бхава-мадх’я — середин домів, обчислених із куспідів Плацидуса в сидеричній довготі. Повертає дванадцять чисел у градусах від 0 до 360, починаючи з першого дому. Використовується в розрахунку діг-бали; знадобиться й окремо, якщо вам потрібні середини домів, а не куспіди.
cheshta_bala	—	Сила руху, четверта з шести складових: різниця між сігхроччею планети та середнім арифметичним її істинної й середньої довгот, поділена на три. Вона висока, коли планета повільна, стаціонарна чи ретроградна, і низька, коли планета стрімко рухається вперед. Повертає сім чисел у вірупах; для Сонця й Місяця завжди 0, бо вони ніколи не бувають ретроградними.
cheshta_bala_new	use_epoch_table	Друга реалізація сили руху: середні довготи обчислюються від епохи Удджайн 1900, а не з ефемерид. Передайте `use_epoch_table` true, щоб брати дані з класичних таблиць середнього руху, або false, щоб застосувати лінійну швидкість від тієї самої епохи. Повертає сім чисел у вірупах, для Сонця й Місяця завжди 0. Призначена для порівняння з `cheshta_bala`; точно ці два варіанти не збігаються, і так задумано.
cheshta_rashmi	—	Чешта-рашмі — промені, які планета випромінює завдяки своєму руху. Виводиться з чешта-бали й зводиться до діапазону 0–180, а потім перетворюється на промені. Повертає сім чисел, від Сонця до Сатурна. У вихідному коді позначено як експериментальне, тож покладатися на нього не варто.
dig_bala	—	Сила напрямку, третя з шести складових: наскільки далеко кожна планета стоїть від середини дому, у якій вона вважається безсилою, — четвертого для Сонця й Марса, десятого для Місяця й Венери, сьомого для Меркурія та Юпітера, першого для Сатурна, — причому відстань ділиться на три. Повертає сім чисел у вірупах, від Сонця до Сатурна, округлених до двох знаків після коми.
drekkana_bala	—	Сила дреккани для п’ятикратного набору: 10 віруп для планети у власному знаку в карті D3, 5 — у знаку друга і 2.5 — у знаку ворога. Повертає сім чисел, від Сонця до Сатурна. `drekkana_bala_simple` — те саме правило з положенням у D3, обчисленим безпосередньо з довготи.
drekkana_bala_simple	—	Сила дреккани з положенням у D3, обчисленим безпосередньо з довготи (довгота, помножена на три), а не з побудованої карти D3: 10 віруп у власному знаку, 5 — у знаку друга, 2.5 — у знаку ворога. Повертає сім чисел, від Сонця до Сатурна. Саме цей варіант використовує `pancha_vargeeya_bala`.
dreshkon_bala	—	Сила дреккани: 15 віруп отримує чоловіча планета (Сонце, Марс, Юпітер) у першій третині свого знака, Меркурій чи Сатурн — у середній третині, а Місяць чи Венера — в останній третині; в інших випадках 0. Повертає сім значень 0 або 15, від Сонця до Сатурна.
drik_bala	—	Аспектна сила: аспекти кожної планети на кожну іншу оцінюються за кутом між ними, благотворні аспекти додаються, шкідливі віднімаються, а результат ділиться на чотири. Повертає сім чисел у вірупах, від Сонця до Сатурна, які можуть бути від’ємними: планета, яку сильно аспектують малефіки, тут втрачає силу.
dwadhasa_vargeeya_bala	—	Дванадцятикратна сила: кожну планету розміщують у дванадцяти дробових картах від D1 до D12, і вона отримує один бал за кожну карту, у якій потрапляє в дружній або кращий знак. Повертає об’єкт із ключами від `"0"` до `"6"` для планет від Сонця до Сатурна, кожне значення — ціле число від 0 до 12: простий підрахунок того, скільки поділів сприятливі для планети.
get_planet_mean_longitude	planet_index	Середня довгота планети в заданий момент, обчислена з її середнього положення й добової швидкості на епоху Удджайн 1900 плюс річна поправка. Передайте `planet_index` від 0 до 6 для планет від Сонця до Сатурна. Повертає одне число в градусах від 0 до 360 — крім Місяця (індекс 1): для нього розрахунок не реалізовано, і повертається 0.0. Середня довгота потрібна для чешта-бали; це не істинне положення планети.
get_planet_mean_longitude_using_epoch_table	planet_index	Та сама середня довгота, що й `get_planet_mean_longitude`, але зчитана цифра за цифрою з класичних таблиць середнього руху епохи Удджайн 1900, а не обчислена за лінійною швидкістю. Передайте `planet_index` від 0 до 6 для планет від Сонця до Сатурна. Повертає одне число в градусах від 0 до 360; для Місяця — так само 0.0. Результати трохи відрізняються від лінійного методу; перемикатися між ними дає змогу `cheshta_bala_new`.
hadda_bala	—	Сила хадди, за єгипетськими термами: кожен знак поділено на п’ять нерівних відрізків, кожен зі своїм планетарним володарем, і планета отримує 15 віруп у власній хадді, 7.5 — у хадді друга і 3.75 — у хадді ворога. Повертає сім чисел, від Сонця до Сатурна.
hadda_bala_simple	—	Сила хадди, обчислена безпосередньо з довготи кожної планети та таблиць термів: 15 віруп у власній хадді, 7.5 — у хадді друга, 3.75 — у хадді ворога. Повертає сім чисел, від Сонця до Сатурна. Саме цей варіант фактично використовує `pancha_vargeeya_bala`; на відміну від `hadda_bala`, йому не потрібно передавати карту.
harsha_bala	—	Харша-бала, «сила радості», що використовується в Таджиці: планета отримує 5 балів за кожну з чотирьох умов — перебування у своєму домі радості, у власному чи дружньому знаку, у знаку, що відповідає її статі, і в половині доби, що відповідає її природі. Повертає об’єкт із ключами від `"0"` до `"6"` для планет від Сонця до Сатурна, кожне значення — ціле число від 0 до 20 з кроком 5.
hora_bala	—	Сила планетарної години: планета, що управляє хорою, чинною в заданий момент, отримує 60 віруп, а всі інші — нуль. Повертає сім значень, від Сонця до Сатурна, з яких рівно одне ненульове.
ishta_phala	—	Ішта Пхала — міра благотворного результату, який планета, найімовірніше, принесе. Ця реалізація оцінює її за гідністю в натальній карті: 60 за екзальтацію, 45 за мулатрікону, 30 за власний знак, далі 22, 15, 8, 4 або 2 залежно від стосунків планети з володарем знака. Повертає сім цілих чисел, від Сонця до Сатурна. Зверніть увагу: за класичним визначенням Ішта Пхалу виводять з уччха-бали та чешта-бали, тож із текстами, що йдуть цим шляхом, ці значення не збігатимуться.
kaala_bala	—	Часова сила, сума дев’яти підскладових: натхоннатха-, пакша-, трібхага-, абда-, маса-, вара-, хора-, аяна- та юддха-бали. Повертає сім чисел у вірупах, від Сонця до Сатурна, округлених до двох знаків після коми. Кожна підскладова доступна як окремий ключ.
kendra_bala	—	Сила за типом дому: 60 віруп у кутовому домі (1, 4, 7, 10), 30 — у наступному (2, 5, 8, 11) і 15 — у спадному (3, 6, 9, 12). Повертає сім значень 60, 30 або 15, від Сонця до Сатурна. Опорний асцендент ядро визначає саме — за положенням Сонця в момент сходу, — а не бере з надісланого `asc_house`.
kendras	asc_house	Чотири кутові доми, відраховані від асцендента, який ви передаєте в `asc_house`: плаский список із чотирьох індексів знаків з нумерацією від 0 (ZERO), доми 1, 4, 7 і 10. Зверніть увагу на обидві відмінності від ключа `kendras` на /api/astro/house_hora/, який повертає дванадцять рядків чисел з нумерацією від 1 (ONE) і не приймає аргументів.
kshetra_bala	—	Сила поля, перша складова п’ятикратного набору Таджики: 30 віруп для планети у власному знаку, 22.5 — у знаку великого друга, 15 — у знаку друга, 7.5 — у нейтральному знаку і 3.75 — у знаку ворога, за натальною картою. Повертає сім чисел, від Сонця до Сатурна.
masa_bala	—	Сила володаря місяця: планета, що управляє місяцем, отримує 30 віруп, решта — нуль. Повертає сім значень, від Сонця до Сатурна, з яких рівно одне дорівнює 30. Як і `abda_bala`, ця реалізація визначає володаря за днем тижня `date_time`, тоді як `masadhipathi` виводить його з кількості днів, що минули.
masadhipathi	—	Володар місяця, визначений з ахаргани, а не за днем тижня. Планета-управитель отримує 30 віруп, решта — нуль. Повертає сім значень, від Сонця до Сатурна, з яких рівно одне дорівнює 30. Віддавайте перевагу цьому ключу, а не `masa_bala`.
naisargika_bala	—	Природна сила — незмінне ранжування планет за яскравістю, яке не залежить від карти: 60.00, 51.43, 17.14, 25.71, 34.29, 42.86 і 8.57 віруп для Сонця, Місяця, Марса, Меркурія, Юпітера, Венери й Сатурна. Повертає ці сім констант. Ключ є тут тому, що шадбала зараховує цю силу до своїх шести складових.
nathonnath_bala	—	Сила дня й ночі, перша частина кала-бали. Вона відлічується від місцевої опівночі: Сонце, Юпітер і Венера набирають силу в міру того, як настає день, а Місяць, Марс і Сатурн — у міру того, як настає ніч; Меркурій отримує фіксовані 60, бо він сильний будь-якої години. Повертає сім чисел у вірупах, від Сонця до Сатурна.
navamsa_bala	—	Сила навамші для п’ятикратного набору: 5 віруп для планети у власному знаку в карті D9, 2.5 — у знаку друга і 1.25 — у знаку ворога. Повертає сім чисел, від Сонця до Сатурна. `navamsa_bala_simple` — те саме правило з положенням у D9, обчисленим безпосередньо з довготи.
navamsa_bala_simple	—	Сила навамші з положенням у D9, обчисленим безпосередньо з довготи (довгота, помножена на дев’ять), а не з побудованої карти D9: 5 віруп у власному знаку, 2.5 — у знаку друга, 1.25 — у знаку ворога. Повертає сім чисел, від Сонця до Сатурна. Саме цей варіант використовує `pancha_vargeeya_bala`.
ojayugama_bala	—	Сила непарності й парності: 15 віруп за перебування в непарному знаку в натальній карті й ще 15 — у непарному знаку в навамші, причому для Місяця й Венери, яким потрібні парні знаки, перевірка обернена. Повертає сім цілих чисел 0, 15 або 30, від Сонця до Сатурна.
paksha_bala	—	Сила місячної пакші — за відстанню між Сонцем і Місяцем, поділеною на три: бенефіки отримують це значення, а малефіки — 60 мінус це значення, тож зростаюча половина сприяє бенефікам, а спадна — малефікам. Значення Місяця потім подвоюється, тому воно може перевищувати 60. Повертає сім чисел у вірупах, від Сонця до Сатурна.
panapharas	asc_house	Чотири наступні доми — 2-й, 5-й, 8-й і 11-й, — відраховані від дому асцендента, який ви передаєте в `asc_house`. Повертає чотири цілі числа, `(asc_house + n - 1) mod 12` для n, що дорівнює 2, 5, 8 і 11, тож результати — індекси знаків з нумерацією від 0, які відповідають конвенції, використаній вами для `asc_house`. Вважається, що планети тут дають середні результати — між кутовими й спадними домами.
pancha_vargeeya_bala	—	П’ятикратна сила Таджики, що використовується для річних карт: середнє значення кшетра-, уччха-, хадда-, дреккана- та навамша-бали. Планета у власному знаку отримує 30 за кшетру, 22.5 — у знаку великого друга, 15 — у знаку друга, 7.5 — у нейтральному знаку і 3.75 — у знаку ворога; дреккана й навамша оцінюються з 10 і 5 за тим самим принципом, а хадда — з 15 за володарями єгипетських термів. Повертає об’єкт із ключами від `"0"` до `"6"` для планет від Сонця до Сатурна, кожне значення — число з двома знаками після коми, зазвичай від 5 до 20.
planet_aspect_relationship_table	include_houses	Повна матриця аспектів, на якій ґрунтується дрік-бала: для кожної впорядкованої пари планет — сила аспекту другої планети на першу, оцінена за кутовою відстанню між ними. Повертає вкладений масив чисел із двома знаками після коми, по одному рядку на кожну планету, що аспектує. Передайте `include_houses` true, щоб у стовпцях, крім планет, були ще й дванадцять куспідів домів як точки, на які падають аспекти.
sapthavargaja_bala	—	Сила з семикратного набору поділів: кожна планета оцінюється в D1, D2, D3, D7, D9, D12 і D30 залежно від того, чи потрапляє вона в мулатрікону, власний знак або дружній, нейтральний чи ворожий знак, і сім оцінок підсумовуються. Повертає сім чисел у вірупах, від Сонця до Сатурна.
shad_bala	—	Повний розрахунок шестикратної сили. Повертає масив із дев’яти елементів: складові стхана, кала, діг, чешта, найсаргіка і дрік, кожна — список із семи чисел у вірупах; далі суми у вірупах; далі ті самі суми в рупах (віруп, поділені на 60); далі руп кожної планети, поділені на її класичну мінімальну вимогу 5, 6, 5, 7, 6.5, 5.5 і 5 для планет від Сонця до Сатурна. Саме останній список і слід читати: значення понад 1 означає, що планета виконала вимогу.
sthana_bala	—	Позиційна сила, перша з шести: сума уччха-, саптаварджа-, оджаюгма-, кендра- та дрешкона-бали. Повертає сім чисел у вірупах, від Сонця до Сатурна, округлених до двох знаків після коми. Щоб побачити, з чого склалася сума, запитайте п’ять складових окремо.
subha_rashmi	—	Шубха-рашмі, кількість «сприятливих променів», які випромінює планета, обчислена тут як чверть суми її чешта-рашмі та уччха-рашмі. Повертає сім чисел, від Сонця до Сатурна. Успадковує експериментальний статус `cheshta_rashmi`.
tribhaga_bala	—	Сила третини доби: і день, і ніч ділять на три частини кожен, а планета, що управляє поточною третиною, отримує 60 віруп. Юпітер отримує 60 завжди. Повертає сім значень 0 або 60, від Сонця до Сатурна.
uccha_rashmi	—	Уччха-рашмі — промені, які планета випромінює завдяки екзальтації: відстань від точки глибокого падіння, зведена до діапазону 0–180, плюс 30; на промені її перетворюють множенням на 2 і діленням на 30. Повертає сім чисел приблизно від 2 до 14, від Сонця до Сатурна, округлених до одного знака після коми.
uchcha_bala	—	Сила екзальтації: наскільки далеко кожна планета стоїть від точки свого глибокого падіння. Значення масштабовано так, що планета точно на градусі глибокої екзальтації отримує 20, а на градусі глибокого падіння — 0. Повертає сім чисел від 0 до 20 у вірупах, від Сонця до Сатурна.
vaara_bala	—	Сила володаря дня тижня: планета, що управляє днем тижня, отримує 45 віруп, решта — нуль. Повертає сім значень, від Сонця до Сатурна, з яких рівно одне дорівнює 45. `vaaradhipathi` обчислює те саме з кількості днів, що минули, і змінює день на сході Сонця, а не опівночі.
vaaradhipathi	—	Володар дня тижня, визначений з ахаргани, причому день змінюється на сході Сонця, а не опівночі, тож момент до сходу Сонця ще належить володарю попереднього дня. Планета-управитель отримує 45 віруп, решта — нуль. Повертає сім значень, від Сонця до Сатурна, з яких рівно одне дорівнює 45. Віддавайте перевагу цьому ключу, а не `vaara_bala`.
yuddha_bala	—	Сила планетарної війни. Коли дві планети стоять близько одна до одної, переможницею вважається та, що має більшу накопичену силу; різницю їхніх сум ділять на різницю видимих діаметрів дисків, додають переможниці й віднімають від переможеної. Повертає сім чисел, від Сонця до Сатурна, здебільшого нульових; там, де знайдено війну, з’являється пара рівних за модулем додатного й від’ємного значень. Війни за участю Сонця чи Місяця пропускаються.

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

curl -X POST https://api.occultapi.com/api/astro/strength/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["harsha_bala"],"date_time":"2025-03-27T11:11:24.366Z","latitude":26.9124,"longitude":75.7873,"timezone":5.5,"asc_house":2}'

Відповідь

{
  "data": {
    "harsha_bala": {
      "0": 10,
      "1": 0,
      "2": 10,
      "3": 0,
      "4": 5,
      "5": 10,
      "6": 5
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

Помилки

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