Almuten Figuris API
L'almuten figuris est la réponse traditionnelle à une question que le thème moderne évite : quelle planète unique a la revendication la plus forte sur cette nativité. On décide en comptant la dignité sur les lieux clés du thème et en prenant le gagnant, et le endpoint renvoie à la fois le gagnant et le total complet.
Almuten Figuris API
Le endpoint construit le thème natal et note chacune des sept planètes classiques selon la dignité essentielle qu’elle possède sur les positions décisives de la figure. Chaque planète accumule des points où elle règne par domicile, exaltation, triplicité, terme et face, puis les totaux sont comparés. La réponse donne la planète gagnante, son score, et le score des sept afin que tu voies à quel point le concours était serré, ainsi que le thème sur lequel le calcul a été fait. Dans la nativité d’exemple, Vénus gagne avec 23 contre Mercure et Saturne à égalité à 14, donc le verdict est confortable plutôt que marginal, et cette distinction est visible dans le payload plutôt que cachée derrière un seul nom. Parce que le calcul s’appuie sur l’ascendant, l’heure de naissance compte plus ici qu’avec une fonction Sun-sign : un décalage de quelques minutes peut déplacer l’ascendant dans un autre terme et changer le total.
POST/v1/almuten
curl -X POST https://api.astroway.info/v1/almuten \
-H "X-Api-Key: aw_live_..." \
-H "Content-Type: application/json" \
-d '{
"date": "1990-05-15",
"time": "14:30:00",
"timezoneOffset": 3,
"latitude": 50.45,
"longitude": 30.52,
"houseSystem": "P"
}' {
"ok": true,
"data": {
"almuten": {
"planet": "Venus",
"score": 23,
"scores": {
"Sun": 1, "Moon": 8, "Mercury": 14, "Venus": 23,
"Mars": 9, "Jupiter": 2, "Saturn": 14
}
},
"chart": { "planets": [], "houses": {} }
}
} Parameters
| name | type | Required | |
|---|---|---|---|
| date | string (YYYY-MM-DD) | yes | Birth date. |
| time | string (HH:MM:SS) | yes | Local clock time at birth. The almuten depends on the ascendant, so an accurate time matters here. |
| timezoneOffset | number (hours) | yes | UTC offset in effect at the birth moment. |
| latitude | number | yes | Birth-place latitude, decimal degrees (north positive). |
| longitude | number | yes | Birth-place longitude, decimal degrees (east positive). |
| houseSystem | string | no | House system code, P for Placidus by default. |
When to use it
Utilise l’almuten quand un produit a besoin d’une planète pour organiser tout le reste. Il répond directement à la question du maître pour une lecture de thème traditionnelle, donne à un rapport une colonne vertébrale pour soutenir son récit, et fournit une interprétation IA avec un seul ancrage au lieu de dix placements pondérés également. Il se place naturellement à côté du endpoint des dignités essentielles, qui montre le scoring sous-jacent en détail, et à côté des profections, où le seigneur de l’année est une idée similaire appliquée au temps plutôt qu’à toute la vie. Les scores renvoyés valent la peine d’être affichés à l’utilisateur quand les deux premiers sont proches, car une victoire étroite est une vraie affirmation astrologique d’un thème partagé entre deux maîtres.
Notes
Le scoring suit les cinq dignités essentielles traditionnelles : domicile, exaltation, triplicité, terme et face, pondérées à la manière classique et accumulées sur les positions décisives de la figure. Les sept planètes classiques sont notées ; les extérieures modernes n’ont aucun règne dans ce schéma. Le thème est calculé par le moteur Swiss Ephemeris dans le zodiaque tropical.
Try the Almuten Figuris API
Grab a key and make your first call in under a minute.