AstroWay/api v2.201.6 · fr
tous les systèmes sont opérationnels
// astrology api · POST /v1/almuten

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.

Endpoint
POST /v1/almuten
Cost
20 credits
Latency
~48 ms
Tier
Tier 2
// 01 / What it computes

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.

// 02 / Live request

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"
}'
Response (excerpt)
{
  "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": {} }
  }
}
// 03 / Parameters

Parameters

nametypeRequired
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.
// 04 / When to use it

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.

// 05 / Notes

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.

99,9% SLA · forfaits payants · 30 j statut →