/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, а для всего, что зависит от восхода, — ещё и широта с долготой. Некоторые необязательные поля меняют сам ответ, а не только его формат: 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 записей, где есть Abhijit и используются современные написания. Поскольку значение дальше не передаётся, ключ '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)'. Хомы ради определённого результата полагается проводить, пока Агни находится на Prithvi; is_patala отмечает состояние, которое в некоторых панчангах называют Bhadravasa. |
| amrit_kalam | — | Периоды типа Amrit из Гоури-панчангам, приходящиеся на этот день, — самые благоприятные строки этой таблицы. Возвращает список {start, end}, обычно из двух элементов: один в светлое время суток, другой ночью. Вычисляется по тем же таблицам дней недели, что и gauri_choghadiya, и не связан с Amrita Gadiya, которую в некоторых других панчангах считают по накшатрам. |
| 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), и метки, относящиеся только к Amavasya (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"), поэтому перед вычислениями преобразуйте её в число. Большинство значений этого эндпоинта, основанных на делении дня, — choghadiya, hora, 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 отмечает именованные окна, например Abhijit. 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; меняется в Chaitra Shukla Pratipada. Одно целое число. |
| karana | — | Карана, действующая в запрошенный момент, — половина титхи, шесть градусов элонгации «Луна минус Солнце». Возвращает одно из одиннадцати названий: семь подвижных — Bava, Balava, Kaulava, Taitula, Garaja, Vanija и Vishti — и четыре неподвижных — Kimstughna, Shakuni, Chatushpada и Naga. Vishti обычно называют Bhadra и избегают. |
| 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 | — | Год эры Шака. Он меняется в Chaitra Shukla Pratipada: с января до этого дня он равен григорианскому году минус 79, а после — григорианскому году минус 78. Одно целое число. |
| shiva_vasa_segments | — | Где пребывает Шива — такая же проверка, но перед рудрабхишекой; определяется только по титхи. Возвращает список {state, start_time, end_time}, по одному элементу на каждый сегмент титхи в этот день. state — одно из семи состояний: с Gowri, в Kailasha, на Vrishabha (Nandi), в Bhojanam, в Sabha, за работой или игрой (Work/Play) или в Shmashana; благоприятны первые три. |
| shunya_nakshatra | — | Находится ли Луна сейчас в одной из двух-трёх накшатр, которые в текущем лунном месяце аманта считаются пустыми; в такие накшатры новых дел не начинают. Возвращает строку 'shunya_nakshatra', если находится, и null, если нет. Это только флаг: ни названия, ни временного окна в ответе нет. |
| special_longitudes | — | Шесть упаграх, которые вычисляются по времени. Светлое время суток или ночь делится на восемь планетарных частей, и восходящий знак берётся в выбранной точке определённой части. Возвращает объект с ключами 'kaala', 'mrityu', 'artha_praharaka', 'yama_ghantaka', 'maandi' и 'gulika', каждый — {degree, sign, minutes, seconds, nakshatra, pada}. Kaala берётся по части Солнца, Mrityu — по части Марса, Artha Praharaka и Yama Ghantaka — по серединам частей Меркурия и Юпитера, а Gulika и Maandi — по части Сатурна. Поэтому и важны поля запроса kala_mrityu_rise_at, gulika_rises_at и mandi_rises_at: Gulika от Maandi отличает именно выбор начала, середины или конца части. |
| 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 для Amavasya, а 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 для Amavasya. Обратите внимание: в полнолуние и новолуние в поле 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 | — | Пять теневых точек, которые арифметически выводятся из сидерической долготы Солнца, каждая — из предыдущей: Dhuma — Солнце плюс 133°20', затем Vyatipata, Parivesha, Indrachapa и Upaketu. Возвращает объект с ключами 'Dhuma', 'Vyatipata', 'Parivesha', 'Indrachapa' и 'Upaketu', каждый — {degree, sign, minutes, seconds, nakshatra, pada}. Поле dhuma_vyatipata_relation выбирает, какая из двух классических формул связывает Vyatipata с Dhuma, и тем самым сдвигает все четыре следующие точки. |
| vaara | — | День недели, который отсчитывается от восхода Солнца, а не от полуночи, поэтому момент между полуночью и восходом ещё относится к предыдущей варе. Одна строка: Ravivara, Somavara, Mangalavara, Budhavara, Guruvara, Shukravara или Shanivara. |
| vijaya_muhurta | — | Виджая мухурта — 11-я из пятнадцати равных мухурт между восходом и заходом Солнца, во второй половине дня; окно для всего, что должно увенчаться успехом вопреки противодействию. Возвращает {start, end}. |
| vikram_samvat | — | Год Викрам-самвата. Он меняется в Chaitra Shukla Pratipada: с января до этого дня он равен григорианскому году плюс 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. Подробнее — в справочнике ошибок.