/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_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 | необязательный |
Доступные ключи (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. Подробнее — в справочнике ошибок.