POST/api/astro/house_hora/1 crédit

Relations entre maisons

La structure relationnelle d’un thème natal : quels signes en aspectent d’autres, quelles planètes en aspectent d’autres, qui est l’ami de qui, et quelles planètes les textes classiques retiennent comme déterminantes pour les tournants d’un thème. C’est une grande partie des outils du jugement jaimini et parashari, proposés un par un. Les clés se répartissent en trois groupes. Les clés de classes de maisons (`trikonas`, `kendras`, `quadrants`, `dushthanas`, `chathusras`, `upachayas`) relèvent de la pure géométrie : douze lignes, une par signe, avec des numéros de signes de 1 à 12, indépendamment du thème. Les clés d’aspects et de relations (`raasi_drishti_of_the_planet`, les trois clés `aspected_*_of_the_planet`, les deux clés `*_of_the_raasi`, `argala`, `associations_of_the_planet`, les trois clés d’amitiés naturelles et `baadhakas_of_raasi`) décrivent les rapports entre les corps du thème. Les clés jaimini (`chara_karakas`, `marakas`, `brahma`, `rudra`, `maheshwara`, `trishoola_rasis`, `order_of_planets_by_strength`) désignent les planètes qui comptent pour la longévité et pour dater les événements majeurs. Les planètes sont toujours renvoyées sous forme d’indices : 0 Soleil, 1 Lune, 2 Mars, 3 Mercure, 4 Jupiter, 5 Vénus, 6 Saturne, 7 Rahu, 8 Ketu. Les signes sont indexés à partir de 0 (de 0 Bélier à 11 Poissons) dans les clés d’aspects et jaimini, mais à partir de 1 (1 à 12) dans les clés de classes de maisons : vérifiez donc ce que vous lisez. Le champ `planet` de la requête prend une majuscule initiale et est sensible à la casse — 'Sun', et non 'sun' —, et `raasi` est un entier indexé à partir de 0, sans contrôle de bornes : une valeur hors de 0–11 fait échouer la requête.

https://api.occultapi.com/api/astro/house_hora/

Tester la requête

Authentification

Envoyez votre clé dans l’en-tête X-API-Key. Une clé est un identifiant côté serveur : ne la placez jamais dans du JavaScript exécuté par le navigateur ni dans une application mobile.

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

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. Contrainte de FORMAT. DateTimeField DRF : ISO-8601 uniquement (formats d’entrée par défaut de DRF), p. ex. "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" ou "2026-09-01 06:00:00" (sans fuseau = UTC supposé).
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. `trikonasdushthanaschathusrasquadrantskendrasupachayaschara_karakasraasi_drishti_of_the_planetaspected_planets_of_the_planetaspected_rasis_of_the_planetaspected_houses_of_the_planetaspected_houses_of_the_raasi` Tableau de chaînes. Les clés qui se terminent par '_of_the_planet', ainsi que 'associations_of_the_planet', nécessitent `planet` ; celles qui se terminent par '_of_the_raasi', ainsi que 'baadhakas_of_raasi', nécessitent `raasi`.
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
node	string	obligatoire	`truemean` Sensible à la casse, en minuscules. 'true' utilise les nœuds lunaires vrais, 'mean' les nœuds moyens. Toute autre valeur produit une KeyError -> 400. Transmis à.
planet	string	obligatoire	`SunMoonMarsMercuryJupiterVenusSaturnRahuKetu` SENSIBLE à la casse, avec une majuscule initiale - contrairement aux noms de corps en minuscules qu’utilise /api/astro/chart_analysis/.
raasi	integer	obligatoire	`01234567891011` Entier, pas une chaîne. Sert d’indice de signe À PARTIR DE 0 : 0 = Bélier... 11 = Poissons. Les bornes ne sont pas contrôlées : une valeur hors plage lève une IndexError -> 400, et une valeur négative repart, sans erreur, depuis la fin de la liste.
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

Clés disponibles (29)

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
argala	—	Argala et virodhargala pour tout le thème, sous forme de liste de deux éléments. Le premier est l’argala, l’intervention exercée sur une maison : douze lignes, une par maison à partir de l’ascendant, chacune avec quatre chaînes pour la 2e, la 4e, la 5e et la 11e à partir de cette maison ; les indices des planètes présentes y sont joints par '/', et la chaîne est vide quand la maison est inoccupée. Le second est la virodhargala, l’obstacle à cette intervention, de même structure pour la 12e, la 10e, la 9e et la 3e — dans cet ordre, pour que les colonnes correspondent à celles de l’argala.
aspected_houses_of_the_planet	planet	Les mêmes aspects graha drishti que `aspected_rasis_of_the_planet`, mais exprimés en numéros de maisons comptés depuis l’ascendant, de 1 à 12, et non en indices de signes. Nécessite `planet`.
aspected_houses_of_the_raasi	raasi	Les maisons, de 1 à 12 à partir de l’ascendant, qu’aspecte le signe donné selon la rasi drishti — toutes, qu’une planète les occupe ou non. Nécessite `raasi`, sous forme d’indice de signe à partir de 0.
aspected_planets_of_the_planet	planet	Les planètes qu’aspecte la planète donnée selon la graha drishti — l’aspect planétaire parashari : toute planète aspecte la 7e, et Mars, Jupiter et Saturne ont en plus leurs aspects spéciaux. Renvoie une liste d’indices de planètes. Nécessite `planet`.
aspected_raasis_of_the_raasi	raasi	La même relation de rasi drishti que `aspected_houses_of_the_raasi`, mais renvoyée en indices de signes à partir de 0 et non en numéros de maisons : elle ne dépend donc pas du tout de l’ascendant. Nécessite `raasi`.
aspected_rasis_of_the_planet	planet	Les signes qu’aspecte la planète donnée selon la graha drishti, sous forme de liste d’indices de signes à partir de 0, de 0 pour le Bélier à 11 pour les Poissons. C’est la version par signe de `aspected_houses_of_the_planet`. Nécessite `planet`.
associations_of_the_planet	planet	Toutes les planètes avec lesquelles la planète donnée a un lien significatif, par l’une des trois voies classiques : même signe, aspect selon la graha drishti, ou parivartana (échange de signes). Renvoie une liste d’indices de planètes, sans doublons. Nécessite `planet`.
baadhakas_of_raasi	raasi	La maison baadhaka, ou d’obstruction, pour un signe ascendant donné, et les planètes qui la régissent — la 11e pour les signes mobiles, la 9e pour les fixes et la 7e pour les doubles. Renvoie une liste de deux éléments : [signe baadhaka indexé à partir de 0, liste des indices des planètes qui en sont maîtresses]. Nécessite `raasi`.
brahma	—	Brahma, la planète que Jaimini associe au maintien de la vie. On retient la plus forte des planètes maîtresses des maisons 6, 8 et 12, comptées depuis le plus fort des deux entre l’ascendant et la septième maison ; Rahu et Ketu sont exclus, et les égalités sont départagées par la dignité, le placement en signe impair et la position dans la moitié. Renvoie un seul indice de planète.
chara_karakas	—	Les huit chara karakas, sous forme de liste de huit indices de planètes classés par degré décroissant dans leur signe. La première entrée est l’Atmakaraka, et les autres suivent dans l’ordre standard (Amatya, Bhratri, Matri, Pitri, Putra, Gnati, Dara). Ketu est exclu, et Rahu est classé d’après sa longitude inversée, comme le veut la règle classique.
chathusras	—	Douze lignes de deux numéros de signes 1–12. Dans l’implémentation actuelle, chaque ligne donne le 3e et le 5e signe à partir du signe — la ligne 1 est [3, 5] —, et non le 4e et le 8e de la paire chatusra classique.
dushthanas	—	Douze lignes de trois numéros de signes 1–12. Dans l’implémentation actuelle, chaque ligne donne le signe lui-même, le 3e et le 7e à partir de lui — la ligne 1 est [1, 3, 7] —, ce qui ne correspond pas à l’ensemble classique des dusthanas (6e, 8e, 12e) : prenez donc la sortie pour ce que calcule le code, et non pour des dusthanas au sens des manuels.
kendras	—	Les quadrants de chaque signe : douze lignes, une par signe, chacune étant une liste de quatre numéros de signes de 1 à 12. La ligne 0 correspond au Bélier. Ne prend aucun argument. La structure diffère de celle de la clé `kendras` de /api/astro/strength/, qui prend un `asc_house` et renvoie une seule liste plate de quatre indices À PARTIR DE ZÉRO - mélanger les deux conventions est la source classique d’erreurs de décalage d’une unité.
maheshwara	—	La même valeur que `maheshwara_from_planet_positions` — cette clé se contente de l’appeler et renvoie le même indice de planète. Demandez l’une ou l’autre.
maheshwara_from_planet_positions	—	Maheshwara, la planète que Jaimini associe à la manière de mourir : le maître du huitième signe à partir de l’Atmakaraka, avec les substitutions classiques lorsque ce maître est dans son propre signe, ou conjoint ou opposé à un nœud. Renvoie un seul indice de planète ; si le résultat devait être Rahu ou Ketu, il est remplacé respectivement par Mercure ou Jupiter.
marakas	—	Les mêmes planètes maraka que `marakas_from_planet_positions`, mais calculées à partir de la représentation du thème par maison (maison → planètes). Le résultat est la même liste d’indices de planètes : demandez l’une ou l’autre, pas les deux.
marakas_from_planet_positions	—	Les planètes maraka, ou « meurtrières » : les maîtres des maisons 2 et 7, ainsi que toute planète placée dans l’une de ces maisons ou avec l’un de ces maîtres. Renvoie une liste d’indices de planètes, sans ordre particulier. Calculées à partir de la représentation du thème par positions des planètes.
natural_enemies_of_planets	—	La table standard des inimitiés, sous forme de liste de neuf listes indexées par planète (0–8), chacune donnant les planètes qui lui sont hostiles. Fixe et indépendante du thème ; c’est le pendant de `natural_neutral_of_planets`.
natural_friends_of_planets	—	L’amitié planétaire permanente, déduite des maîtrises de signes propres à ce thème : un objet dont les clés sont les indices de planète 0–8, chacune donnant la liste des indices des planètes qui lui sont amies. Pour les sept planètes classiques, le maître du signe d’exaltation s’ajoute aux maîtres des signes amis.
natural_neutral_of_planets	—	La table standard des neutralités, sous forme de liste de neuf listes indexées par planète (0–8), chacune donnant les planètes neutres à son égard. Contrairement à `natural_friends_of_planets`, c’est la table classique fixe, qui ne dépend en rien du thème.
order_of_planets_by_strength	—	Les neuf planètes classées de la plus forte à la plus faible, sous forme de liste de neuf indices de planètes. L’ordre vient de la comparaison de force deux à deux du moteur, celle-là même qui sert à départager les maîtres candidats dans les calculs de Rudra et de Maheshwara.
planets_aspecting_the_planet	planet	Censée renvoyer les planètes qui projettent une graha drishti sur la planète donnée, sous forme de liste d’indices de planètes. En l’état, elle compare le nom de la planète (avec majuscule) à des listes d’indices, et renvoie donc une liste vide quelle que soit l’entrée. Utilisez plutôt `aspected_planets_of_the_planet` pour chaque planète tour à tour, puis inversez le résultat.
quadrants	—	Les angles de chaque signe : douze lignes de quatre numéros de signes 1–12, donnant le signe lui-même et le 4e, le 7e et le 10e à partir de lui. La ligne 1 est [1, 4, 7, 10]. Alias de `kendras` sur cet endpoint — les deux sont forcément identiques : les demander toutes les deux ne fait qu’occuper inutilement une place dans la réponse.
raasi_drishti_of_the_planet	planet	Les planètes placées dans les signes qu’aspecte, selon la rasi drishti, le signe où se trouve la planète donnée — l’aspect de signe à signe de Jaimini : les signes mobiles aspectent les fixes et inversement, et les signes doubles s’aspectent entre eux. Renvoie une liste d’indices de planètes. Nécessite `planet`.
rudra	—	Rudra, défini ici comme le plus fort entre le maître de la huitième maison à partir de l’ascendant et le maître de la huitième maison à partir de la septième. Renvoie [indice de planète, signe qu’elle occupe indexé à partir de 0, les trois signes en trigone de ce signe indexés à partir de 0]. Notez la différence avec `rudra_based_on_planet_positions`, qui détermine autrement le second des deux maîtres et peut donc renvoyer une autre planète.
rudra_based_on_planet_positions	—	Rudra, la planète que Jaimini associe au tournant destructeur d’un thème — ici, le plus fort entre le maître du huitième signe à partir de l’ascendant et le maître de la septième maison. Renvoie une liste de trois éléments : [indice de planète, signe qu’elle occupe indexé à partir de 0, les trois signes en trigone de ce signe indexés à partir de 0]. Le calcul diffère de celui de `rudra`, et les deux peuvent désigner des planètes différentes.
trikonas	—	Les trigones de chaque signe : douze lignes de trois numéros de signes 1–12, donnant le signe lui-même et le 5e et le 9e à partir de lui. La ligne 1 est [1, 5, 9]. Pure géométrie — identique pour tous les thèmes.
trishoola_rasis	—	Les rasis Trishula, le trident de trois signes qui sert à dater la période la plus éprouvante d’un thème : les trigones du signe qu’occupe le Rudra. Renvoie trois indices de signes à partir de 0.
upachayas	—	Douze lignes de quatre numéros de signes 1–12. Dans l’implémentation actuelle, chaque ligne donne le signe lui-même et le 4e, le 8e et le 9e à partir de lui — la ligne 1 est [1, 4, 8, 9] —, et non le 3e, le 6e, le 10e et le 11e qui forment classiquement l’ensemble upachaya.

Exemple de requête

curl -X POST https://api.occultapi.com/api/astro/house_hora/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["trikonas"],"raasi":2,"planet":"Mars","node":"mean","date_time":"2025-02-12T09:35:49.036Z","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

Réponse

{
  "data": {
    "trikonas": [
      [
        1,
        5,
        9
      ],
      [
        2,
        6,
        10
      ],
      [
        3,
        7,
        11
      ],
      [
        4,
        8,
        12
      ],
      [
        5,
        9,
        1
      ],
      [
        6,
        10,
        2
      ],
      [
        7,
        11,
        3
      ],
      [
        8,
        12,
        4
      ],
      [
        9,
        1,
        5
      ],
      [
        10,
        2,
        6
      ],
      [
        11,
        3,
        7
      ],
      [
        12,
        4,
        8
      ]
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

Réponse capturée lors d’un vrai appel, avec exactement la requête ci-dessus. Les résultats se trouvent dans data, sous le nom de chaque clé demandée.

Erreurs

Les erreurs du contrôle de clé et de crédits renvoient { "error": "…", "message": "<code>", "is_error": true }. Affichez error à vos utilisateurs et basez votre logique sur message. Voir la référence des erreurs.