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

Shadbala et force planétaire

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/strength/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["harsha_bala"],"date_time":"2025-03-27T11:11:24.366Z","latitude":26.9124,"longitude":75.7873,"timezone":5.5,"asc_house":2}'

Le shadbala, « six forces », est la méthode classique pour chiffrer ce qu’une planète peut réellement apporter. Six sources sont notées séparément — position, temps, direction, mouvement, rang naturel et aspects reçus — puis additionnées. Le total s’exprime en virupas, soixante virupas faisant un rupa ; chaque planète a un seuil en rupas qu’elle est censée atteindre, et le rapport entre son score et ce seuil est la valeur à exploiter. Cet endpoint donne ce total, toutes ses composantes et sous-composantes, ainsi que plusieurs systèmes de force apparentés. Commencez par `shad_bala`. Il renvoie un tableau de neuf éléments : les six listes de composantes, puis les totaux en virupas, les mêmes totaux en rupas et enfin les rupas de chaque planète divisés par son seuil (Soleil 5, Lune 6, Mars 5, Mercure 7, Jupiter 6.5, Vénus 5.5, Saturne 5). Un rapport supérieur à 1 signifie que la planète atteint son seuil. Sur cet endpoint, toute liste de sept éléments suit l’ordre Soleil, Lune, Mars, Mercure, Jupiter, Vénus, Saturne, et toute liste de douze éléments couvre les maisons de la première à la douzième. Envoyez `date_time`, `latitude`, `longitude` et `timezone`. Attention : le champ s’appelle ici `timezone`, et non `timezone_as_float` comme sur la plupart des autres endpoints. `asc_house` est obligatoire, mais seules les trois clés de classification des maisons l’utilisent ; `planet_index`, `include_houses` et `use_epoch_table` ne servent qu’aux clés qui les mentionnent. En plus du shadbala, l’endpoint fournit les forces tajaka quintuple et duodécuple, le score bénéfique Ishta Phala, les mesures de rayons Rashmi et le Harsha Bala. Le Bhava Bala, la force des maisons et non des planètes, figure dans la liste des clés, mais ses trois composantes sont des ébauches non implémentées qui renvoient des zéros : `bhava_bala` renvoie donc lui aussi des zéros.

Champs de la requête

Champ	Type	Obligatoire	Remarques
asc_house	integer	obligatoire
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
timezone	number (double)	obligatoire	Décalage UTC du lieu, en heures, sous forme décimale. Exemple : 5.5 pour l’Inde (UTC+05:30). Même signification que timezone_as_float, que d’autres endpoints désignent sous un autre nom. min -12 · max 14
include_houses	boolean	facultatif
planet_index	integer	facultatif
use_epoch_table	boolean	facultatif

Clés disponibles (50)

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
abda_bala	—	Force du maître de l’année : la planète qui régit l’année reçoit 15 virupas, les autres zéro. Renvoie sept valeurs, du Soleil à Saturne, dont une seule vaut 15. Notez que cette implémentation choisit le maître d’après le jour de la semaine de `date_time` ; `abdadhipathi` calcule le maître de l’année de manière classique, à partir des jours écoulés : c’est la clé à privilégier.
abdadhipathi	—	Le maître de l’année, déterminé de manière classique à partir de l’ahargana — le nombre de jours écoulés depuis une époque de référence — et non à partir du jour de la semaine. La planète maîtresse reçoit 15 virupas, les autres zéro. Renvoie sept valeurs, du Soleil à Saturne, dont une seule vaut 15. Préférez cette clé à `abda_bala`.
apoklimas	asc_house	Les quatre maisons cadentes — la 3e, la 6e, la 9e et la 12e — comptées à partir de la maison de l’ascendant que vous passez dans `asc_house`. Renvoie quatre entiers, `(asc_house + n - 1) mod 12` pour n valant 3, 6, 9 et 12, indexés à partir de 0 comme pour `panapharas`. On tient les planètes placées dans ces maisons pour les plus faibles du point de vue de la position, d’où le fait que le Kendra Bala leur accorde le moins de points.
ayana_bala	—	Force de déclinaison, d’après la distance de chaque planète au nord ou au sud de l’équateur céleste : déclinaison plus 24, multipliée par 1.25, le résultat du Soleil étant doublé. Renvoie sept nombres en virupas, du Soleil à Saturne.
bhava_adhipathi_bala	—	La composante « maître de maison » du Bhava Bala : ce qu’une maison tire de la force de son propre maître. Renvoie douze nombres, de la première à la douzième maison. Pour l’instant, c’est une ébauche non implémentée qui renvoie des zéros.
bhava_bala	—	Le Bhava Bala, la force des maisons et non des planètes, formé du Bhava Adhipathi, du Bhava Dig et du Bhava Drik Bala. Renvoie un tableau de trois éléments — douze valeurs en virupas, les mêmes en rupas, et chacune divisée par le minimum de 5 rupas — de la première à la douzième maison. Dans le moteur actuel, ses trois composantes sont des ébauches non implémentées : toutes les valeurs sont donc nulles pour l’instant.
bhava_dig_bala	—	La composante directionnelle du Bhava Bala : la force qu’une maison tire de l’accord entre le type d’affaires qu’elle régit et la direction qu’elle occupe. Renvoie douze nombres, de la première à la douzième maison. Pour l’instant, c’est une ébauche non implémentée qui renvoie des zéros.
bhava_drik_bala	—	La composante d’aspect du Bhava Bala : le solde des aspects bénéfiques et maléfiques que reçoit chaque maison. Renvoie douze nombres, de la première à la douzième maison. Pour l’instant, c’est une ébauche non implémentée qui renvoie des zéros.
bhava_madhya	—	Les douze bhava madhyas, les milieux des maisons, calculés à partir des cuspides Placidus en longitude sidérale. Renvoie douze nombres en degrés de 0 à 360, en commençant par la première maison. Utilisés en interne par le Dig Bala, et utiles en eux-mêmes si vous voulez les milieux des maisons plutôt que les cuspides.
cheshta_bala	—	Force de mouvement, la quatrième des six composantes : la différence entre le seeghrocha d’une planète et la moyenne de ses longitudes vraie et moyenne, divisée par trois — élevée lorsqu’une planète est lente, stationnaire ou rétrograde, et faible lorsqu’elle file vers l’avant. Renvoie sept nombres en virupas ; le Soleil et la Lune valent toujours 0, car ils ne sont jamais rétrogrades.
cheshta_bala_new	use_epoch_table	Une seconde implémentation de la force de mouvement, qui calcule les longitudes moyennes à partir de l’époque Ujjain 1900 plutôt qu’à partir des éphémérides. Passez `use_epoch_table` à true pour lire les tables classiques de mouvement moyen, à false pour utiliser un taux linéaire à partir de la même époque. Renvoie sept nombres en virupas, le Soleil et la Lune valant toujours 0. Utilisez-la pour comparer avec `cheshta_bala` ; les deux ne concordent pas exactement, et c’est voulu.
cheshta_rashmi	—	Le Cheshta Rashmi, les rayons qu’une planète émet du fait de son mouvement, dérivé du Cheshta Bala et ramené dans une plage 0–180 avant d’être converti en rayons. Renvoie sept nombres, du Soleil à Saturne. Marqué comme expérimental dans le code source : ne vous y fiez pas.
dig_bala	—	Force directionnelle, la troisième des six composantes : l’éloignement de chaque planète par rapport au milieu de maison où elle est réputée impuissante — la quatrième pour le Soleil et Mars, la dixième pour la Lune et Vénus, la septième pour Mercure et Jupiter, la première pour Saturne — l’écart étant divisé par trois. Renvoie sept nombres en virupas, du Soleil à Saturne, arrondis à deux décimales.
drekkana_bala	—	Force du drekkana pour l’ensemble quintuple : 10 virupas pour une planète dans son propre signe dans le thème D3, 5 dans le signe d’un ami et 2.5 dans celui d’un ennemi. Renvoie sept nombres, du Soleil à Saturne. `drekkana_bala_simple` applique la même règle avec la position D3 dérivée directement de la longitude.
drekkana_bala_simple	—	Force du drekkana avec la position D3 calculée directement à partir de la longitude (longitude multipliée par trois) plutôt qu’à partir d’un thème D3 construit : 10 virupas dans son propre signe, 5 dans celui d’un ami, 2.5 dans celui d’un ennemi. Renvoie sept nombres, du Soleil à Saturne. C’est la variante qu’utilise `pancha_vargeeya_bala`.
dreshkon_bala	—	Force du drekkana : 15 virupas pour une planète masculine (Soleil, Mars, Jupiter) dans le premier tiers de son signe, pour Mercure ou Saturne dans le tiers central, et pour la Lune ou Vénus dans le dernier tiers ; 0 sinon. Renvoie sept valeurs, 0 ou 15, du Soleil à Saturne.
drik_bala	—	Force d’aspect : les aspects de chaque planète sur chacune des autres sont notés selon l’angle qui les sépare, les aspects bénéfiques sont ajoutés et les maléfiques soustraits, et le solde est divisé par quatre. Renvoie sept nombres en virupas, du Soleil à Saturne, qui peuvent être négatifs — une planète fortement aspectée par des maléfiques perd ici de la force.
dwadhasa_vargeeya_bala	—	La force duodécuple : chaque planète est placée dans les douze thèmes divisionnaires D1 à D12 et marque un point pour chaque thème où elle tombe dans un signe ami ou mieux. Renvoie un objet avec les clés `"0"` à `"6"` pour les planètes du Soleil à Saturne, chacune un entier de 0 à 12 — un simple décompte du nombre de divisions favorables à la planète.
get_planet_mean_longitude	planet_index	La longitude moyenne d’une planète au moment donné, calculée à partir de sa position moyenne et de son taux journalier à l’époque Ujjain 1900, plus une correction annuelle. Passez `planet_index` de 0 à 6, du Soleil à Saturne. Renvoie un seul nombre de degrés de 0 à 360 — sauf pour la Lune, indice 1, qui n’est pas implémentée et renvoie 0.0. La longitude moyenne sert au calcul du Cheshta Bala ; ce n’est pas la position vraie de la planète.
get_planet_mean_longitude_using_epoch_table	planet_index	La même longitude moyenne que `get_planet_mean_longitude`, mais lue chiffre par chiffre dans les tables classiques de mouvement moyen d’Ujjain 1900 au lieu d’être tirée d’un taux linéaire. Passez `planet_index` de 0 à 6, du Soleil à Saturne. Renvoie un seul nombre de degrés de 0 à 360, là encore 0.0 pour la Lune. Les résultats diffèrent légèrement de ceux de la méthode linéaire ; `cheshta_bala_new` permet de passer de l’une à l’autre.
hadda_bala	—	Force du hadda, d’après les termes égyptiens : chaque signe est découpé en cinq segments inégaux ayant chacun un maître planétaire, et une planète marque 15 virupas dans son propre hadda, 7.5 dans celui d’un ami et 3.75 dans celui d’un ennemi. Renvoie sept nombres, du Soleil à Saturne.
hadda_bala_simple	—	Force du hadda calculée directement à partir de la longitude de chaque planète et des tables des termes — 15 virupas dans son propre hadda, 7.5 dans celui d’un ami, 3.75 dans celui d’un ennemi. Renvoie sept nombres, du Soleil à Saturne. C’est la variante qu’utilise réellement `pancha_vargeeya_bala` ; contrairement à `hadda_bala`, elle ne nécessite aucun thème en entrée.
harsha_bala	—	Le Harsha Bala, la « force de la joie » utilisée en tajaka : une planète marque 5 points pour chacune des quatre conditions suivantes — être dans sa maison de joie, être dans son propre signe ou dans un signe ami, être dans un signe de même genre qu’elle, et être dans la moitié du jour qui correspond à sa nature. Renvoie un objet avec les clés `"0"` à `"6"`, du Soleil à Saturne, chaque valeur étant un entier de 0 à 20 par pas de 5.
hora_bala	—	Force de l’heure planétaire : la planète qui régit la hora en cours au moment donné reçoit 60 virupas, toutes les autres zéro. Renvoie sept valeurs, du Soleil à Saturne, dont une seule est non nulle.
ishta_phala	—	L’Ishta Phala, la mesure du résultat bénéfique qu’une planète est susceptible d’apporter. Cette implémentation le note d’après la dignité dans le thème natal : 60 pour l’exaltation, 45 pour le moolatrikona, 30 pour le signe propre, puis 22, 15, 8, 4 ou 2 selon la relation de la planète avec le maître du signe. Renvoie sept entiers, du Soleil à Saturne. Notez que la définition classique tire plutôt l’Ishta Phala de l’Uccha et du Cheshta Bala : ces valeurs ne correspondront donc pas à un texte qui suit cette méthode.
kaala_bala	—	Force temporelle, la somme de neuf sous-composantes : Nathonnatha, Paksha, Tribhaga, Abda, Masa, Vaara, Hora, Ayana et Yuddha Bala. Renvoie sept nombres en virupas, du Soleil à Saturne, arrondis à deux décimales. Chaque sous-composante est disponible sous sa propre clé.
kendra_bala	—	Force de quadrant par type de maison : 60 virupas dans un angle (1, 4, 7, 10), 30 dans une maison succédente (2, 5, 8, 11) et 15 dans une maison cadente (3, 6, 9, 12). Renvoie sept valeurs de 60, 30 ou 15, du Soleil à Saturne. L’ascendant de référence est dérivé en interne de la position du Soleil au lever du soleil, et non du `asc_house` que vous envoyez.
kendras	asc_house	Les quatre maisons angulaires comptées à partir de l’ascendant que vous passez dans `asc_house` : une liste plate de quatre indices de signe À PARTIR DE ZÉRO, maisons 1, 4, 7 et 10. Notez les deux différences avec la clé `kendras` de /api/astro/house_hora/, qui renvoie douze lignes de numéros À PARTIR DE UN et ne prend aucun argument.
kshetra_bala	—	Force de champ, la première composante de l’ensemble quintuple tajaka : 30 virupas pour une planète dans son propre signe, 22.5 dans celui d’un grand ami, 15 dans celui d’un ami, 7.5 dans celui d’un neutre et 3.75 dans celui d’un ennemi, jugée sur le thème natal. Renvoie sept nombres, du Soleil à Saturne.
masa_bala	—	Force du maître du mois : la planète qui régit le mois reçoit 30 virupas, les autres zéro. Renvoie sept valeurs, du Soleil à Saturne, dont une seule vaut 30. Comme pour `abda_bala`, cette implémentation choisit le maître d’après le jour de la semaine de `date_time`, alors que `masadhipathi` le tire des jours écoulés.
masadhipathi	—	Le maître du mois, déterminé à partir de l’ahargana et non à partir du jour de la semaine. La planète maîtresse reçoit 30 virupas, les autres zéro. Renvoie sept valeurs, du Soleil à Saturne, dont une seule vaut 30. Préférez cette clé à `masa_bala`.
naisargika_bala	—	Force naturelle, un classement fixe des planètes par luminosité, qui ne varie jamais d’un thème à l’autre : 60.00, 51.43, 17.14, 25.71, 34.29, 42.86 et 8.57 virupas pour le Soleil, la Lune, Mars, Mercure, Jupiter, Vénus et Saturne. Renvoie ces sept constantes. Elle figure ici parce que le shadbala en fait l’une de ses six composantes.
nathonnath_bala	—	Force jour-nuit, la première partie du Kaala Bala : une force mesurée à partir de minuit local, qui va au Soleil, à Jupiter et à Vénus à mesure que le jour avance, et à la Lune, à Mars et à Saturne à mesure que la nuit avance ; Mercure reçoit d’office 60, car il est fort à toute heure. Renvoie sept nombres en virupas, du Soleil à Saturne.
navamsa_bala	—	Force du navamsa pour l’ensemble quintuple : 5 virupas pour une planète dans son propre signe dans le thème D9, 2.5 dans celui d’un ami et 1.25 dans celui d’un ennemi. Renvoie sept nombres, du Soleil à Saturne. `navamsa_bala_simple` applique la même règle avec la position D9 dérivée directement de la longitude.
navamsa_bala_simple	—	Force du navamsa avec la position D9 calculée directement à partir de la longitude (longitude multipliée par neuf) plutôt qu’à partir d’un thème D9 construit : 5 virupas dans son propre signe, 2.5 dans celui d’un ami, 1.25 dans celui d’un ennemi. Renvoie sept nombres, du Soleil à Saturne. C’est la variante qu’utilise `pancha_vargeeya_bala`.
ojayugama_bala	—	Force pair-impair : 15 virupas si la planète occupe un signe impair dans le thème natal, et 15 de plus si elle occupe un signe impair dans le navamsa ; le test est inversé pour la Lune et Vénus, qui préfèrent les signes pairs. Renvoie sept entiers, 0, 15 ou 30, du Soleil à Saturne.
paksha_bala	—	Force de la quinzaine lunaire, d’après l’écart Soleil-Lune divisé par trois : les bénéfiques obtiennent cette valeur et les maléfiques 60 moins cette valeur, de sorte que la moitié croissante favorise les bénéfiques et la moitié décroissante les maléfiques. La valeur de la Lune est ensuite doublée, ce qui explique qu’elle puisse dépasser 60. Renvoie sept nombres en virupas, du Soleil à Saturne.
panapharas	asc_house	Les quatre maisons succédentes — la 2e, la 5e, la 8e et la 11e — comptées à partir de la maison de l’ascendant que vous passez dans `asc_house`. Renvoie quatre entiers, `(asc_house + n - 1) mod 12` pour n valant 2, 5, 8 et 11 : ce sont donc des indices de signe à partir de 0, qui suivent la convention que vous avez adoptée pour `asc_house`. Les planètes placées dans ces maisons sont réputées donner des résultats moyens, entre ceux des angles et ceux des maisons cadentes.
pancha_vargeeya_bala	—	La force quintuple tajaka, utilisée pour les thèmes annuels : la moyenne des Kshetra, Uchcha, Hadda, Drekkana et Navamsa Bala. Une planète dans son propre signe obtient 30 pour le Kshetra, 22.5 dans celui d’un grand ami, 15 dans celui d’un ami, 7.5 dans celui d’un neutre et 3.75 dans celui d’un ennemi ; le Drekkana et le Navamsa sont notés sur 10 et 5 selon le même principe, et le Hadda sur 15 d’après les maîtres des termes égyptiens. Renvoie un objet avec les clés `"0"` à `"6"` pour les planètes du Soleil à Saturne, chacune un nombre à deux décimales, généralement compris entre 5 et 20.
planet_aspect_relationship_table	include_houses	La matrice complète des aspects qui sous-tend le Drik Bala : pour chaque paire ordonnée de planètes, la force de l’aspect que la seconde projette sur la première, notée d’après leur écart angulaire. Renvoie un tableau imbriqué de nombres à deux décimales, avec une ligne par planète aspectante. Passez `include_houses` à true pour étendre les colonnes aux douze cuspides de maisons en tant que points aspectés, en plus des planètes.
sapthavargaja_bala	—	Force issue de l’ensemble divisionnaire septuple : chaque planète est notée dans les D1, D2, D3, D7, D9, D12 et D30 selon qu’elle tombe dans son moolatrikona, son propre signe, ou un signe ami, neutre ou ennemi, et les sept scores sont additionnés. Renvoie sept nombres en virupas, du Soleil à Saturne.
shad_bala	—	Le calcul complet de la force sextuple. Renvoie un tableau de neuf éléments : les composantes Sthana, Kaala, Dig, Cheshta, Naisargika et Drik, chacune une liste de sept nombres en virupas ; puis les totaux en virupas ; puis les mêmes totaux en rupas (virupas divisés par 60) ; puis les rupas de chaque planète divisés par son seuil classique de 5, 6, 5, 7, 6.5, 5.5 et 5 pour les planètes du Soleil à Saturne. C’est cette dernière liste qu’il faut lire — au-dessus de 1, la planète a atteint son seuil.
sthana_bala	—	Force de position, la première des six : la somme des Uchcha, Sapthavargaja, Ojayugama, Kendra et Dreshkona Bala. Renvoie sept nombres en virupas, du Soleil à Saturne, arrondis à deux décimales. Demandez les cinq composantes séparément pour voir d’où vient le total.
subha_rashmi	—	Le Subha Rashmi, le nombre de « rayons propices » qu’émet une planète, calculé ici comme le quart de la somme de ses Cheshta et Uccha Rashmi. Renvoie sept nombres, du Soleil à Saturne. Hérite du statut expérimental de `cheshta_rashmi`.
tribhaga_bala	—	Force du tiers de jour : le jour et la nuit sont chacun divisés en trois, et la planète qui régit le tiers en cours reçoit 60 virupas. Jupiter reçoit 60 dans tous les cas. Renvoie sept valeurs, 0 ou 60, du Soleil à Saturne.
uccha_rashmi	—	L’Uccha Rashmi, les rayons qu’une planète émet du fait de son exaltation : la distance à son point de débilitation profonde, ramenée dans une plage 0–180, plus 30, puis convertie en rayons (multipliée par 2 et divisée par 30). Renvoie sept nombres, d’environ 2 à 14, du Soleil à Saturne, arrondis à une décimale.
uchcha_bala	—	Force d’exaltation : l’éloignement de chaque planète par rapport à son point de débilitation profonde, ramené à une échelle où une planète exactement sur son degré d’exaltation profonde obtient 20, et une planète sur son degré de débilitation profonde 0. Renvoie sept nombres de 0 à 20 en virupas, du Soleil à Saturne.
vaara_bala	—	Force du maître du jour de la semaine : la planète qui régit le jour de la semaine reçoit 45 virupas, les autres zéro. Renvoie sept valeurs, du Soleil à Saturne, dont une seule vaut 45. `vaaradhipathi` calcule la même chose à partir d’un décompte de jours écoulés et change de jour au lever du soleil, et non à minuit.
vaaradhipathi	—	Le maître du jour de la semaine, déterminé à partir de l’ahargana, le jour changeant au lever du soleil et non à minuit : un moment antérieur au lever appartient donc encore au maître de la veille. La planète maîtresse reçoit 45 virupas, les autres zéro. Renvoie sept valeurs, du Soleil à Saturne, dont une seule vaut 45. Préférez cette clé à `vaara_bala`.
yuddha_bala	—	Force de guerre planétaire. Lorsque deux planètes sont très proches l’une de l’autre, celle qui a la plus grande force cumulée est déclarée gagnante ; la différence entre leurs totaux, divisée par la différence entre leurs diamètres apparents, est ajoutée au gagnant et retranchée au perdant. Renvoie sept nombres, du Soleil à Saturne, pour la plupart nuls, avec une valeur positive et une valeur négative appariées lorsqu’une guerre est détectée. Les guerres qui impliquent le Soleil ou la Lune sont ignorées.

Référence complète de cet endpoint