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

Astrología mundana

Cuerpo de la solicitudJSON

Pega una clave de API arriba para enviarla.

Fragmento de código

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

La astrología mundana interpreta el año para un país, no para una persona. Su herramienta central es el gabinete del samvatsara: diez «cargos» del año, cada uno ocupado por un planeta. Ese planeta lo determina el día de la semana local (contado de salida a salida del sol en el lugar indicado) en que cae un evento solar concreto: el rey, por el año nuevo lunar; el ministro, por la entrada del Sol en Aries; el señor de las nubes, por su entrada en Ardra, y así hasta los señores de los granos, del tesoro y de los frutos. Un año con Saturno como rey se interpreta de forma muy distinta a uno con Júpiter. Pasa el año gregoriano en que empieza el samvat, junto con un lugar y la diferencia con UTC; el gabinete va desde el Chaitra Shukla Pratipada de ese año hasta el del año siguiente. das_adhikari devuelve todo el gabinete en un solo objeto y es la clave por la que conviene empezar; las claves individuales (king_of_year, mantri_of_year, meghesha_of_year y las demás) devuelven los mismos planetas de uno en uno. vaahan_of_samvat da el vehículo simbólico del año, que se deriva del rey. Además del gabinete, el endpoint devuelve el marco astronómico del año (equinoccios, solsticios, indian_ritus con las seis estaciones como intervalos de fechas reales, chaitra_shukla_pratipada y ardra_entry) y cuatro cartas levantadas para ingresos concretos: jagat_lagna_chart, en la entrada del Sol en Aries; ardra_pravesh_chart, para el monzón; y sharatsasya_chart y greeshmasasya_chart, para las cosechas de invierno y de verano. sapta_nadi_chakra y samvatsara_purusha_chakra son tablas de referencia estáticas que no cambian de un año a otro, y nakshatra_lord_effects busca un nakshatra en la primera de ellas. El campo nakshatra de esa clave usa una transliteración antigua y solo incluye veintiséis nombres: consulta la lista del campo en lugar de dar por hechas las grafías modernas.

Campos 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.
latitude	number (double)	obligatorio	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 -90 · max 90
longitude	number (double)	obligatorio	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
nakshatra	string	obligatorio	`KrittikaVisaakhaAnooraadhaBharaniRohiniSwaatiJyeshthaAshwiniMrigasiraChitraMoolaRevati` Solo lo usa la clave 'nakshatra_lord_effects'. Coincidencia EXACTA que distingue mayúsculas y minúsculas con la tabla del Sapta Nadi Chakra: son transliteraciones antiguas, no las grafías modernas; ten en cuenta 'Aardra' (no Ardra), 'Aasresha' (no Ashlesha), 'Makha' (no Magha), 'Sravanam' (no Shravana), 'Visaakha', 'Anooraadha', 'Mrigasira', 'Pushyami', 'Satabhishak', 'Poorvaabhaadra', 'Uttaraashaadha'. Solo aparecen 26 de los 28 nombres de nakshatra: 'Poorvaashaadha' y 'Uttaraabhaadra' no están en la tabla. Un nombre que no coincide NO da error: el método devuelve null.
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
year	integer	obligatorio	Año de nacimiento como número, p. ej., 1990. Cuatro dígitos.

Claves disponibles (24)

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
ardra_entry	—	El momento exacto en que el Sol alcanza 66°40', el inicio del nakshatra Ardra, el marcador tradicional para el cómputo del monzón. Una única marca de tiempo.
ardra_pravesh_chart	—	La misma estructura de carta, levantada para el momento en que el Sol entra en el nakshatra Ardra; es la carta que se interpreta para el monzón. Devuelve {entry_time, chart, house_planets}.
chaitra_shukla_pratipada	—	El año nuevo lunar hindú: la salida del sol local con la que empieza el día de Chaitra Shukla Pratipada del año solicitado. Chaitra empieza en la última luna nueva antes de que el Sol entre en el Aries sideral; el día es el primero cuya salida del sol cae en el primer tithi de su quincena clara o, si ese tithi no coincide con ninguna salida del sol, el día en que empieza. Una única marca de tiempo.
das_adhikari	—	Todo el gabinete del año en un solo objeto, con las claves 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 y Vehicle of Year. Los diez primeros valores son nombres de planetas y el último es el vehículo. Empieza por aquí en lugar de pedir las diez claves individuales.
dhaanyesha_of_year	—	Dhanyesha, señor de los granos: el planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Sagitario. Un único nombre de planeta en inglés.
dhanesha_of_year	—	Dhanesha, señor del tesoro: el planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Virgo. Un único nombre de planeta en inglés.
durgesha_of_year	—	Durgesha, señor de las fortalezas y la defensa: el planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Leo. Un único nombre de planeta en inglés.
equinoxes	—	Los dos instantes de equinoccio del año, obtenidos como los cruces del Sol por los 0 y 180 grados tropicales. Una lista de dos elementos: primero el vernal y después el otoñal.
greeshmasasya_chart	—	La carta de la cosecha de verano, levantada para la entrada del Sol en Piscis. Devuelve {entry_time, chart, house_planets}.
indian_ritus	—	Las seis estaciones indias como intervalos de fechas reales. Cada una es un arco de sesenta grados de longitud solar tropical, situado de modo que cada equinoccio y cada solsticio caiga en el centro o en el borde de una estación. Devuelve una lista de seis objetos ({ritu, name, subtitle, begins, ends, tropical_zodiac, note, image_url}) en este orden: Vasant, Grishma, Varsha, Sharad, Hemant, Shishir.
jagat_lagna_chart	—	La carta mundial, levantada para el momento exacto en que el Sol entra en Aries. Devuelve {ingress_time, chart, house_planets}: chart es una carta rashi completa en notación de signo y grado, con las secciones celestial, houses y ascendant, y house_planets asigna a cada casa los planetas que la ocupan.
king_of_year	—	El Raja del año: el planeta que rige el día de la semana local en que cae el Chaitra Shukla Pratipada. Un único nombre de planeta en inglés. En la práctica mundana, la naturaleza de este planeta marca el tono con que se interpreta todo el año.
mantri_of_year	—	El Mantri, o ministro del año: el planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Aries. Un único nombre de planeta en inglés.
meghesha_of_year	—	Meghesha, señor de las nubes: el planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Ardra. Un único nombre de planeta en inglés; se interpreta para las lluvias del año.
nakshatra_lord_effects	nakshatra	Busca en el Sapta Nadi Chakra el nakshatra que pasas y devuelve {lord, nadi, means, effect}: el planeta regente, el nombre del nadi, lo que significa ese nadi y el tiempo atmosférico que anuncia. Devuelve null si el nombre no está en la tabla, que usa transliteraciones antiguas, solo incluye veintiséis nombres y no tiene Poorvaashaadha ni Uttaraabhaadra.
neersesha_of_year	—	El planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Capricornio. Un único nombre de planeta en inglés. En la tradición clásica, este cargo es el señor de las aguas; esta API lo llama Lord of Metals en das_adhikari, y la descripción sigue al código, no al uso clásico.
phalesha_of_year	—	Phalesha, señor de los frutos: el planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Piscis al final del samvat, en marzo del año gregoriano siguiente. Un único nombre de planeta en inglés.
rasesha_of_year	—	Rasesha, señor de los jugos y los productos líquidos: el planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Libra. Un único nombre de planeta en inglés.
samvatsara_purusha_chakra	—	Las partes del cuerpo asociadas a la persona del año. Devuelve un objeto estático indexado por parte del cuerpo ('Entire body', 'Navel', 'Heart' y 'Vitality'), cada una con una lista de nakshatras, y una nota sobre su significado en la última. Es una tabla parcial que solo cubre seis nakshatras, no los veintisiete.
sapta_nadi_chakra	—	La tabla meteorológica completa de los siete nadis en la que busca nakshatra_lord_effects: un objeto indexado por los siete planetas, cada uno {nakshatras, nadi, means, effect}. Son datos de referencia estáticos, iguales en todas las solicitudes. Ten en cuenta que algunos nakshatras aparecen bajo más de un planeta, y la búsqueda devuelve la primera coincidencia.
sashyesha_of_year	—	Sasyesha, señor de las cosechas: el planeta que rige el día de la semana local (de salida a salida del sol) en que el Sol entra en Cáncer. Un único nombre de planeta en inglés; das_adhikari lo llama Lord of Summer Crops.
sharatsasya_chart	—	La carta de la cosecha de invierno, levantada para la entrada del Sol en Virgo. Devuelve {entry_time, chart, house_planets}, la misma estructura que las demás cartas mundanas.
solstices	—	Los dos instantes de solsticio del año. Una lista de dos elementos; ojo, el orden no es cronológico: primero va el de invierno (Sol a 270 grados, en diciembre del año solicitado) y después el de verano (Sol a 90 grados, en junio).
vaahan_of_samvat	—	El vehículo simbólico del año, obtenido a partir del rey del año: Horse para el Sol, Elephant para la Luna, Ox/boat para Marte, Swing para Mercurio, Boat para Júpiter, Elephant/Frog para Venus, Horse/Buffalo para Saturno. Una única cadena.

Referencia completa de este endpoint