/api/astro/panchanga/1 кредитПанчанга
Панчанга — індуїстський альманах для одного моменту в одному місці: п’ять «складових» — тітхі, вара, накшатра, йога та карана — плюс усе інше, що є в друкованому панчангу. Це найбільший ендпоінт в API, із п’ятдесятьма сімома ключами, і більшість клієнтів використовує лише кілька з них. Для п’яти складових почніть із tithi, vaara, nakshatra_segments, yogam і karana, а для рамки дня — із day_length, night_length, midday і midnight. Ключі *_segments — tithi_segments, karana_segments, yoga_segments, nakshatra_segments — відрізняються від своїх відповідників в однині, і тут легко помилитися: ключ в однині відповідає на питання «що діє в цей момент», а ключ segments перелічує всі періоди, що припадають на весь місцевий календарний день, із точним часом початку й кінця — саме це потрібно для сторінки календаря. Решта ділиться на групи. Поділи часу: choghadiya і gauri_choghadiya — на восьмі частини, hora — на планетарні години, do_ghati — на тридцять мухурт, trikalam — на третини. Вікна з власними назвами: abhijit_muhurta, brahma_muhurta, vijaya_muhurta, nishita_muhurta, godhuli_muhurta, amrit_kalam і дві сандх’ї — на противагу rahu_kaalam, yamaganda_kaalam, gulika_kaalam і durmuhurata. Календар: lunar_month і lunar_month_poornima (той самий місяць за двома системами ліку), shaka_samvat, vikram_samvat, kali_samvat, samvatsara_name, ritu, sankranti_dates і tamil_solar_month_date. Положення, а не час: upagraha_longitudes, special_longitudes, lagnas, sree_lagna і два варіанти bhaava_madhya. Оцінки якості дня: tarabala, chandrabalam, panchaka_rahita, disha_shool, agni_vasa_segments, shiva_vasa_segments, yogas і shunya_nakshatra. Кожен виклик потребує date_time і timezone_as_float, а все, що залежить від сходу Сонця, — ще й latitude і longitude. Кілька необов’язкових полів змінюють саму відповідь, а не лише форматування: samvata_type потрібне для samvatsara_name, mode визначає, як обчислюється ritu, а gulika_rises_at, mandi_rises_at, gulika_portion, mandi_portion, kala_mrityu_rise_at і dhuma_vyatipata_relation дають змогу вибрати одну з конкурентних класичних конвенцій для положень упаграх. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне для сторінки одразу.
https://api.occultapi.com/api/astro/panchanga/
Автентифікація
Передавайте ключ у заголовку 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 | обов’язковий | Які розрахунки повернути, у вигляді списку назв. Див. таблицю ключів цього ендпоінта; через нерозпізнану назву відхиляється весь запит. Один виклик коштує один кредит незалежно від кількості запитаних ключів, тож запитуйте все потрібне одразу, а не кількома викликами. |
| timezone_as_float | number (double) | обов’язковий | Зміщення місця від UTC у годинах, десятковим дробом. Приклад: 5.5 для Індії (UTC+05:30), -5 для Нью-Йорка взимку, 5.75 для Непалу. Його НЕ звіряють із date_time: якщо значення розходяться, ви отримаєте успішну відповідь для неправильного моменту, тож беріть обидва з одного джерела. Використовуйте зміщення, чинне на ту дату, а не сьогоднішнє: для народження влітку в країні з переходом на літній час потрібне літнє зміщення. min -12 · max 14 |
| dhuma_vyatipata_relation | string | необов’язковий | 360_minus_dhumadhuma_plus_53_20За замовчуванням '360_minus_dhuma'. Передається в ядро. |
| eccentric_anomaly | number (double) | необов’язковий | |
| eccentricity | number (double) | необов’язковий | |
| gulika_portion | string | необов’язковий | saturneighthЗа замовчуванням 'saturn'. Передається в ядро. |
| gulika_rises_at | string | необов’язковий | beginningmiddleendЗа замовчуванням 'beginning'. Передається в об’єкт ядра Panchanga. |
| kala_mrityu_rise_at | string | необов’язковий | beginningmiddleendЗа замовчуванням 'middle'. Передається в ядро. |
| latitude | number (double) | необов’язковий | Широта місця в десяткових градусах. Додатні значення — північ, від’ємні — південь. Приклад: 26.9124 для Джайпура, 40.7128 для Нью-Йорка. Хвилини й секунди не приймаються — спершу переведіть їх у градуси. min -89.9 · max 89.9 |
| longitude | number (double) | необов’язковий | Довгота місця в десяткових градусах. Додатні значення — схід, від’ємні — захід. Приклад: 75.7873 для Джайпура, -74.0060 для Нью-Йорка. Зверніть увагу на знак: без мінуса Нью-Йорк опиниться в Китаї. min -180 · max 180 |
| mandi_portion | string | необов’язковий | saturneighthЗа замовчуванням 'saturn'. Передається в ядро. |
| mandi_rises_at | string | необов’язковий | beginningmiddleendЗа замовчуванням 'middle'. Передається в ядро. |
| mean_anomaly | number (double) | необов’язковий | |
| mode | string | необов’язковий | vedicdrikВикористовується лише ключем 'ritu'. 'vedic' виводить сезон із місячного місяця, 'drik' — із тропічного знака Сонця. Типове значення ядра — 'drik'. УВАГА: на неправильне значення функція помилки не викидає — будь-який інший рядок мовчки минає обидві гілки, і ключ повертає null (зразок у каталозі, що постачається, навіть надсилає mode=0 і отримує 200 із результатом null). |
| nakshatras | string | необов’язковий | specialУ ядрі єдине значуще значення — рядок-літерал 'special', який замінює таблицю `nakshatras` із 27 записів на таблицю `nakshatras_special` із 28 записів, де є Абхіджит і використано сучасне написання. Оскільки значення в ядро ніколи не передається, ключ 'yogas' цього ендпоінта наразі повертає 500 з "'Panchanga' object has no attribute 'nakshatras'". |
| samvata_type | string | необов’язковий | shakavikramВикористовується лише ключем 'samvatsara_name'. |
| tolerance | number (double) | необов’язковий |
Доступні ключі (57)
Перелічіть у keys саме ті розрахунки, які вам потрібні. Один невідомий ключ — і відхиляється весь запит. Скільки б ключів ви не запитали, спишеться 1 кредит, тож збирайте їх в один виклик.
| Ключ | Додаткові поля | Опис |
|---|---|---|
| abhijit_muhurta | — | Абхіджит: восьма з п’ятнадцяти денних мухурт, що охоплює середину світлового дня, — універсальне сприятливе вікно. Повертає {start, end}. |
| agni_vasa_segments | — | Де, як вважається, перебуває Агні, божество вогню; це перевіряють перед хомою. Визначається за тітхі та днем тижня, тож змінюється разом із тітхі. Повертає список {state, is_patala, start_time, end_time}, по одному запису на кожен сегмент тітхі дня, де state — 'Prithvi (Earth)', 'Akasha (Heaven)' або 'Patala (Nadir)'. Хоми заради певного результату слід виконувати, поки Агні на Прітхві; is_patala позначає стан, який у деяких панчангах називають Бхадраваса. |
| amrit_kalam | — | Періоди Гаурі панчангам типу Amrit, що припадають на день, — найсприятливіші рядки цієї таблиці. Повертає список {start, end}, зазвичай два: один у світлу частину доби, один уночі. Обчислюються за тими самими таблицями днів тижня, що й gauri_choghadiya, і не пов’язані з Амріта-гадією на основі накшатр, яку подають деякі інші панчанги. |
| bhaava_madhya_sripati | — | Дванадцять куспідів у тій самій структурі {degree, sign, minutes, seconds, nakshatra, pada}, що й bhaava_madhya_swe. Класично система Шріпаті — квадрантний поділ, але ця реалізація бере з неї лише асцендент, а далі щоразу додає тридцять градусів, тож для заданого моменту повертає ті самі дванадцять значень, що й bhaava_madhya_swe. |
| bhaava_madhya_swe | — | Дванадцять куспідів домів за системою рівних домів у сидеричному зодіаку, починаючи з першого дому. Повертає список із дванадцяти об’єктів, кожен — {degree, sign, minutes, seconds, nakshatra, pada}, де sign — дволітерне скорочення, напр. 'Ar' чи 'Cp'. |
| brahma_muhurta | — | Брахма-мухурта: дві останні мухурти ночі перед сходом Сонця, кожна — п’ятнадцята частина тривалості ночі, — традиційний час для навчання, молитви й медитації. Повертає {start, end}. |
| calcualte_special_tithi | — | Тітхі з її класичними особливими назвами: той самий об’єкт, що й у ключа tithi, плюс поле special_name — рядок через кому з усіма позначками, яким відповідає тітхі дня, або null, якщо таких немає. На практиці спрацьовують позначки, які залежать від того, чи чинна тітхі на момент сходу Сонця чи опівдні (Udayayvapini, Madhyanaha), а також позначки, специфічні для Амавасьї (Sinivaali, Vriddhigami); багато записів базової таблиці прив’язано до назв тітхі телугу, яких власний розрахунок тітхі цього ендпоінта не видає, тож вони ніколи не збігаються. Зверніть увагу: у назві ключа літери переставлено саме так, як показано. |
| chandrabalam | — | Чандрабала: які з висхідних знаків дня добре розташовані відносно поточного знака Місяця, а отже сприятливі для початку справи. Повертає список назв знаків у порядку від Овна до Риб — зазвичай шість із дванадцяти, — узятих із вікон udaya_lagna_muhurta, що починаються до наступного сходу Сонця. |
| choghadiya | — | Періоди чогхадії: світловий день і ніч поділено кожен на вісім рівних частин, назви яких ідуть по колу, починаючи з чогхадії, властивої цьому дню тижня. Повертає {day_choghadiyas, night_choghadiyas, current_choghadiya, day_periods, night_periods}. Два списки назв містять по вісім записів — цикл із семи назв, зсунутий так, щоб починатися з початкової назви дня, яка повторюється ще й у кінці; day_periods і night_periods містять ті самі вісім періодів у вигляді {name, start, end}, а current_choghadiya — назва періоду, на який припадає запитаний момент. |
| day_length | — | Тривалість світлового дня (захід мінус схід Сонця) для дня, на який припадає запитаний момент, у секундах. Повертається як JSON-РЯДОК, а не число — "48927.0", — тож перед обчисленнями перетворіть його на число. Більшість поділів дня в цьому ендпоінті — чогхадія, хора, rahu_kaalam, денні мухурти — це восьма, дванадцята чи п’ятнадцята частина цієї величини. |
| disha_shool | — | Напрямок, у якому сьогодні не слід вирушати в дорогу; залежить лише від дня тижня. Один рядок: East, South, West, North або один із чотирьох проміжних напрямків. |
| do_ghati | — | Повна таблиця тридцяти мухурт: п’ятнадцять ділять проміжок від сходу до заходу Сонця, і ще п’ятнадцять — від заходу до наступного сходу. Повертає {day_muhurtas, night_muhurtas, current}. Кожна мухурта — {index, number, muhurta, auspicious, name, division, special, start, end}: muhurta — божество-покровитель, number — її позиція 1-30 у межах усього дня й ночі, name — пов’язана накшатра, division — частина дня (Pratah, Sangava, Madhyahna тощо), auspicious — булеве значення, а special позначає вікна з власними назвами, як-от Абхіджит. current — запис, на який припадає запитаний момент, або null. |
| durmuhurata | — | Дурмухурта: одне чи два короткі несприятливі вікна дня. Повертає {first, second, interval}, де first і second — мітки часу ISO, а second дорівнює null у ті дні тижня, коли вікно лише одне. `interval` — тривалість кожного вікна в секундах; як і інші тривалості тут, це JSON-РЯДОК — "2880.0" для звичайних 48 хвилин. Зверніть увагу: відступи від сходу Сонця — це фіксовані години за таблицею днів тижня, а не пропорційні частини тривалості дня. |
| eccentric_anomaly | mean_anomaly, eccentricity, tolerance | Допоміжна функція небесної механіки загального призначення, а не астрологічна величина: розв’язує рівняння Кеплера методом Ньютона. Приймає mean_anomaly у градусах, eccentricity і необов’язковий tolerance (за замовчуванням 1e-6) і повертає одне число в градусах. |
| gauri_choghadiya | — | Гаурі панчангам — південноіндійський поділ на вісім частин, прийнятий у тамільській практиці: вісім денних і вісім нічних періодів, кожен — восьма частина світлового дня чи ночі; кожен має назву й позначку «добрий» чи «поганий» за таблицею днів тижня. Повертає {day_gowri, night_gowri}, кожен — список із восьми {name, status, start, end}, де status — 'Good' або 'Bad'. |
| godhuli_muhurta | — | Годхулі, година «коров’ячого пилу» довкола заходу Сонця: від чверті денної мухурти до заходу до чверті нічної мухурти після нього. Повертає {start, end}. |
| gulika_kaalam | — | Гуліка каалам, або Куліка: восьма частина світлового дня, що належить тіні Сатурна. На відміну від двох інших періодів, вважається сприятливим для справ, які мають тривати або повторюватися. Повертає {gulika_start, gulika_end}. Не плутати із записом 'gulika' в special_longitudes: там це положення в зодіаку, а не часове вікно. |
| hora | — | Двадцять чотири планетарні години: дванадцять рівних частин світлового дня і дванадцять — ночі, кожною з яких управляє планета в класичному порядку, починаючи з власного володаря дня тижня. Повертає {day_horas, night_horas}, кожен — список із дванадцяти {planet, start, end}. Денні й нічні хори різні за тривалістю, крім днів рівнодення. |
| kali_samvat | — | Рік Калі-юги: shaka_samvat плюс 3179; змінюється в день Чайтра Шукла Пратіпади. Одне ціле число. |
| karana | — | Карана, що діє в запитаний момент, — половина тітхі, шість градусів елонгації «Місяць мінус Сонце». Повертає одну з одинадцяти назв: сім рухомих — Bava, Balava, Kaulava, Taitula, Garaja, Vanija і Vishti — і чотири фіксовані — Kimstughna, Shakuni, Chatushpada і Naga. Вішті зазвичай називають Бхадрою, і її уникають. |
| karana_segments | — | Усі періоди каран, що припадають на місцевий календарний день, у вигляді впорядкованого списку {name, start_time, end_time}. Карана триває від одинадцяти до тринадцяти годин, тож розраховуйте на два-три записи на день. |
| lagnas | — | П’ять особливих асцендентів, що просуваються швидше за висхідний знак і всі відлічуються від сходу Сонця. Повертає об’єкт із 'Bhava Lagna' (один знак кожні дві години), 'Hora Lagna' (один знак за годину, розглядають щодо заробітку), 'Ghati Lagna' (один знак кожні двадцять чотири хвилини, розглядають щодо статусу й влади), 'Indu Lagna' (точка багатства, побудована з володарів дев’ятих домів, відлічених від асцендента й від Місяця) і 'Bhrigu Lagna' (середина між Місяцем і Раху, яку зазвичай називають Бхрігу-бінду), кожен — {degree, sign, minutes, seconds, nakshatra, pada}. |
| lunar_month | — | Місячний місяць аманта, на який припадає запитана дата, — від молодика до молодика, — з назвою за знаком Місяця в молодик, що його відкрив. Один рядок із дванадцяти, від Vaisakha до Chaitra. Адхіка-місяці (додаткові) окремо не позначаються. |
| lunar_month_poornima | — | Той самий місяць за ліком пурніманта: триває від однієї повні до наступної, а називається за знаком Сонця в повню, що його відкриває. Один рядок. Так лічать північноіндійські календарі, і в темну пакшу для того самого дня назва місяця тут інша, ніж у lunar_month. |
| lunar_phase | — | Елонгація від Сонця до Місяця і пакша, яку вона визначає. Повертає {paksha, moon_phase}, де moon_phase — кут у градусах від 0 до 360, а paksha — 'Shukla' нижче 180 і 'Krishna' від 180 і вище. |
| midday | — | Місцевий видимий полудень — момент, коли Сонце перетинає верхній меридіан у заданому місці; він на кілька хвилин відрізняється від полудня за годинником у той чи інший бік. Одна мітка часу зі зміщенням, переданим у timezone_as_float. |
| midnight | — | Нижня кульмінація Сонця, тобто істинна місцева північ. Одна мітка часу із запитаним зміщенням. Це не те саме, що середина ночі між заходом і сходом Сонця, довкола якої побудовано nishita_muhurta. |
| nakshatra_segments | — | Усі накшатри Місяця, що припадають на місцевий календарний день, у вигляді списку {name, start_time, end_time}. Межі — точні моменти перетину довготою Місяця меж накшатр, знайдені методом бісекції. Назви подано в сучасному написанні — Shatabhisha, Purva Bhadrapada, — а не в старіших транслітераціях, які використовують деякі інші ендпоінти цього API. |
| night_length | — | Від заходу Сонця до наступного сходу як тривалість у секундах; як і day_length, повертається JSON-РЯДКОМ, а не числом — "37464.0". Відповідник day_length і основа для нічних половин choghadiya, hora і do_ghati, а також для brahma_muhurta і nishita_muhurta. |
| nishita_muhurta | — | Нішіта: по одному гхаті з обох боків від середини ночі між заходом Сонця й наступним сходом, де гхаті — тридцята частина тривалості ночі. Повертає {start, end}. Середина ночі — не той самий момент, що північ. |
| panchaka_rahita | — | День, поділений на вікна; для кожного вказано панчаку, яка на нього припадає, за класичним правилом (тітхі + накшатра + день тижня + висхідний знак) mod 9. Повертає список {panchaka, start, end} від сходу Сонця до наступного сходу, де panchaka дорівнює null для чистого вікна, а інакше — одне з 'Mrityu Panchaka', 'Agni Panchaka', 'Raja Panchaka', 'Chora Panchaka' або 'Roga Panchaka'. Нове вікно починається з кожною зміною висхідного знака, а також із кожною зміною тітхі чи накшатри між ними, тож зазвичай виходить близько чотирнадцяти записів. |
| pratah_sandhya | — | Вікно ранкових сутінкових обрядів: від двох гхаті до сходу Сонця до одного після, де гхаті — тридцята частина тривалості дня. Повертає {start, end}. |
| rahu_kaalam | — | Раху кала: восьма частина світлового дня, яку вважають непридатною для початку будь-якої справи; її місце в межах дня визначає день тижня. Повертає {rahu_start, rahu_end}, між якими рівно восьма частина day_length. |
| ritu | mode | Сезон. mode обирає метод: 'drik' виводить його з тропічного знака Сонця, 'vedic' — з місячного місяця. Повертає {ritu, season, lord}, напр. {'Vasanta', 'Spring', 'Venus'}. Типове значення ядра — 'drik', а будь-яке інше значення, крім цих двох, мовчки повертає null, а не помилку. |
| samvatsara_name | samvata_type | Назва року в шістдесятирічному циклі Юпітера, від Prabhava до Kshaya. Потребує samvata_type: 'vikram' дає північноіндійську назву (самватсара середнього Юпітера, чинна на момент Меша-санкранті цього року), 'shaka' — південноіндійську, прив’язану до місячного року, тож ці дві назви можуть відрізнятися. Повертає один рядок; якщо samvata_type не передано, повертає помилку. |
| sankranti_dates | — | Інгресії Сонця в знаки з обох боків від запитаного моменту — межі сонячного місяця, у якому ви перебуваєте. Повертає {'Previous Sankranti', 'Next Sankranti'} як мітки часу із запитаним зміщенням. |
| sayahna_sandhya | — | Вікно вечірніх сутінкових обрядів: від одного гхаті до заходу Сонця до двох після нього; гхаті так само рахують від тривалості дня. Повертає {start, end}. |
| shaka_samvat | — | Рік ери Шака. Змінюється в день Чайтра Шукла Пратіпади, тож від січня до цього дня він дорівнює григоріанському року мінус 79, а після — григоріанському року мінус 78. Одне ціле число. |
| shiva_vasa_segments | — | Де перебуває Шива; таку саму перевірку роблять перед Рудрабхішекою. Визначається лише за тітхі. Повертає список {state, start_time, end_time}, по одному запису на кожен сегмент тітхі дня; state — один із семи станів: із Гаурі, на Кайласі, на Врішабсі (Нанді), за трапезою (Бходжанам), у Сабсі, за роботою/грою або в Шмашані; сприятливі з них — перші три. |
| shunya_nakshatra | — | Чи перебуває зараз Місяць в одній із двох-трьох накшатр, які вважаються порожніми для поточного місячного місяця аманта і в які не починають нових справ. Повертає рядок 'shunya_nakshatra', якщо так, а інакше — null. Це лише прапорець: ні назви, ні часового вікна у відповіді немає. |
| special_longitudes | — | Шість упаграх, що визначаються за часом. Світловий день або ніч ділять на вісім планетарних частин і беруть висхідний знак у вибраній точці певної частини. Повертає об’єкт із ключами 'kaala', 'mrityu', 'artha_praharaka', 'yama_ghantaka', 'maandi' і 'gulika', кожен — {degree, sign, minutes, seconds, nakshatra, pada}. Каала бере частину Сонця, Мрітью — частину Марса, Артха Прахарака і Яма Гхантака — середини частин Меркурія та Юпітера, а Гуліка й Маанді — частину Сатурна. Саме тому важливі поля запиту kala_mrityu_rise_at, gulika_rises_at і mandi_rises_at: Гуліку від Маанді відрізняє лише те, що взято — початок, середину чи кінець частини. |
| sree_lagna | — | Шрі-лагна, точка процвітання: асцендент, просунутий на ту частку його накшатри, яку вже пройшов Місяць, причому ця частка застосовується до всього зодіаку. Повертає один об’єкт {degree, sign, minutes, seconds, nakshatra, pada}. |
| tamil_solar_month_date | — | Дата тамільського сонячного календаря. Повертає {'Tamil Solar Month', 'Tamil Solar Date'} — назву місяця від Chithirai до Panguni і ціле число дня. Ця реалізація лічить дні від фіксованого Нового року 14 квітня блоками по тридцять днів, а не від фактичних моментів санкранті, тож результат може відрізнятися на день-два від опублікованого тамільського панчангаму. |
| tarabala | — | Тарабала: які з двадцяти семи накшатр народження сприятливо розташовані відносно накшатри транзитного Місяця. Повертає {good_nakshatras, valid_until, good_nakshatras_tier2, tier2_valid_until}. Перший список містить п’ятнадцять назв і чинний, доки Місяць не покине поточну накшатру в момент valid_until; пара tier2 застосовує те саме правило до наступної накшатри й чинна до наступного сходу Сонця. Якщо Місяць протягом дня не змінює накшатру, обидва поля tier2 дорівнюють null. |
| tithi | — | Місячний день у запитаний момент: {paksha, name, number, start_time, end_time, remaining_time}. number — 1-15 для Шукла, 16-29 для Крішна і 30 для Амавасьї, а remaining_time — {hours, minutes, seconds} до кінця тітхі. У повню й молодик поле paksha містить 'Purnima' або 'Amavasya', а не назву пакші. Усі тітхі, що припадають на день, повертає tithi_segments. |
| tithi_segments | — | Усі тітхі, що припадають на місцевий календарний день, у вигляді списку {paksha, name, number, start_time, end_time}. number — 1-15 у світлу пакшу, 16-29 у темну і 30 для Амавасьї. Зверніть увагу: у повню й молодик поле paksha містить 'Purnima' або 'Amavasya', а не 'Shukla' чи 'Krishna'. Тітхі триває в середньому 23.6 години, тож для більшості днів повертається один запис, а для деяких — два. |
| trikalam | — | Світловий день, поділений на три рівні частини. Повертає {morning, afternoon, evening}, кожна — {start, end}. Це простий поділ дня на третини, а не трійка Раху/Ямаганда/Гуліка, яку це слово позначає в деяких тамільських панчангамах. |
| true_anomaly | eccentric_anomaly, eccentricity | Парна функція перетворення: приймає eccentric_anomaly у градусах та eccentricity і повертає істинну аномалію в градусах — одне число. Зверніть увагу: ексцентричну аномалію вона зчитує з однойменного поля запиту, а не бере з ключа eccentric_anomaly в тому самому виклику. |
| udaya_lagna_muhurta | — | Дванадцять послідовних вікон висхідних знаків, що охоплюють день, починаючи зі знака, який сходить ще перед сходом Сонця. Повертає впорядкований список із дванадцяти {rashi, start, end} тривалістю близько однієї зоряної доби — це приблизно на чотири хвилини менше, ніж від сходу до сходу Сонця. chandrabalam і panchaka_rahita обчислюються на основі цього списку. |
| upagraha_longitudes | — | П’ять тіньових точок, які арифметично виводять із сидеричної довготи Сонця, кожну наступну — з попередньої: Дхума — Сонце плюс 133°20', далі Вьятіпата, Парівеша, Індрачапа й Упакету. Повертає об’єкт із ключами 'Dhuma', 'Vyatipata', 'Parivesha', 'Indrachapa' і 'Upaketu', кожен — {degree, sign, minutes, seconds, nakshatra, pada}. Поле dhuma_vyatipata_relation визначає, яка з двох класичних формул пов’язує Вьятіпату з Дхумою, а отже зсуває всі чотири наступні точки. |
| vaara | — | День тижня, що лічиться від сходу Сонця, а не від півночі, тож момент між північчю та сходом Сонця ще належить до попередньої вари. Один рядок: Ravivara, Somavara, Mangalavara, Budhavara, Guruvara, Shukravara або Shanivara. |
| vijaya_muhurta | — | Віджая-мухурта — 11-та з п’ятнадцяти рівних мухурт між сходом і заходом Сонця, після полудня; вікно для всього, що має вдатися всупереч протидії. Повертає {start, end}. |
| vikram_samvat | — | Рік Вікрам Самват. Змінюється в день Чайтра Шукла Пратіпади, тож від січня до цього дня він дорівнює григоріанському року плюс 56, а після — григоріанському року плюс 57. Одне ціле число. |
| yamaganda_kaalam | — | Ямаганда каалам — друга несприятлива восьма частина світлового дня, що визначається днем тижня. Повертає {yamaganda_start, yamaganda_end}. |
| yoga_segments | — | Усі періоди нітья-йог, що припадають на місцевий календарний день, у вигляді впорядкованого списку {name, start_time, end_time}. Йога триває в середньому близько 22.6 години, тож на день зазвичай припадає дві. Межі — точні моменти, коли сума довгот Сонця й Місяця перетинає межу йоги, без округлення до дня. |
| yogam | — | Нітья-йога: сидеричні довготи Сонця й Місяця додають, а суму ділять на двадцять сім рівних дуг по 13°20'. Повертає одну назву, від Vishkambha до Vaidhriti, для запитаного моменту. Періоди до й після цього моменту повертає yoga_segments. |
| yogas | — | Поєднання тітхі, накшатри й дня тижня з власними назвами, чинні в цей момент, — сприятливі й несприятливі «йоги», які панчанг перелічує для дня, як-от Sarvartha Siddhi, Amrit Siddhi, Dwipushkara, Tripushkara, Guru Pushya, Ravi Pushya, Panchaka, Dagdha, Yama Ghanta і ще десятки інших із приблизно двадцяти класичних таблиць. Повертає {yogas: [...]} — список назв, порожній, якщо жодна йога не діє. Не плутати з yogam — єдиною нітья-йогою поточного моменту. |
Приклад запиту
curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-06-02T06:30:52.786Z","keys":["midday"],"latitude":26.849,"longitude":75.768,"timezone_as_float":5.5,"samvata_type":"shaka","mode":0,"mean_anomaly":0,"eccentricity":1,"tolerance":0.000001,"gulika_rises_at":"beginning","mandi_rises_at":"middle","kala_mrityu_rise_at":"middle","dhuma_vyatipata_relation":"360_minus_dhuma"}'Відповідь
{
"data": {
"midday": "2026-06-02T12:24:53+05:30"
},
"status": 200,
"is_error": false,
"message": "successful"
}Записано з реального виклику з точно таким запитом, як вище. Результати лежать у data під тими ключами, які ви запитали.
Помилки
Помилки обліку кредитів мають вигляд { "error": "…", "message": "<code>", "is_error": true }. Людям показуйте error, а логіку будуйте на message. Детальніше — у довіднику помилок.