Almuten Figuris API

The endpoint builds the natal chart and scores every one of the seven classical planets by the essential dignity it holds over the decisive positions of the figure. Each planet accumulates points where it rules by domicile, exaltation, triplicity, term and face, and the totals are compared. The response gives the winning planet, its score, and the score of all seven so you can see how close the contest was, alongside the chart the scoring was done on. In the sample nativity Venus wins with 23 against Mercury and Saturn tied on 14, so the verdict is comfortable rather than marginal, and that distinction is visible in the payload rather than hidden behind a single name. Because the calculation leans on the ascendant, the birth time matters more here than for a Sun-sign feature: a shift of a few minutes can move the ascendant into another term and change the tally.

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": {} }
  }
}

Use the almuten when a product needs one planet to organise everything else around. It answers the ruler question directly for a traditional chart reading, gives a report a spine to hang its narrative on, and provides an AI interpretation with a single anchor instead of ten equally weighted placements. It sits naturally next to the essential dignities endpoint, which shows the underlying scoring in detail, and next to profections, where the lord of the year is a similar idea applied to time rather than to the whole life. The returned scores are worth surfacing to the user when the top two are close, because a narrow win is a real astrological statement about a chart divided between two rulers.

Scoring follows the traditional five essential dignities, domicile, exaltation, triplicity, term and face, weighted in the classical manner and accumulated across the decisive positions of the figure. The seven classical planets are scored; the modern outers take no rulerships in this scheme. The chart is computed by the Swiss Ephemeris engine in the tropical zodiac.