/api/astro/panchanga/1 créditoPanchanga
El panchanga es el almanaque hindú para un momento y un lugar: los cinco «miembros» (tithi, vaara, nakshatra, yoga y karana) y todo lo demás que trae un panchang impreso. Es el endpoint más grande de la API, con cincuenta y siete claves, y casi todos los clientes usan solo unas pocas. Empieza con tithi, vaara, nakshatra_segments, yogam y karana para los cinco miembros, y con day_length, night_length, midday y midnight para el marco del día. Las claves *_segments (tithi_segments, karana_segments, yoga_segments, nakshatra_segments) se diferencian de sus equivalentes en singular en un detalle en el que es fácil equivocarse: la clave en singular responde a «qué está vigente en este instante», mientras que la de segmentos enumera todos los periodos que coinciden con el día del calendario local, con horas exactas de inicio y fin, que es lo que necesita una página de calendario. El resto se agrupa así. Divisiones del tiempo: choghadiya y gauri_choghadiya en octavos, hora en horas planetarias, do_ghati en los treinta muhurtas, trikalam en tercios. Franjas con nombre: abhijit_muhurta, brahma_muhurta, vijaya_muhurta, nishita_muhurta, godhuli_muhurta, amrit_kalam y los dos sandhyas, frente a rahu_kaalam, yamaganda_kaalam, gulika_kaalam y durmuhurata. Calendario: lunar_month y lunar_month_poornima (el mismo mes según los dos cómputos), shaka_samvat, vikram_samvat, kali_samvat, samvatsara_name, ritu, sankranti_dates y tamil_solar_month_date. Posiciones en lugar de horas: upagraha_longitudes, special_longitudes, lagnas, sree_lagna y las dos variantes de bhaava_madhya. Valoraciones de la calidad del día: tarabala, chandrabalam, panchaka_rahita, disha_shool, agni_vasa_segments, shiva_vasa_segments, yogas y shunya_nakshatra. Todas las llamadas necesitan date_time y timezone_as_float, y todo lo que depende de la salida del sol necesita además latitude y longitude. Varios campos opcionales cambian el resultado, no solo el formato: samvata_type es obligatorio para samvatsara_name, mode elige cómo se obtiene ritu, y gulika_rises_at, mandi_rises_at, gulika_portion, mandi_portion, kala_mrityu_rise_at y dhuma_vyatipata_relation eligen entre distintas convenciones clásicas para las posiciones de los upagrahas. Una llamada cuesta un crédito sin importar cuántas claves pidas, así que pide de una vez todo lo que necesite una página.
https://api.occultapi.com/api/astro/panchanga/
Autenticación
Envía tu clave en la cabecera X-API-Key. La clave es una credencial de servidor: nunca la pongas en el JavaScript del navegador ni en una app móvil.
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonCampos de la solicitud
| Campo | Tipo | Obligatorio | Notas |
|---|---|---|---|
| date_time | string (date-time) | obligatorio | El momento del cálculo, en ISO 8601. Incluye SIEMPRE la diferencia con UTC o una Z final: un valor sin zona horaria se interpreta como Asia/Kolkata (UTC+05:30), no como UTC, y puede devolver con un 200 el resultado del día anterior. '2026-09-01T06:00:00Z' y '2026-09-01 06:00:00' son instantes distintos y dan respuestas distintas. |
| keys | array | obligatorio | Los cálculos que quieres recibir, como lista de nombres. Consulta la tabla de claves de este endpoint; un nombre que no se reconoce invalida toda la solicitud. Cada llamada cuesta un crédito, pidas las claves que pidas, así que pide todo lo que necesites de una vez en lugar de hacer varias llamadas. |
| timezone_as_float | number (double) | obligatorio | Diferencia horaria del lugar con UTC, en horas y con decimales. Ejemplo: 5.5 para la India (UTC+05:30), -5 para Nueva York en invierno, 5.75 para Nepal. NO se contrasta con date_time: si los dos no coinciden, recibes una respuesta correcta para un momento equivocado, así que toma ambos valores de la misma fuente. Usa la diferencia vigente en esa fecha, no la de hoy: para un nacimiento en verano en un país con horario de verano, hace falta la diferencia de verano. min -12 · max 14 |
| dhuma_vyatipata_relation | string | opcional | 360_minus_dhumadhuma_plus_53_20Valor por defecto: '360_minus_dhuma'. Se reenvía. |
| eccentric_anomaly | number (double) | opcional | |
| eccentricity | number (double) | opcional | |
| gulika_portion | string | opcional | saturneighthValor por defecto: 'saturn'. Se reenvía. |
| gulika_rises_at | string | opcional | beginningmiddleendValor por defecto: 'beginning'. Se reenvía al objeto del motor Panchanga. |
| kala_mrityu_rise_at | string | opcional | beginningmiddleendValor por defecto: 'middle'. Se reenvía. |
| latitude | number (double) | opcional | Latitud del lugar, en grados decimales. Los valores positivos indican el norte y los negativos, el sur. Ejemplo: 26.9124 para Jaipur, 40.7128 para Nueva York. No se aceptan minutos ni segundos: conviértelos antes. min -89.9 · max 89.9 |
| longitude | number (double) | opcional | Longitud del lugar, en grados decimales. Los valores positivos indican el este y los negativos, el oeste. Ejemplo: 75.7873 para Jaipur, -74.0060 para Nueva York. Cuidado con el signo: si falta el menos, Nueva York acaba en China. min -180 · max 180 |
| mandi_portion | string | opcional | saturneighthValor por defecto: 'saturn'. Se reenvía. |
| mandi_rises_at | string | opcional | beginningmiddleendValor por defecto: 'middle'. Se reenvía. |
| mean_anomaly | number (double) | opcional | |
| mode | string | opcional | vedicdrikSolo lo usa la clave 'ritu'. 'vedic' obtiene la estación del año a partir del mes lunar, y 'drik', a partir del signo tropical del Sol. El valor por defecto del motor es 'drik'. ADVERTENCIA: la función no da error con un valor incorrecto: cualquier otra cadena no entra en ninguna de las dos ramas y la clave devuelve null sin aviso (el ejemplo del catálogo publicado llega a enviar mode=0 y recibe un 200 con resultado null). |
| nakshatras | string | opcional | specialEn el motor, el único valor con sentido es la cadena literal 'special', que sustituye la tabla `nakshatras` de 27 entradas por la tabla `nakshatras_special` de 28 entradas, que incluye Abhijit y usa grafías modernas. Como nunca se reenvía, la clave 'yogas' de este endpoint devuelve actualmente un 500 con "'Panchanga' object has no attribute 'nakshatras'". |
| samvata_type | string | opcional | shakavikramSolo lo usa la clave 'samvatsara_name'. |
| tolerance | number (double) | opcional |
Claves disponibles (57)
Indica en keys exactamente los cálculos que quieres. Si una clave no existe, se rechaza toda la solicitud. Pidas las que pidas, se cobra 1 crédito, así que agrúpalas en una sola llamada.
| Clave | Campos adicionales | Descripción |
|---|---|---|
| abhijit_muhurta | — | Abhijit: el octavo de los quince muhurtas del día, que abarca el punto medio de las horas de luz; la franja propicia para cualquier fin. Devuelve {start, end}. |
| agni_vasa_segments | — | Dónde se dice que reside Agni, la deidad del fuego: la comprobación que se hace antes de un homa. Depende del tithi y del día de la semana, así que cambia cuando cambia el tithi. Devuelve una lista de {state, is_patala, start_time, end_time}, una por cada segmento de tithi del día, donde state es 'Prithvi (Earth)', 'Akasha (Heaven)' o 'Patala (Nadir)'. Los homas que buscan un resultado concreto deben hacerse mientras Agni está en Prithvi; is_patala marca el estado que algunos panchangs llaman Bhadravasa. |
| amrit_kalam | — | Los periodos de tipo Amrit del Gowri Panchangam que coinciden con el día: las filas más favorables de esa tabla. Devuelve una lista de {start, end}, normalmente dos, una en las horas de luz y otra de noche. Sale de las mismas tablas por día de la semana que gauri_choghadiya y no tiene nada que ver con el Amrita Gadiya basado en nakshatras de otros panchangs. |
| bhaava_madhya_sripati | — | Las doce cúspides con la misma estructura {degree, sign, minutes, seconds, nakshatra, pada} que bhaava_madhya_swe. Aunque en la tradición clásica el sistema Sripati divide por cuadrantes, esta implementación solo toma de él el ascendente y luego va sumando treinta grados, así que para un mismo momento devuelve los mismos doce valores que bhaava_madhya_swe. |
| bhaava_madhya_swe | — | Las doce cúspides de las casas en el sistema de casas iguales del zodíaco sideral, empezando por la primera casa. Devuelve una lista de doce objetos, cada uno {degree, sign, minutes, seconds, nakshatra, pada}, donde sign es una abreviatura de dos letras como 'Ar' o 'Cp'. |
| brahma_muhurta | — | Brahma Muhurta: los dos últimos muhurtas de la noche antes de la salida del sol, cada uno de una decimoquinta parte de la noche; el momento tradicional para el estudio, la oración y la meditación. Devuelve {start, end}. |
| calcualte_special_tithi | — | El tithi con sus nombres especiales clásicos: el mismo objeto que la clave tithi más un campo special_name, con una cadena separada por comas de todas las etiquetas que corresponden al tithi del día, o null si no corresponde ninguna. En la práctica, las etiquetas que se activan son las que dependen de que el tithi esté vigente a la salida del sol o al mediodía (Udayayvapini, Madhyanaha) y las propias de Amavasya (Sinivaali, Vriddhigami); muchas entradas de la tabla subyacente usan nombres de tithi en telugu que el cálculo de tithi de este endpoint no produce, así que nunca coinciden. Ten en cuenta que el nombre de la clave se escribe con la transposición indicada. |
| chandrabalam | — | Chandra Bala: qué signos ascendentes del día están bien situados respecto al signo actual de la Luna y, por tanto, son favorables para empezar algo. Devuelve una lista de nombres de signos en orden de Aries a Piscis, normalmente seis de los doce, tomados de las franjas udaya_lagna_muhurta que empiezan antes de la siguiente salida del sol. |
| choghadiya | — | Los periodos de Choghadiya: el día y la noche se dividen cada uno en ocho partes iguales, con nombres que rotan a partir del Choghadiya propio del día de la semana. Devuelve {day_choghadiyas, night_choghadiyas, current_choghadiya, day_periods, night_periods}. Las dos listas de nombres tienen ocho entradas cada una (el ciclo de siete nombres, rotado hasta el nombre con que empieza el día y con ese nombre repetido al final); day_periods y night_periods dan esos mismos ocho como {name, start, end}, y current_choghadiya es el nombre que cubre el instante solicitado. |
| day_length | — | La puesta del sol menos la salida del sol del día en que cae el momento solicitado, como duración en segundos. Se devuelve como CADENA JSON, no como número ("48927.0"), así que conviértela antes de operar con ella. Casi todos los valores de este endpoint que dividen el día (choghadiya, hora, rahu_kaalam, los muhurtas del día) son octavos, doceavos o quinceavos de esta cifra. |
| disha_shool | — | La dirección hacia la que conviene no viajar hoy; depende solo del día de la semana. Una única cadena: East, South, West, North o una de las cuatro direcciones intermedias. |
| do_ghati | — | La tabla completa de los treinta muhurtas: quince entre la salida y la puesta del sol, y quince entre la puesta y la siguiente salida. Devuelve {day_muhurtas, night_muhurtas, current}. Cada muhurta es {index, number, muhurta, auspicious, name, division, special, start, end}: muhurta es la deidad que lo preside, number su posición de 1-30 en todo el día y la noche, name el nakshatra asociado, division la parte del día (Pratah, Sangava, Madhyahna, etc.), auspicious un booleano, y special marca las franjas con nombre propio, como Abhijit. current es la entrada que contiene el instante solicitado, o null. |
| durmuhurata | — | Durmuhurta: la franja o las dos franjas breves desfavorables del día. Devuelve {first, second, interval}, donde first y second son marcas de tiempo ISO y second es null los días de la semana que solo tienen una. `interval` es la duración de cada una en segundos y, como las demás duraciones de este endpoint, es una CADENA JSON: "2880.0" para los 48 minutos habituales. Ten en cuenta que la distancia desde la salida del sol son horas de reloj fijas tomadas de una tabla por día de la semana, no divisiones proporcionales de la duración del día. |
| eccentric_anomaly | mean_anomaly, eccentricity, tolerance | Una función auxiliar general de mecánica orbital, no una magnitud astrológica: resuelve la ecuación de Kepler por iteración de Newton. Recibe mean_anomaly en grados, eccentricity y una tolerance opcional (por defecto 1e-6), y devuelve un único número en grados. |
| gauri_choghadiya | — | Gowri Panchangam, la división en ocho partes del sur de la India que se usa en la práctica tamil: ocho periodos de día y ocho de noche, cada uno de un octavo del día o de la noche, con su nombre y su valoración (bueno o malo) según una tabla indexada por día de la semana. Devuelve {day_gowri, night_gowri}, cada uno una lista de ocho {name, status, start, end}, donde status es 'Good' o 'Bad'. |
| godhuli_muhurta | — | Godhuli, la «hora del polvo de las vacas» en torno a la puesta del sol: desde un cuarto de un muhurta diurno antes de la puesta del sol hasta un cuarto de un muhurta nocturno después. Devuelve {start, end}. |
| gulika_kaalam | — | Gulika Kaalam, también llamado Kulika: el octavo del día asignado a la sombra de Saturno. A diferencia de los otros dos, se considera favorable para lo que debe durar o repetirse. Devuelve {gulika_start, gulika_end}. No confundir con la entrada 'gulika' de special_longitudes, que es una posición zodiacal y no una franja horaria. |
| hora | — | Las veinticuatro horas planetarias: doce divisiones iguales del día y doce de la noche, cada una regida por un planeta en el orden clásico, empezando por el propio señor del día de la semana. Devuelve {day_horas, night_horas}, cada uno una lista de doce {planet, start, end}. Las horas diurnas y las nocturnas tienen duraciones distintas salvo en los equinoccios. |
| kali_samvat | — | El año del Kali Yuga: shaka_samvat más 3179; cambia en el Chaitra Shukla Pratipada. Un único entero. |
| karana | — | El karana vigente en el instante solicitado: medio tithi, seis grados de elongación Luna menos Sol. Devuelve uno de once nombres: los siete móviles Bava, Balava, Kaulava, Taitula, Garaja, Vanija y Vishti, y los cuatro fijos Kimstughna, Shakuni, Chatushpada y Naga. Vishti es el que suele llamarse Bhadra y se evita. |
| karana_segments | — | Cada periodo de karana que se solapa con el día del calendario local, como lista de {name, start_time, end_time} en orden. Un karana dura de once a trece horas, así que cuenta con dos o tres entradas por día. |
| lagnas | — | Cinco ascendentes especiales que avanzan más deprisa que el signo ascendente, todos medidos desde la salida del sol. Devuelve un objeto con 'Bhava Lagna' (un signo cada dos horas), 'Hora Lagna' (un signo por hora; se interpreta para los ingresos), 'Ghati Lagna' (un signo cada veinticuatro minutos; se interpreta para el estatus y la autoridad), 'Indu Lagna' (el punto de riqueza construido a partir de los señores de la casa nueve contados desde el ascendente y desde la Luna) y 'Bhrigu Lagna' (el punto medio Luna-Rahu, normalmente llamado Bhrigu Bindu), cada uno {degree, sign, minutes, seconds, nakshatra, pada}. |
| lunar_month | — | El mes lunar amanta que contiene la fecha solicitada (de luna nueva a luna nueva), que toma su nombre del signo de la Luna en la luna nueva con que empieza. Una única cadena entre las doce, de Vaisakha a Chaitra. Los meses adhika (intercalares) no se marcan aparte. |
| lunar_month_poornima | — | El mismo mes según el cómputo purnimanta, que va de una luna llena a la siguiente y toma su nombre del signo del Sol en la luna llena con que empieza. Una única cadena. Es el cómputo de los calendarios del norte de la India, y en la quincena oscura da al mes un nombre distinto del de lunar_month para el mismo día. |
| lunar_phase | — | La elongación Sol-Luna y la quincena que le corresponde. Devuelve {paksha, moon_phase}, donde moon_phase es el ángulo en grados de 0 a 360 y paksha es 'Shukla' por debajo de 180 y 'Krishna' de 180 en adelante. |
| midday | — | El mediodía aparente local: el momento en que el Sol cruza el meridiano superior en el lugar indicado, unos minutos antes o después del mediodía del reloj. Una única marca de tiempo con la diferencia horaria indicada en timezone_as_float. |
| midnight | — | El paso del Sol por el meridiano inferior, es decir, la medianoche local verdadera. Una única marca de tiempo con la diferencia horaria solicitada. No coincide con el punto medio de la noche entre la puesta y la salida del sol, que es en torno al que se construye nishita_muhurta. |
| nakshatra_segments | — | Cada nakshatra de la Luna que se solapa con el día del calendario local, como lista de {name, start_time, end_time}. Los límites son cruces exactos de longitud lunar hallados por bisección. Los nombres usan las grafías modernas (Shatabhisha, Purva Bhadrapada) en lugar de las transliteraciones más antiguas que usan otros endpoints de esta API. |
| night_length | — | De la puesta del sol a la siguiente salida, como duración en segundos. Igual que day_length, se devuelve como CADENA JSON y no como número: "37464.0". Es el complemento de day_length y la base de las mitades nocturnas de choghadiya, hora y do_ghati, además de brahma_muhurta y nishita_muhurta. |
| nishita_muhurta | — | Nishita, un ghati a cada lado del punto medio de la noche entre la puesta del sol y la siguiente salida; aquí un ghati es la trigésima parte de la duración de la noche. Devuelve {start, end}. La mitad de la noche no es el mismo instante que la medianoche. |
| panchaka_rahita | — | El día dividido en franjas, cada una con el panchaka que le corresponde según la regla clásica (tithi + nakshatra + día de la semana + signo ascendente) mod 9. Devuelve una lista de {panchaka, start, end} desde la salida del sol hasta la siguiente salida, donde panchaka es null si la franja está libre y, si no, uno de 'Mrityu Panchaka', 'Agni Panchaka', 'Raja Panchaka', 'Chora Panchaka' o 'Roga Panchaka'. Las franjas se cortan en cada cambio de signo ascendente y en cada cambio de tithi o de nakshatra que haya entre medias, así que lo normal son unas catorce entradas. |
| pratah_sandhya | — | La franja de observancia del crepúsculo matutino: de dos ghatis antes de la salida del sol a uno después; aquí un ghati es la trigésima parte de la duración del día. Devuelve {start, end}. |
| rahu_kaalam | — | Rahu Kaalam: el octavo del día que se considera inadecuado para empezar cualquier cosa; su posición dentro del día la fija el día de la semana. Devuelve {rahu_start, rahu_end}, separados por un octavo de day_length. |
| ritu | mode | La estación del año. mode elige el método: 'drik' la obtiene del signo tropical del Sol y 'vedic', del mes lunar. Devuelve {ritu, season, lord}, por ejemplo {'Vasanta', 'Spring', 'Venus'}. El valor por defecto del motor es 'drik', y cualquier otro valor devuelve null sin aviso en lugar de dar error. |
| samvatsara_name | samvata_type | El nombre del año en el ciclo joviano de sesenta años, de Prabhava a Kshaya. Requiere samvata_type: 'vikram' da el nombre del norte de la India (el samvatsara de Júpiter medio vigente en el Mesha sankranti del año) y 'shaka', el nombre del sur de la India, ligado al año lunar, así que los dos pueden no coincidir. Devuelve una única cadena y da error si se omite samvata_type. |
| sankranti_dates | — | Los ingresos del Sol en los signos a uno y otro lado del momento solicitado: los límites del mes solar en el que estás. Devuelve {'Previous Sankranti', 'Next Sankranti'} como marcas de tiempo con la diferencia horaria solicitada. |
| sayahna_sandhya | — | La franja de observancia del crepúsculo vespertino: de un ghati antes de la puesta del sol a dos después, de nuevo con ghatis basados en la duración del día. Devuelve {start, end}. |
| shaka_samvat | — | El año de la era Shaka. Cambia en el Chaitra Shukla Pratipada, así que desde enero hasta esa fecha es el año gregoriano menos 79 y, a partir de ella, el año gregoriano menos 78. Un único entero. |
| shiva_vasa_segments | — | Dónde reside Shiva: la comprobación equivalente antes de un Rudrabhisheka, que depende solo del tithi. Devuelve una lista de {state, start_time, end_time}, una por cada segmento de tithi del día; state es uno de siete estados —con Gowri, en Kailasha, sobre Vrishabha (Nandi), en Bhojanam, en Sabha, en el trabajo/juego o en Shmashana—, y los tres primeros son los favorables. |
| shunya_nakshatra | — | Indica si la Luna está ahora en uno de los dos o tres nakshatras que se consideran vacíos en el mes lunar amanta en curso, en los que se evita emprender nada nuevo. Devuelve la cadena 'shunya_nakshatra' si es así y null si no: es solo un indicador, sin nombre ni franja en la respuesta. |
| special_longitudes | — | Los seis upagrahas que se obtienen del tiempo. El día o la noche se divide en ocho partes planetarias y se toma el signo ascendente en un punto elegido dentro de una parte concreta. Devuelve un objeto con las claves 'kaala', 'mrityu', 'artha_praharaka', 'yama_ghantaka', 'maandi' y 'gulika', cada una {degree, sign, minutes, seconds, nakshatra, pada}. Kaala usa la parte del Sol; Mrityu, la de Marte; Artha Praharaka y Yama Ghantaka, la mitad de las partes de Mercurio y de Júpiter; y Gulika y Maandi, la parte de Saturno. Por eso importan los campos kala_mrityu_rise_at, gulika_rises_at y mandi_rises_at de la solicitud: tomar el inicio, la mitad o el final de la parte es lo que distingue a Gulika de Maandi. |
| sree_lagna | — | Sree Lagna, el punto de prosperidad: el ascendente avanzado según la fracción de su nakshatra que la Luna ya ha recorrido, aplicando esa fracción a todo el zodíaco. Devuelve un único {degree, sign, minutes, seconds, nakshatra, pada}. |
| tamil_solar_month_date | — | La fecha del calendario solar tamil. Devuelve {'Tamil Solar Month', 'Tamil Solar Date'}: el nombre del mes, de Chithirai a Panguni, y el día como entero. Esta implementación cuenta los días en bloques de treinta desde un año nuevo fijo el 14 de abril, no desde los instantes reales de cada sankranti, así que puede diferir en uno o dos días de un panchangam tamil publicado. |
| tarabala | — | Tara Bala: qué nakshatras de nacimiento, de los veintisiete, están en posición favorable respecto al nakshatra de la Luna en tránsito. Devuelve {good_nakshatras, valid_until, good_nakshatras_tier2, tier2_valid_until}. La primera lista tiene quince nombres y es válida hasta que la Luna sale de su nakshatra actual, en valid_until; el par tier2 aplica la misma regla al nakshatra siguiente y es válido hasta la próxima salida del sol. Los dos campos tier2 son null cuando la Luna no cambia de nakshatra en el día. |
| tithi | — | El día lunar en el instante solicitado: {paksha, name, number, start_time, end_time, remaining_time}. number es 1-15 para Shukla, 16-29 para Krishna y 30 para Amavasya, y remaining_time es {hours, minutes, seconds} hasta que termina el tithi. En luna llena y luna nueva, el campo paksha indica 'Purnima' o 'Amavasya' en lugar del nombre de la quincena. Para cada tithi que coincide con el día, usa tithi_segments. |
| tithi_segments | — | Cada tithi que se solapa con el día del calendario local, como lista de {paksha, name, number, start_time, end_time}. number es 1-15 en la quincena clara, 16-29 en la oscura y 30 para Amavasya. Ten en cuenta que en luna llena y luna nueva el campo paksha indica 'Purnima' o 'Amavasya' en lugar de 'Shukla' o 'Krishna'. Un tithi dura de media 23.6 horas, así que la mayoría de los días devuelven una entrada y algunos, dos. |
| trikalam | — | Las horas de luz divididas en tres partes iguales. Devuelve {morning, afternoon, evening}, cada uno {start, end}. Es una simple división del día en tercios, no el trío Rahu/Yamaganda/Gulika que el término designa en algunos panchangams tamiles. |
| true_anomaly | eccentric_anomaly, eccentricity | El conversor complementario: recibe eccentric_anomaly en grados y eccentricity, y devuelve la anomalía verdadera en grados, como un único número. Ten en cuenta que lee la anomalía excéntrica del campo de la solicitud con ese nombre: no la toma de la clave eccentric_anomaly de la misma llamada. |
| udaya_lagna_muhurta | — | Las doce franjas consecutivas de signo ascendente que cubren el día, a partir del signo que ya asciende justo antes de la salida del sol. Devuelve una lista ordenada de doce {rashi, start, end} que abarca aproximadamente un día sideral, unos cuatro minutos menos que de una salida del sol a la siguiente. chandrabalam y panchaka_rahita se calculan a partir de esta lista. |
| upagraha_longitudes | — | Los cinco puntos sombra derivados aritméticamente de la longitud sideral del Sol, cada uno a partir del anterior: Dhuma en el Sol más 133°20', luego Vyatipata, Parivesha, Indrachapa y Upaketu. Devuelve un objeto con las claves 'Dhuma', 'Vyatipata', 'Parivesha', 'Indrachapa' y 'Upaketu', cada una {degree, sign, minutes, seconds, nakshatra, pada}. El campo dhuma_vyatipata_relation elige cuál de las dos fórmulas clásicas vincula Vyatipata con Dhuma y, por tanto, desplaza los cuatro puntos que la siguen. |
| vaara | — | El día de la semana, contado desde la salida del sol y no desde la medianoche, así que un momento entre la medianoche y la salida del sol sigue perteneciendo al vaara anterior. Una única cadena: Ravivara, Somavara, Mangalavara, Budhavara, Guruvara, Shukravara o Shanivara. |
| vijaya_muhurta | — | Vijaya Muhurta, el 11.º de los quince muhurtas iguales entre la salida y la puesta del sol, por la tarde: la franja para todo lo que tiene que salir adelante frente a la oposición. Devuelve {start, end}. |
| vikram_samvat | — | El año del Vikram Samvat. Cambia en el Chaitra Shukla Pratipada, así que desde enero hasta esa fecha es el año gregoriano más 56 y, a partir de ella, el año gregoriano más 57. Un único entero. |
| yamaganda_kaalam | — | Yamaganda Kaalam: otro octavo desfavorable del día, también determinado por el día de la semana. Devuelve {yamaganda_start, yamaganda_end}. |
| yoga_segments | — | Cada periodo de Nityayoga que se solapa con el día del calendario local, como lista de {name, start_time, end_time} en orden. Un yoga dura de media unas 22.6 horas, así que un día suele abarcar dos. Los límites son los instantes exactos de cruce de la suma de longitudes Sol más Luna, no redondeados al día. |
| yogam | — | El Nityayoga: las longitudes siderales del Sol y de la Luna sumadas y el total dividido en veintisiete arcos iguales de 13°20'. Devuelve un único nombre, de Vishkambha a Vaidhriti, para el instante solicitado. Para los periodos a ambos lados de ese instante, usa yoga_segments. |
| yogas | — | Las combinaciones con nombre de tithi, nakshatra y día de la semana que están vigentes: los «yogas» propicios y desfavorables que un panchang enumera para el día, como Sarvartha Siddhi, Amrit Siddhi, Dwipushkara, Tripushkara, Guru Pushya, Ravi Pushya, Panchaka, Dagdha, Yama Ghanta y decenas más, sacados de unas veinte tablas clásicas. Devuelve {yogas: [...]}, una lista de nombres que está vacía cuando no se cumple ninguno. No confundir con yogam, que es el Nityayoga del momento (uno solo). |
Ejemplo de solicitud
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"}'Respuesta
{
"data": {
"midday": "2026-06-02T12:24:53+05:30"
},
"status": 200,
"is_error": false,
"message": "successful"
}Obtenida de una llamada real con la solicitud de arriba, tal cual. Los resultados van dentro de data, cada uno bajo la clave que pediste.
Errores
Los errores de control de uso devuelven { "error": "…", "message": "<code>", "is_error": true }. Muestra error al usuario y usa message para decidir qué hace tu código. Consulta la referencia de errores.