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, с отсчётом от нуля, как у `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`: плоский список из четырёх индексов знаков С ОТСЧЁТОМ ОТ НУЛЯ, дома 1, 4, 7 и 10. Обратите внимание на оба отличия от ключа `kendras` на /api/astro/house_hora/, который возвращает двенадцать строк чисел С ОТСЧЁТОМ ОТ ЕДИНИЦЫ и не принимает аргументов.
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, т. е. индексы знаков с отсчётом от нуля в той же системе, что вы использовали для `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. Подробнее — в справочнике ошибок.