/api/astro/mundane/1 кредитМунданная астрология
Мунданная астрология толкует год для страны, а не для человека. Её главный инструмент — кабинет самватсары: десять «должностных лиц» года. Каждое из них — планета, и каждое определяется местным днём недели (сутки считаются от восхода до восхода в указанном месте), на который приходится определённое солнечное событие: царь — по лунному Новому году, министр — по вхождению Солнца в Овен, владыка облаков — по его вхождению в Ardra, и так далее вплоть до владык зерна, казны и плодов. Год, в котором царь — Сатурн, толкуют совсем иначе, чем год с царём-Юпитером. Передайте григорианский год, в котором начинается самват, а также место и смещение UTC; кабинет действует от Chaitra Shukla Pratipada этого года до следующей. das_adhikari возвращает весь кабинет одним объектом, и начинать стоит с этого ключа; отдельные ключи — king_of_year, mantri_of_year, meghesha_of_year и остальные — возвращают те же планеты по одной. vaahan_of_samvat возвращает символическое средство передвижения года, которое определяется по царю. Кроме кабинета эндпоинт возвращает астрономическую канву года — равноденствия, солнцестояния, indian_ritus (шесть сезонов в виде реальных диапазонов дат), chaitra_shukla_pratipada и ardra_entry — и четыре карты, построенные на моменты определённых ингрессий: jagat_lagna_chart — на вхождение Солнца в Овен, ardra_pravesh_chart — для муссона, sharatsasya_chart и greeshmasasya_chart — для зимнего и летнего урожая. sapta_nadi_chakra и samvatsara_purusha_chakra — статические справочные таблицы, которые не зависят от года, а nakshatra_lord_effects ищет одну накшатру в первой из них. В поле nakshatra этого ключа используется старая транслитерация и всего двадцать шесть названий, поэтому сверяйтесь со списком поля, а не рассчитывайте на современное написание.
https://api.occultapi.com/api/astro/mundane/
Аутентификация
Передавайте ключ в заголовке 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' — разные моменты, и ответы для них будут разными. |
| keys | array | обязательный | Какие расчёты вернуть — списком названий. См. таблицу ключей этого эндпоинта; нераспознанное название отклоняет весь запрос. Один вызов стоит один кредит, сколько бы ключей вы ни запросили, поэтому запрашивайте всё нужное сразу, а не несколькими вызовами. |
| latitude | number (double) | обязательный | Широта места в десятичных градусах. Положительные значения — север, отрицательные — юг. Пример: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Минуты и секунды не принимаются — сначала переведите значение в десятичные градусы. min -90 · max 90 |
| longitude | number (double) | обязательный | Долгота места в десятичных градусах. Положительные значения — восток, отрицательные — запад. Пример: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Следите за знаком: без минуса Нью-Йорк окажется в Китае. min -180 · max 180 |
| nakshatra | string | обязательный | KrittikaVisaakhaAnooraadhaBharaniRohiniSwaatiJyeshthaAshwiniMrigasiraChitraMoolaRevatiИспользуется только ключом 'nakshatra_lord_effects'. Название сверяется с таблицей Sapta Nadi Chakra ТОЧНО и с учётом регистра. В таблице старые транслитерации, а не современные написания, например: 'Aardra' (не Ardra), 'Aasresha' (не Ashlesha), 'Makha' (не Magha), 'Sravanam' (не Shravana), 'Visaakha', 'Anooraadha', 'Mrigasira', 'Pushyami', 'Satabhishak', 'Poorvaabhaadra', 'Uttaraashaadha'. Из 28 названий накшатр в таблице только 26 — 'Poorvaashaadha' и 'Uttaraabhaadra' в ней нет. Если название не найдено, ошибки НЕ будет: метод вернёт null. |
| timezone_as_float | number (double) | обязательный | Смещение UTC для места, в часах, десятичным числом. Пример: 5.5 для Индии (UTC+05:30), -5 для Нью-Йорка зимой, 5.75 для Непала. Оно НЕ сверяется с date_time: если значения расходятся, вы получите успешный ответ для неверного момента, поэтому берите оба из одного источника. Используйте смещение, действовавшее на эту дату, а не сегодняшнее: для рождения летом в стране с летним временем нужно летнее смещение. min -12 · max 14 |
| year | integer | обязательный | Год рождения числом, например 1990. Четыре цифры. |
Доступные ключи (24)
Перечислите в keys ровно те расчёты, которые вам нужны. Один неизвестный ключ — и отклоняется весь запрос. Сколько бы ключей вы ни запросили, спишется 1 кредит, так что собирайте их в один вызов.
| Ключ | Доп. поля | Описание |
|---|---|---|
| ardra_entry | — | Точный момент, когда Солнце достигает 66°40', то есть начала накшатры Ardra, — традиционный ориентир для суждений о муссоне. Одна метка времени. |
| ardra_pravesh_chart | — | Карта той же структуры, построенная на момент вхождения Солнца в накшатру Ardra; по ней судят о муссоне. Возвращает {entry_time, chart, house_planets}. |
| chaitra_shukla_pratipada | — | Индуистский лунный Новый год: местный восход Солнца, которым начинается день Chaitra Shukla Pratipada в запрошенном году. Месяц Chaitra начинается с последнего новолуния перед вхождением Солнца в сидерический Овен. Искомый день — первый, чей восход приходится на первую титхи светлой половины месяца, а если эта титхи не застаёт ни одного восхода — день, в который она начинается. Одна метка времени. |
| das_adhikari | — | Весь кабинет года одним объектом с ключами King, Minister, Lord of Clouds, Lord of Summer Crops, Lord of Defence, Lord of Treasury, Lord of Juicy Products, Lord of Food Grains, Lord of Metals, Lord of Fruits и Vehicle of Year. Первые десять значений — названия планет, последнее — символическое средство передвижения года. Начинайте с этого ключа, а не запрашивайте десять отдельных. |
| dhaanyesha_of_year | — | Дханьеша, владыка зерна: планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца в Стрелец. Одно английское название планеты. |
| dhanesha_of_year | — | Дханеша, владыка казны: планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца в Деву. Одно английское название планеты. |
| durgesha_of_year | — | Дургеша, владыка крепостей и обороны: планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца во Льва. Одно английское название планеты. |
| equinoxes | — | Два момента равноденствия в году — когда Солнце пересекает тропическую долготу 0 и 180 градусов. Список из двух элементов: сначала весеннее, затем осеннее. |
| greeshmasasya_chart | — | Карта летнего урожая, построенная на момент вхождения Солнца в Рыбы. Возвращает {entry_time, chart, house_planets}. |
| indian_ritus | — | Шесть индийских сезонов в виде реальных диапазонов дат. Каждый сезон — дуга тропической долготы Солнца в шестьдесят градусов, и дуги расположены так, что каждое равноденствие и солнцестояние приходится на середину или на границу сезона. Возвращает список из шести объектов — {ritu, name, subtitle, begins, ends, tropical_zodiac, note, image_url} — в порядке Vasant, Grishma, Varsha, Sharad, Hemant, Shishir. |
| jagat_lagna_chart | — | Мировая карта, построенная на точный момент вхождения Солнца в Овен. Возвращает {ingress_time, chart, house_planets}: chart — полная карта раши в записи «знак и градус» с разделами celestial, houses и ascendant, а house_planets сопоставляет каждому дому стоящие в нём планеты. |
| king_of_year | — | Раджа (царь) года — планета, управляющая местным днём недели, на который приходится Chaitra Shukla Pratipada. Одно английское название планеты. В мунданной практике природа этой планеты задаёт тон толкованию всего года. |
| mantri_of_year | — | Мантри, или министр года: планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца в Овен. Одно английское название планеты. |
| meghesha_of_year | — | Мегхеша, владыка облаков: планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца в накшатру Ardra. Одно английское название планеты; по нему судят об осадках в году. |
| nakshatra_lord_effects | nakshatra | Ищет переданную накшатру в Sapta Nadi Chakra и возвращает {lord, nadi, means, effect}: планету-управителя, название нади, её значение и погоду, о которой по ней судят. Для названия, которого нет в таблице, возвращает null. В таблице старые транслитерации и всего двадцать шесть названий: Poorvaashaadha и Uttaraabhaadra в ней нет. |
| neersesha_of_year | — | Планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца в Козерог. Одно английское название планеты. В классической традиции эта должность — владыка вод, но в das_adhikari этот API называет её Lord of Metals, и описание следует коду, а не классическому употреблению. |
| phalesha_of_year | — | Пхалеша, владыка плодов: планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца в Рыбы в конце самвата, в марте следующего григорианского года. Одно английское название планеты. |
| rasesha_of_year | — | Расеша, владыка соков и жидких продуктов: планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца в Весы. Одно английское название планеты. |
| samvatsara_purusha_chakra | — | Соответствия частей тела «человека года». Возвращает статический объект с ключами по частям тела — 'Entire body', 'Navel', 'Heart' и 'Vitality', — у каждой есть список nakshatras, а у последней — примечание о значении. Это неполная таблица, охватывающая шесть накшатр, а не все двадцать семь. |
| sapta_nadi_chakra | — | Полная погодная таблица семи нади, в которой ищет nakshatra_lord_effects: объект с ключами по семи планетам, у каждой — {nakshatras, nadi, means, effect}. Статические справочные данные, одинаковые для любого запроса. Обратите внимание: некоторые накшатры встречаются сразу у нескольких планет, и поиск возвращает первое совпадение. |
| sashyesha_of_year | — | Сасьеша, владыка урожая: планета — управитель местного дня недели (от восхода до восхода), на который приходится вхождение Солнца в Рак. Одно английское название планеты; в das_adhikari эта должность называется Lord of Summer Crops. |
| sharatsasya_chart | — | Карта зимнего урожая, построенная на момент вхождения Солнца в Деву. Возвращает {entry_time, chart, house_planets} — ту же структуру, что и другие мунданные карты. |
| solstices | — | Два момента солнцестояния в году. Список из двух элементов; обратите внимание, что порядок не хронологический: сначала зимнее (Солнце на 270 градусах, в декабре запрошенного года), затем летнее (Солнце на 90 градусах, в июне). |
| vaahan_of_samvat | — | Символическое средство передвижения года, определяемое по царю года: Horse для Солнца, Elephant для Луны, Ox/boat для Марса, Swing для Меркурия, Boat для Юпитера, Elephant/Frog для Венеры, Horse/Buffalo для Сатурна. Одна строка. |
Пример запроса
curl -X POST https://api.occultapi.com/api/astro/mundane/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["nakshatra_lord_effects"],"year":2025,"date_time":"2025-02-13T05:00:37.682Z","nakshatra":"Krittika","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'Ответ
{
"data": {
"nakshatra_lord_effects": {
"lord": "Saturn",
"nadi": "Chandaa",
"means": "Aggressive",
"effect": "Heat, Wind"
}
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано с реального вызова ровно с этим запросом. Результаты лежат в data под теми ключами, которые вы запросили.
Ошибки
Ошибки списания кредитов приходят в виде { "error": "…", "message": "<code>", "is_error": true }. Людям показывайте error, а логику стройте на message. Подробнее — в справочнике ошибок.