POSThttps://api.occultapi.com/api/astro/mundane/

Мунданна астрологія

Тіло запитуJSON

Щоб надіслати запит, вставте API-ключ вище.

Фрагмент коду

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}'

Мунданна астрологія тлумачить рік для країни, а не для людини. Її головний інструмент — кабінет самватсари: десять «посадовців» року. Кожен із них — планета, і кожного визначає місцевий день тижня (від сходу до сходу Сонця в заданому місці), на який припадає певна сонячна подія: царя — місячний Новий рік, міністра — вхід Сонця в Овен, володаря хмар — вхід Сонця в Ардру, і так далі аж до володарів зерна, скарбниці та плодів. Рік, у якому цар — Сатурн, тлумачать зовсім інакше, ніж рік із царем Юпітером. Передайте григоріанський рік, у якому починається самват, а також місце й зміщення від UTC; кабінет діє від Чайтра Шукла Пратіпади цього року до наступної. 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 цього ключа використовує старішу транслітерацію й охоплює лише двадцять шість назв, тож звіряйтеся зі списком значень поля, а не розраховуйте на сучасне написання.

Поля запиту

Поле	Тип	Обов’язкове	Примітки
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'. ТОЧНИЙ збіг з урахуванням регістру з таблицею Сапта Наді-чакри: це старіші транслітерації, а не сучасне написання; зверніть увагу на 'Aardra' (а не Ardra), 'Aasresha' (а не Ashlesha), 'Makha' (а не Magha), 'Sravanam' (а не Shravana), 'Visaakha', 'Anooraadha', 'Mrigasira', 'Pushyami', 'Satabhishak', 'Poorvaabhaadra', 'Uttaraashaadha'. У таблиці є лише 26 із 28 назв накшатр — '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_pravesh_chart	—	Та сама структура карти, побудована на момент входу Сонця в накшатру Ардра, — карта, яку тлумачать щодо мусону. Повертає {entry_time, chart, house_planets}.
chaitra_shukla_pratipada	—	Індуїстський місячний Новий рік: місцевий схід Сонця, яким починається день Чайтра Шукла Пратіпади в запитаному році. Чайтра починається з останнього молодика перед входом Сонця в сидеричний Овен. Потрібний день — перший, чий схід Сонця припадає на першу тітхі світлої пакші, а якщо ця тітхі не захоплює жодного сходу Сонця, — день, у який вона починається. Одна мітка часу.
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	—	Раджа, тобто цар року, — планета, що управляє місцевим днем тижня, на який припадає Чайтра Шукла Пратіпада. Одна назва планети англійською. У мунданній практиці природа цієї планети задає тон, у якому тлумачать увесь рік.
mantri_of_year	—	Мантрі, або міністр року: планета, що управляє місцевим днем тижня (від сходу до сходу Сонця), на який припадає вхід Сонця в Овен. Одна назва планети англійською.
meghesha_of_year	—	Мегхеша, володар хмар: планета, що управляє місцевим днем тижня (від сходу до сходу Сонця), на який припадає вхід Сонця в Ардру. Одна назва планети англійською; за нею тлумачать опади року.
nakshatra_lord_effects	nakshatra	Шукає передану накшатру в Сапта Наді-чакрі й повертає {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 для Сатурна. Один рядок.

Повний довідник цього ендпоінта