AstroWay/api v2.202.3 · de
alle Systeme in Ordnung
// astrology api · POST /v1/almuten

Almuten Figuris API

Der Almuten Figuris ist die traditionelle Antwort auf eine Frage, die das moderne Chart vermeidet: Welcher einzelne Planet hat den stärksten Anspruch auf diese Nativity? Das wird durch das Zählen von Dignity an den Schlüsselstellen des Charts entschieden und der Gewinner ermittelt, und der endpoint liefert sowohl den Gewinner als auch die komplette Auszählung.

Endpunkt
POST /v1/almuten
Kosten
20 Credits
Latenz
~48 ms
Stufe
Tier 2
// 01 / Was es berechnet

Almuten Figuris API

Der endpoint baut das natal chart auf und bewertet jeden der sieben klassischen Planeten nach der essential dignity, die er über die entscheidenden Positionen der Figur hat. Jeder Planet sammelt Punkte, wo er durch domicile, exaltation, triplicity, term und face herrscht, und die Summen werden verglichen. Die response liefert den winning planet, dessen score und die scores aller sieben, sodass du sehen kannst, wie knapp der contest war, zusammen mit dem chart, auf dem die scoring erfolgte. Im Beispiel-Nativity gewinnt Venus mit 23 gegen Mercury und Saturn, die je 14 haben, also ist das verdict komfortabel statt marginal, und diese distinction ist im payload sichtbar statt hinter einem einzelnen Namen versteckt. Da die Berechnung auf dem ascendant basiert, ist die birth time hier wichtiger als bei einer Sun-sign-Funktion: Eine Verschiebung um ein paar Minuten kann den ascendant in einen anderen term bringen und die tally ändern.

// 02 / Live-Anfrage

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"
}'
Antwort (Auszug)
{
  "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 / Parameter

Parameter

nametypeErforderlich
date string (YYYY-MM-DD) ja Birth date.
time string (HH:MM:SS) ja Local clock time at birth. The almuten depends on the ascendant, so an accurate time matters here.
timezoneOffset number (hours) ja UTC offset in effect at the birth moment.
latitude number ja Birth-place latitude, decimal degrees (north positive).
longitude number ja Birth-place longitude, decimal degrees (east positive).
houseSystem string nein House system code, P for Placidus by default.
// 04 / Wann verwenden

Wann verwenden

Benutze den almuten, wenn ein Produkt einen einzigen Planet braucht, um alles andere zu organisieren. Er beantwortet die ruler-Frage direkt für eine traditionelle chart-Reading, gibt einem Report eine spine, um seine narrative aufzuhängen, und liefert eine AI-Interpretation mit einem einzigen anchor statt zehn gleichgewichteter placements. Er sitzt natürlich neben dem essential dignities endpoint, der die underlying scoring im Detail zeigt, und neben profections, wo der lord of the year eine ähnliche Idee ist, die auf time statt auf das ganze life angewendet wird. Die returned scores sollten dem user gezeigt werden, wenn die top two eng beieinander liegen, weil ein narrow win eine echte astrologische Aussage über ein chart ist, das zwischen zwei rulers aufgeteilt ist.

// 05 / Hinweise

Hinweise

Scoring folgt den traditionellen fünf essential dignities: domicile, exaltation, triplicity, term und face, weighted in der klassischen Weise und über die entscheidenden Positionen der Figur akkumuliert. Die sieben klassischen Planeten werden scored; die modernen outers erhalten in diesem Schema keine rulerships. Das chart wird von der Swiss Ephemeris Engine im tropical zodiac berechnet.

Almuten Figuris-API ausprobieren

Hol dir einen Key und mach deinen ersten Aufruf in unter einer Minute.

99,9% SLA · kostenpflichtige Tarife · 30 Tage Status →