/api/astro/house_hora/1 кредитОтношения домов
Структура отношений в натальной карте: какие знаки аспектируют какие, какие планеты аспектируют какие, кто кому друг и какие планеты классические тексты выделяют как значимые для поворотных моментов карты. Здесь по отдельности доступна значительная часть аппарата, на котором строятся суждения Джаймини и Парашари. Ключи делятся на три группы. Ключи классов домов (`trikonas`, `kendras`, `quadrants`, `dushthanas`, `chathusras`, `upachayas`) — чистая геометрия: двенадцать строк, по одной на знак, с номерами знаков от 1 до 12; от карты они не зависят. Ключи аспектов и отношений (`raasi_drishti_of_the_planet`, три ключа `aspected_*_of_the_planet`, два ключа `*_of_the_raasi`, `argala`, `associations_of_the_planet`, три ключа естественной дружбы и `baadhakas_of_raasi`) описывают, как тела карты соотносятся друг с другом. Ключи Джаймини (`chara_karakas`, `marakas`, `brahma`, `rudra`, `maheshwara`, `trishoola_rasis`, `order_of_planets_by_strength`) называют планеты, важные для долголетия и для определения времени крупных событий. Планеты везде возвращаются индексами: 0 Солнце, 1 Луна, 2 Марс, 3 Меркурий, 4 Юпитер, 5 Венера, 6 Сатурн, 7 Раху, 8 Кету. Знаки в ключах аспектов и Джаймини считаются от нуля (0 Овен — 11 Рыбы), а в ключах классов домов — от единицы (1–12), поэтому следите, какой отсчёт перед вами. Поле запроса `planet` пишется с заглавной буквы и чувствительно к регистру — 'Sun', а не 'sun', — а `raasi` — целое число с отсчётом от нуля без проверки границ, поэтому значение вне 0–11 приводит к ошибке запроса.
https://api.occultapi.com/api/astro/house_hora/Аутентификация
Передавайте ключ в заголовке X-API-Key. Ключ — это серверные учётные данные: никогда не вставляйте его в JavaScript на стороне браузера или в мобильное приложение.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonПоля запроса
| Поле | Тип | Обязательно | Примечания |
|---|---|---|---|
| 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 | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. trikonasdushthanaschathusrasquadrantskendrasupachayaschara_karakasraasi_drishti_of_the_planetaspected_planets_of_the_planetaspected_rasis_of_the_planetaspected_houses_of_the_planetaspected_houses_of_the_raasiМассив строк. Ключи, оканчивающиеся на '_of_the_planet', а также 'associations_of_the_planet' требуют `planet`; ключи, оканчивающиеся на '_of_the_raasi', а также 'baadhakas_of_raasi' требуют `raasi`. |
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -90 · max 90 |
| longitude | number (double) | обязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180 |
| node | string | обязательный | truemeanС учётом регистра, в нижнем регистре. 'true' использует истинные лунные узлы, 'mean' — средние. Любое другое значение вызывает KeyError -> 400. Передаётся дальше. |
| planet | string | обязательный | SunMoonMarsMercuryJupiterVenusSaturnRahuKetuС УЧЁТОМ регистра, с заглавной буквы — обратите внимание, это отличается от названий тел в нижнем регистре, которые использует /api/astro/chart_analysis/. |
| raasi | integer | обязательный | 01234567891011Целое число, а не строка. Используется как индекс знака С ОТСЧЁТОМ ОТ НУЛЯ: 0 = Овен... 11 = Рыбы. Проверки границ нет, поэтому значения вне диапазона вызывают IndexError -> 400, а отрицательные молча отсчитываются с конца по кругу. |
| timezone_as_float | number (double) | обязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. min -12 · max 14 |
Доступные ключи (29)
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание |
|---|---|---|
| argala | — | Аргала и виродхаргала для всей карты — списком из двух элементов. Первый элемент — аргала, вмешательство, которое оказывает дом: двенадцать строк, по одной на каждый дом от асцендента; в каждой — четыре строковых значения для 2-го, 4-го, 5-го и 11-го дома от него: индексы находящихся там планет через '/' или пустая строка, если там никого нет. Второй элемент — виродхаргала, препятствие аргале, в той же структуре для 12-го, 10-го, 9-го и 3-го домов — именно в таком порядке, чтобы каждый столбец стоял в паре с соответствующим столбцом аргалы. |
| aspected_houses_of_the_planet | planet | Те же аспекты граха-дришти, что и в `aspected_rasis_of_the_planet`, но выраженные номерами домов с отсчётом от асцендента, от 1 до 12, а не индексами знаков. Требуется `planet`. |
| aspected_houses_of_the_raasi | raasi | Дома от 1 до 12 с отсчётом от асцендента, которые данный знак аспектирует по раши-дришти, — все, независимо от того, есть ли в них планеты. Требуется `raasi` — индекс знака с отсчётом от нуля. |
| aspected_planets_of_the_planet | planet | Планеты, которые данная планета аспектирует по граха-дришти — планетарному аспекту Парашари, при котором каждая планета видит 7-й дом, а у Марса, Юпитера и Сатурна есть дополнительные аспекты. Возвращает список индексов планет. Требуется `planet`. |
| aspected_raasis_of_the_raasi | raasi | То же отношение раши-дришти, что и в `aspected_houses_of_the_raasi`, но в виде индексов знаков с отсчётом от нуля, а не номеров домов, поэтому от асцендента оно не зависит вовсе. Требуется `raasi`. |
| aspected_rasis_of_the_planet | planet | Знаки, которые данная планета аспектирует по граха-дришти, — списком индексов знаков с отсчётом от нуля, от 0 для Овна до 11 для Рыб. Вариант `aspected_houses_of_the_planet` со знаками вместо домов. Требуется `planet`. |
| associations_of_the_planet | planet | Все планеты, с которыми данная планета значимо связана любым из трёх классических способов: находится с ней в одном знаке, аспектирует её по граха-дришти или состоит с ней в паривартане — обмене знаками. Возвращает список индексов планет без повторов. Требуется `planet`. |
| baadhakas_of_raasi | raasi | Бадхака-дом, или дом препятствий, для данного восходящего знака и управляющие им планеты: 11-й для подвижных знаков, 9-й для неподвижных и 7-й для двойственных. Возвращает список из двух элементов: [знак бадхаки с отсчётом от нуля, список индексов планет — его управителей]. Требуется `raasi`. |
| brahma | — | Брахма — планета, которую Джаймини связывает с поддержанием жизни. Это сильнейший из управителей 6-го, 8-го и 12-го домов, отсчитанных от более сильного из двух — асцендента или седьмого дома; Раху и Кету исключаются, а при равенстве решают достоинство, положение в нечётном знаке и положение в половине. Возвращает один индекс планеты. |
| chara_karakas | — | Восемь чара-карак — список из восьми индексов планет в порядке убывания градуса в знаке. Первый элемент — атмакарака, остальные идут в стандартном порядке (аматья-, бхратри-, матри-, питри-, путра-, гнати-, дара-карака). Кету исключается, а Раху, как того требует классическое правило, ранжируется по обратной долготе. |
| chathusras | — | Двенадцать строк по два номера знаков 1–12. В текущей реализации каждая строка даёт 3-й и 5-й знаки от данного — строка 1 равна [3, 5], — а не 4-й и 8-й, которые составляют классическую пару чатусра. |
| dushthanas | — | Двенадцать строк по три номера знаков 1–12. В текущей реализации каждая строка даёт сам знак, 3-й и 7-й от него — строка 1 равна [1, 3, 7], — а это не классический набор дустхан 6-й/8-й/12-й. Поэтому воспринимайте результат как то, что вычисляет код, а не как дустханы в классическом понимании. |
| kendras | — | Квадранты каждого знака: двенадцать строк, по одной на знак, каждая — список из четырёх номеров знаков от 1 до 12. Строка 0 — Овен. Аргументов не принимает. Структура отличается от ключа `kendras` на /api/astro/strength/, который принимает `asc_house` и возвращает один плоский список из четырёх индексов С ОТСЧЁТОМ ОТ НУЛЯ, — не перепутайте эти два способа отсчёта, иначе получите ошибку на единицу. |
| maheshwara | — | То же значение, что `maheshwara_from_planet_positions`: этот ключ напрямую вызывает его и возвращает тот же один индекс планеты. Запрашивайте какой-то один из них. |
| maheshwara_from_planet_positions | — | Махешвара — планета, которую Джаймини связывает с характером смерти; определяется как управитель восьмого знака от атмакараки, с классическими заменами, когда этот управитель находится в собственном знаке или соединён с узлом либо находится в оппозиции к нему. Возвращает один индекс планеты; если результатом оказались бы Раху или Кету, они заменяются соответственно на Меркурий или Юпитер. |
| marakas | — | Те же планеты-мараки, что и `marakas_from_planet_positions`, но рассчитанные по форме карты «дом → планеты». Результат — тот же список индексов планет, поэтому запрашивайте один из ключей, а не оба. |
| marakas_from_planet_positions | — | Планеты-мараки, или «убивающие» планеты: управители 2-го и 7-го домов, а также любая планета, находящаяся в одном из этих домов или вместе с одним из этих управителей. Возвращает список индексов планет без определённого порядка. Рассчитывается по форме карты с положениями планет. |
| natural_enemies_of_planets | — | Стандартная таблица вражды — список из девяти списков с индексами планет 0–8, в каждом — враждебные ей планеты. Таблица фиксирована и от карты не зависит; парный ключ — `natural_neutral_of_planets`. |
| natural_friends_of_planets | — | Постоянная дружба планет, выведенная из управлений знаками в самой этой карте: объект с ключами по индексам планет 0–8, у каждого — список индексов дружественных ей планет. Для семи классических планет вместе с управителями дружественных знаков включается управитель знака экзальтации. |
| natural_neutral_of_planets | — | Стандартная таблица нейтральности — список из девяти списков с индексами планет 0–8, в каждом — нейтральные к ней планеты. В отличие от `natural_friends_of_planets`, это фиксированная классическая таблица, совсем не зависящая от карты. |
| order_of_planets_by_strength | — | Все девять планет, ранжированные от сильнейшей, — список из девяти индексов планет. Порядок берётся из попарного сравнения сил в движке — того же, что используется для выбора между управителями-кандидатами в расчётах Рудры и Махешвары. |
| planets_aspecting_the_planet | planet | Должен возвращать планеты, которые бросают граха-дришти на данную планету, — списком индексов планет. Сейчас он сравнивает название планеты с заглавной буквы со списками индексов планет, поэтому при любых входных данных возвращает пустой список. Вместо него вызовите `aspected_planets_of_the_planet` по очереди для каждой планеты и постройте обратное соответствие. |
| quadrants | — | Углы каждого знака: двенадцать строк по четыре номера знаков 1–12 — сам знак и 4-й, 7-й и 10-й от него. Строка 1 равна [1, 4, 7, 10]. На этом эндпоинте это псевдоним `kendras`: значения не могут различаться, поэтому, запрашивая оба ключа, вы лишь занимаете лишнее место в ответе. |
| raasi_drishti_of_the_planet | planet | Планеты, стоящие в знаках, которые собственный знак данной планеты аспектирует по раши-дришти — аспекту знака к знаку в системе Джаймини, при котором подвижные знаки видят неподвижные и наоборот, а двойственные видят друг друга. Возвращает список индексов планет. Требуется `planet`. |
| rudra | — | Рудра — более сильный из двух управителей: восьмого дома от асцендента и восьмого дома от седьмого. Возвращает [индекс планеты, занимаемый ею знак с отсчётом от нуля, три знака тригона этого знака с отсчётом от нуля]. Обратите внимание: это не то же самое, что `rudra_based_on_planet_positions`, где второй из двух управителей определяется иначе, поэтому там может получиться другая планета. |
| rudra_based_on_planet_positions | — | Рудра — планета, которую Джаймини связывает с разрушительным поворотом в карте; здесь это более сильный из двух: управитель восьмого знака от асцендента или управитель седьмого дома. Возвращает список из трёх элементов: [индекс планеты, занимаемый ею знак с отсчётом от нуля, три знака тригона этого знака с отсчётом от нуля]. Определяется иначе, чем `rudra`, поэтому два ключа могут назвать разные планеты. |
| trikonas | — | Тригоны каждого знака: двенадцать строк по три номера знаков 1–12 — сам знак и 5-й и 9-й от него. Строка 1 равна [1, 5, 9]. Чистая геометрия — для любой карты одна и та же. |
| trishoola_rasis | — | Тришула-раши — трезубец из трёх знаков, по которому определяют время самого разрушительного периода карты: тригоны знака, в котором находится Рудра. Возвращает три индекса знаков с отсчётом от нуля. |
| upachayas | — | Двенадцать строк по четыре номера знаков 1–12. В текущей реализации каждая строка даёт сам знак и 4-й, 8-й и 9-й от него — строка 1 равна [1, 4, 8, 9], — а не 3-й, 6-й, 10-й и 11-й, которые классически составляют набор упачая. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/house_hora/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["trikonas"],"raasi":2,"planet":"Mars","node":"mean","date_time":"2025-02-12T09:35:49.036Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Ответ
{
"data": {
"trikonas": [
[
1,
5,
9
],
[
2,
6,
10
],
[
3,
7,
11
],
[
4,
8,
12
],
[
5,
9,
1
],
[
6,
10,
2
],
[
7,
11,
3
],
[
8,
12,
4
],
[
9,
1,
5
],
[
10,
2,
6
],
[
11,
3,
7
],
[
12,
4,
8
]
]
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.