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

Astrologie mondiale

Corps de la requêteJSON

Collez une clé API ci-dessus pour envoyer.

Extrait de code

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

L’astrologie mondiale lit l’année d’un pays plutôt que celle d’une personne. Son outil central est le cabinet du samvatsara : dix « dignitaires » de l’année, chacun une planète, désignée par le jour de la semaine local (compté d’un lever du soleil au suivant, au lieu indiqué) où tombe un événement solaire précis — le roi d’après le nouvel an lunaire, le ministre d’après l’entrée du Soleil en Bélier, le maître des nuages d’après son entrée dans Ardra, et ainsi de suite jusqu’aux maîtres des grains, du trésor et des fruits. Une année dont Saturne est le roi se lit tout autrement qu’une année gouvernée par Jupiter. Passez l’année grégorienne où commence le samvat, ainsi qu’un lieu et le décalage UTC ; le cabinet court du Chaitra Shukla Pratipada de cette année jusqu’au suivant. das_adhikari renvoie tout le cabinet dans un seul objet : c’est la clé par laquelle commencer. Les clés individuelles — king_of_year, mantri_of_year, meghesha_of_year, etc. — renvoient les mêmes planètes une par une. vaahan_of_samvat donne le véhicule symbolique de l’année, déduit du roi. En plus du cabinet, l’endpoint renvoie le cadre astronomique de l’année — équinoxes, solstices, indian_ritus pour les six saisons sous forme de véritables plages de dates, chaitra_shukla_pratipada et ardra_entry — ainsi que quatre thèmes dressés pour des ingrès précis : jagat_lagna_chart à l’entrée du Soleil en Bélier, ardra_pravesh_chart pour la mousson, sharatsasya_chart et greeshmasasya_chart pour les récoltes d’hiver et d’été. sapta_nadi_chakra et samvatsara_purusha_chakra sont des tables de référence statiques qui ne varient pas d’une année à l’autre, et nakshatra_lord_effects cherche un seul nakshatra dans la première. Le champ nakshatra de cette clé utilise une translittération ancienne et ne couvre que vingt-six noms — consultez la liste du champ au lieu de supposer les orthographes modernes.

Champs de la requête

Champ	Type	Obligatoire	Remarques
date_time	string (date-time)	obligatoire	Le moment du calcul, en ISO 8601. Incluez TOUJOURS un décalage ou un Z final - une valeur sans fuseau est lue comme Asia/Kolkata (UTC+05:30), et non comme UTC, et peut renvoyer le résultat de la veille avec un statut 200. '2026-09-01T06:00:00Z' et '2026-09-01 06:00:00' sont des instants différents et donnent des réponses différentes.
keys	array	obligatoire	Les calculs à renvoyer, sous forme de liste de noms. Consultez le tableau des clés de cet endpoint ; un nom non reconnu fait rejeter toute la requête. Un appel coûte un crédit quel que soit le nombre de clés demandées : demandez donc tout ce dont vous avez besoin en une seule fois plutôt que de faire plusieurs appels.
latitude	number (double)	obligatoire	Latitude du lieu, en degrés décimaux. Positive au nord, négative au sud. Exemple : 26.9124 pour Jaipur, 40.7128 pour New York. Les minutes et les secondes ne sont pas acceptées - convertissez d’abord. min -90 · max 90
longitude	number (double)	obligatoire	Longitude du lieu, en degrés décimaux. Positive à l’est, négative à l’ouest. Exemple : 75.7873 pour Jaipur, -74.0060 pour New York. Attention au signe : sans le moins, New York se retrouve en Chine. min -180 · max 180
nakshatra	string	obligatoire	`KrittikaVisaakhaAnooraadhaBharaniRohiniSwaatiJyeshthaAshwiniMrigasiraChitraMoolaRevati` Utilisé uniquement par la clé 'nakshatra_lord_effects'. Correspondance EXACTE, sensible à la casse, avec la table du Sapta Nadi Chakra - ce sont des translittérations anciennes, pas les orthographes modernes ; notez 'Aardra' (et non Ardra), 'Aasresha' (et non Ashlesha), 'Makha' (et non Magha), 'Sravanam' (et non Shravana), 'Visaakha', 'Anooraadha', 'Mrigasira', 'Pushyami', 'Satabhishak', 'Poorvaabhaadra', 'Uttaraashaadha'. Seuls 26 des 28 noms de nakshatras figurent - 'Poorvaashaadha' et 'Uttaraabhaadra' sont absents de la table. Un nom sans correspondance ne provoque PAS d’erreur : la méthode renvoie null.
timezone_as_float	number (double)	obligatoire	Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30), -5 pour New York en hiver, 5.75 pour le Népal. Cette valeur n’est PAS contrôlée par rapport à date_time - si les deux divergent, vous obtenez une réponse réussie pour le mauvais moment ; tirez donc les deux de la même source. Utilisez le décalage en vigueur à cette date, pas celui d’aujourd’hui : une naissance en été dans un pays qui applique l’heure d’été exige le décalage d’été. min -12 · max 14
year	integer	obligatoire	Année de naissance sous forme de nombre, p. ex. 1990. Quatre chiffres.

Clés disponibles (24)

Listez dans keys exactement les calculs voulus. Une clé inconnue fait rejeter toute la requête. Vous payez 1 crédit, quel que soit le nombre de clés demandées : regroupez-les donc.

Clé	Champs supplémentaires requis	Description
ardra_entry	—	Le moment exact où le Soleil atteint 66°40', début du nakshatra Ardra — le repère traditionnel du calcul de la mousson. Un seul horodatage.
ardra_pravesh_chart	—	La même structure de thème, dressée pour le moment où le Soleil entre dans le nakshatra Ardra, thème consulté pour la mousson. Renvoie {entry_time, chart, house_planets}.
chaitra_shukla_pratipada	—	Le nouvel an lunaire hindou : le lever du soleil local qui ouvre le jour de Chaitra Shukla Pratipada de l’année demandée. Chaitra commence à la dernière nouvelle lune avant l’entrée du Soleil dans le Bélier sidéral ; ce jour est le premier dont le lever du soleil tombe dans la première tithi de la quinzaine claire ou, si cette tithi ne recouvre aucun lever du soleil, le jour où elle commence. Un seul horodatage.
das_adhikari	—	Tout le cabinet de l’année dans un seul objet, avec les clés 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 et Vehicle of Year. Les dix premières valeurs sont des noms de planètes et la dernière est le véhicule. Commencez ici plutôt que de demander les dix clés individuelles.
dhaanyesha_of_year	—	Dhanyesha, maître des grains : la planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil en Sagittaire. Un seul nom de planète en anglais.
dhanesha_of_year	—	Dhanesha, maître du trésor : la planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil en Vierge. Un seul nom de planète en anglais.
durgesha_of_year	—	Durgesha, maître des forts et de la défense : la planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil en Lion. Un seul nom de planète en anglais.
equinoxes	—	Les deux instants d’équinoxe de l’année, déterminés par le passage du Soleil à 0 et 180 degrés de longitude tropicale. Une liste de deux éléments : l’équinoxe de printemps d’abord, puis celui d’automne.
greeshmasasya_chart	—	Le thème des récoltes d’été, dressé pour l’entrée du Soleil en Poissons. Renvoie {entry_time, chart, house_planets}.
indian_ritus	—	Les six saisons indiennes sous forme de véritables plages de dates, chacune couvrant un arc de soixante degrés de longitude solaire tropicale, calé de sorte que chaque équinoxe et chaque solstice tombe au milieu ou en bordure d’une saison. Renvoie une liste de six objets — {ritu, name, subtitle, begins, ends, tropical_zodiac, note, image_url} — dans l’ordre Vasant, Grishma, Varsha, Sharad, Hemant, Shishir.
jagat_lagna_chart	—	Le thème du monde, dressé pour le moment exact de l’entrée du Soleil en Bélier. Renvoie {ingress_time, chart, house_planets} : chart est un thème rashi complet en notation signe et degré, avec les sections celestial, houses et ascendant, et house_planets associe à chaque maison les planètes qui l’occupent.
king_of_year	—	Le Raja de l’année — la planète qui régit le jour de la semaine local où tombe Chaitra Shukla Pratipada. Un seul nom de planète en anglais. En astrologie mondiale, la nature de cette planète donne le ton de toute l’année.
mantri_of_year	—	Le Mantri, ou ministre de l’année : la planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil en Bélier. Un seul nom de planète en anglais.
meghesha_of_year	—	Meghesha, maître des nuages : la planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil dans Ardra. Un seul nom de planète en anglais, consulté pour les pluies de l’année.
nakshatra_lord_effects	nakshatra	Cherche dans le Sapta Nadi Chakra le nakshatra que vous passez et renvoie {lord, nadi, means, effect} : la planète maîtresse, le nom de la nadi, sa signification et la météo qu’on y lit. Renvoie null pour tout nom absent de la table, qui utilise des translittérations anciennes, couvre vingt-six noms et omet Poorvaashaadha et Uttaraabhaadra.
neersesha_of_year	—	La planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil en Capricorne. Un seul nom de planète en anglais. Classiquement, cette charge revient au maître des eaux ; cette API l’appelle Lord of Metals dans das_adhikari, et la description suit le code plutôt que l’usage classique.
phalesha_of_year	—	Phalesha, maître des fruits : la planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil en Poissons à la fin du samvat, en mars de l’année grégorienne suivante. Un seul nom de planète en anglais.
rasesha_of_year	—	Rasesha, maître des sucs et des produits liquides : la planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil en Balance. Un seul nom de planète en anglais.
samvatsara_purusha_chakra	—	Les correspondances entre l’être-année et les parties du corps. Renvoie un objet statique indexé par partie du corps — 'Entire body', 'Navel', 'Heart' et 'Vitality' —, chacune avec une liste de nakshatras, la dernière portant en plus une note sur sa signification. C’est une table partielle qui couvre six nakshatras, et non les vingt-sept.
sapta_nadi_chakra	—	La table météorologique complète des sept nadis que consulte nakshatra_lord_effects : un objet indexé par les sept planètes, chacune de la forme {nakshatras, nadi, means, effect}. Données de référence statiques, identiques d’une requête à l’autre. Notez que quelques nakshatras figurent sous plusieurs planètes et qu’une recherche renvoie la première correspondance.
sashyesha_of_year	—	Sasyesha, maître des récoltes : la planète qui régit le jour de la semaine local (d’un lever du soleil au suivant) de l’entrée du Soleil en Cancer. Un seul nom de planète en anglais ; das_adhikari l’indique comme Lord of Summer Crops.
sharatsasya_chart	—	Le thème des récoltes d’hiver, dressé pour l’entrée du Soleil en Vierge. Renvoie {entry_time, chart, house_planets}, la même structure que les autres thèmes mondiaux.
solstices	—	Les deux instants de solstice de l’année. Une liste de deux éléments — attention, l’ordre n’est pas chronologique : l’hiver d’abord (Soleil à 270 degrés, en décembre de l’année demandée), puis l’été (Soleil à 90 degrés, en juin).
vaahan_of_samvat	—	Le véhicule symbolique de l’année, déterminé d’après le roi de l’année — Horse pour le Soleil, Elephant pour la Lune, Ox/boat pour Mars, Swing pour Mercure, Boat pour Jupiter, Elephant/Frog pour Vénus, Horse/Buffalo pour Saturne. Une seule chaîne.

Référence complète de cet endpoint