Traditional Dignities Suite

Bonatti Almuten + Figuris in One Almuten API

Bonatti 5/4/3/2/1 weights across all five essential dignities.

Five hyleg points including prenatal syzygy computed by a Brent solver. Sect-aware Dorothean triplicity. Almuten Figuris with accidental bonuses for angularity, sect, and hayz. One endpoint returns the per-point winner, the score breakdown by dignity table, and the soul-lord of the chart.

View Live Demo

5/4/3/2/1

Bonatti dignity weights

Hyleg points scored

Figuris

Soul-lord winner included

<300ms

P95 response time

1-arcsecond planetary precision

Prenatal syzygy via Brent solver

99.9% uptime SLA

Only essential dignities scored, accidental bonuses missing entirely
Prenatal syzygy point skipped, so usually only 4 hyleg points get returned
Triplicity ruler returned without sect awareness, so night charts score wrong
No Almuten Figuris winner, just per-point tables you assemble yourself
Modern rulers leak into Scorpio, Aquarius, and Pisces score calculations

Switch to

Full Bonatti 5/4/3/2/1 weights across domicile, exaltation, triplicity, term, and face
All 5 hyleg points including prenatal syzygy via a Brent solver on Sun–Moon elongation
Sect-aware Dorothean triplicity: day ruler scores in day charts, night ruler in night charts
Almuten Figuris winner with separated essential and accidental totals
Traditional domicile rulers locked for Scorpio, Aquarius, and Pisces, modern co-ruler noted
Per-point breakdown by planet and by dignity table in one JSON response

Almuten API at a Glance

Bonatti weights, five hyleg points, sect-aware scoring

<300ms

P95 response time

Hyleg points scored

5/4/3/2/1

Bonatti weights

1 arcsecond

Planetary precision

Almuten API Feature List

Everything the one endpoint returns

Bonatti 5/4/3/2/1 weights

Classical scoring: 5 domicile, 4 exaltation, 3 triplicity, 2 term, 1 face

Sourced from Liber Astronomiae III ch.5, al-Biruni Tafhim §496

5 hyleg points scored

Ascendant, Sun, Moon, Lot of Fortune, and prenatal syzygy in one request

Default points array, override via points param

Prenatal syzygy via Brent solver

Exact New Moon or Full Moon before birth to arcsecond precision

Brent root solver on Δλ(Moon, Sun) mod 180

Sect-aware Dorothean triplicity

Day ruler scores in day charts, night ruler in night charts, no double-counting

Sect detected from Sun above / below horizon at birth

Almuten Figuris winner

Soul-lord of the chart with essential, accidental, and grand totals separated

Element-wise sum of 5 score vectors + accidental bonuses

Angularity accidental bonus

+5 angular, +4 succedent, +3 cadent, with the cadent rule toggleable via flag

Ibn Ezra weights per Dykes, Persian Nativities III

Sect and hayz bonuses

+5 for matching the sect of the chart, +3 for rejoicing in own hemisphere

Luminary of sect bonus + above/below horizon match

Modern ruler guard

Pluto, Uranus, Neptune locked out of Scorpio, Aquarius, Pisces scoring

Traditional Mars / Saturn / Jupiter rulers used, moderns exposed separately

Term / bound system flag

Egyptian (default) or Ptolemaic to match your tradition

bound_system: 'egyptian' | 'ptolemaic'

Per-point score breakdown

scores_by_planet and scores_by_dignity_table on every point

Renders directly into report tables, no client-side math

Custom points support

Score any ecliptic longitude, not just the default hyleg

Pass {name, longitude} pairs in the points array

MCP tool registration

Claude, GPT, and other agents can request almuten directly

Registered tool name: traditional_almuten

Lot of Fortune doctrine selector

Choose by-sect (Valens/Paulus) or Ptolemaic (Tetrabiblos III.10) reversal for the Fortune hyleg point, since Fortune's degree can shift the almuten winner in night charts

doctrine.lot_reversal: 'by_sect' (default) | 'ptolemaic'

Almuten API: Bonatti Weights, Hyleg Points, and Figuris

One endpoint that returns per-point almuten plus the chart-wide soul-lord

The almuten of a point is the planet with the strongest dignity claim over that point. The classical scoring comes from Bonatti's Liber Astronomiae: 5 points for domicile, 4 for exaltation, 3 for the sect-correct triplicity ruler, 2 for the term or bound, and 1 for the face or decan. The planet with the highest sum across all five dignity tables wins. POST /api/v3/traditional/almuten accepts a birth subject and returns the per-point almuten table for the five classical hyleg points: Ascendant, Sun, Moon, Lot of Fortune, and prenatal syzygy. It also sums the five score vectors and returns the Almuten Figuris (the soul-lord or lord of geniture) with accidental bonuses for house placement, sect agreement, and hayz. Every weight follows Bonatti and al-Biruni. Triplicity is sect-aware Dorothean. Prenatal syzygy is computed via a Brent solver on the Sun–Moon elongation. Response time is under 300 milliseconds.

What does Bonatti 5/4/3/2/1 actually mean?

Bonatti's weights, reproduced in al-Biruni's Tafhim §496 and Dykes's Introductions to Traditional Astrology p.71, assign a number of points to whichever planet rules a given dignity at a given zodiac degree.

Domicile is worth 5 because the domicile ruler has the strongest claim: the planet is at home.

Exaltation is worth 4: a guest of honor, strong but not the host.

Triplicity is worth 3 and goes to a single sect-correct ruler, not split between day and night rulers.

Term (bound) is worth 2 and rewards the planet ruling the specific 5–10 degree slice the point sits in.

Face (decan) is worth 1 for the planet ruling the 10 degree third of the sign.

Add these together for each of the seven traditional planets across one ecliptic longitude and the winner is the almuten of that point.

The /api/v3/traditional/almuten endpoint runs this calculation for every requested point and returns both the totals per planet and the breakdown per dignity table so report code can re-render the math without recomputing.

Five dignity tables, integer weights, one winner per point

1 min read

Why prenatal syzygy is the hyleg point most APIs skip

The five hyleg points come from Bonatti's Liber Astronomiae III §12 and from Brennan's Hellenistic Astrology p.539.

Four of them are easy: Sun, Moon, Ascendant, and Lot of Fortune.

The fifth is harder: prenatal syzygy, the New Moon or Full Moon immediately before birth.

Computing it correctly requires walking back in time from the birth moment and finding the exact instant when the elongation between Sun and Moon crosses 0 degrees (new) or 180 degrees (full), whichever was the most recent event.

The Almuten API uses a Brent root solver on the elongation function modulo 180 degrees to pin the syzygy moment to arcsecond precision.

Most APIs skip this step and return only four hyleg points, which gives you an incomplete picture and a wrong Almuten Figuris.

The Figuris calculation depends on summing all five score vectors, so dropping syzygy shifts the winner.

The response includes the syzygy datetime, longitude, sign, and whether it was a new moon or full moon.

Brent solver on Sun–Moon elongation, arcsecond syzygy datetime

1 min read

Sect-aware Dorothean triplicity: day vs night handled correctly

Triplicity rulers in the Dorothean (Hellenistic) system come in pairs: one day ruler and one night ruler for each of the four elements.

Fire is day-ruled by the Sun and night-ruled by Jupiter.

Earth is day-ruled by Venus and night-ruled by the Moon.

Air is day-ruled by Saturn and night-ruled by Mercury.

Water is day-ruled by Venus and night-ruled by Mars.

The Bonatti standard scores only the sect-correct ruler with 3 points, not both.

Some software incorrectly gives half-credit to both rulers, which inflates totals and skews the winner.

The Almuten API checks the sect of the chart (Sun above or below the horizon at birth) and awards 3 points only to the matching triplicity ruler.

The night ruler scores 0 in a day chart and vice versa.

A participating ruler flag is exposed in the response for users who follow Dykes's Carmen I.6 reading that the third (participating) triplicity ruler should be excluded from the calculation entirely.

Day chart scores day ruler, night chart scores night ruler, no double-counting

1 min read

Almuten Figuris: the soul-lord with accidental bonuses

The Almuten Figuris is the chart-wide almuten, also called the lord of the geniture and sometimes translated as the soul-lord or life-lord.

It is computed by summing the five per-point score vectors element-wise, then adding accidental bonuses per Ibn Ezra (Dykes, Persian Nativities III).

The accidental layer adds: +5 if the planet sits in an angular house (1, 4, 7, 10), +4 in a succedent house (2, 5, 8, 11), +3 in a cadent house (3, 6, 9, 12), +5 if the planet matches the sect of the chart (the luminary of sect bonus), and +3 if the planet is rejoicing in its own sect hemisphere (diurnal planet above the horizon in a day chart, nocturnal below in a night chart).

The response separates essential_total, accidental_total, and grand_total so report code can present the math layer by layer.

Tie-breaks follow Bonatti: higher essential score first, then higher accidental score, then closer angular distance to the Ascendant degree, then faster planet wins.

Essential + accidental + grand_total, tie-breaks per Bonatti

1 min read

Modern rulers locked out of traditional calculations

Three signs have modern co-rulers that classical astrologers did not use: Scorpio (Pluto), Aquarius (Uranus), and Pisces (Neptune).

The traditional domicile rulers for these signs are Mars, Saturn, and Jupiter respectively.

Plugging in Pluto, Uranus, or Neptune as the domicile ruler corrupts every weight downstream: the +5 goes to a planet Bonatti would not have recognized, and the Figuris winner shifts to a planet with no traditional standing.

The Almuten API always uses the traditional domicile ruler for the 5-point dignity table.

Modern rulers are still surfaced in a separate modern_co_ruler field on the response so consumers can render the modern view in parallel without rerunning the request.

The same guard applies to exaltation lookups and to triplicity rulers, both of which predate the modern outer planets and never name them.

This single fix is the difference between a Bonatti-compatible response and a generic dignity score that mixes traditions.

Mars rules Scorpio, Saturn rules Aquarius, Jupiter rules Pisces (no Pluto / Uranus / Neptune in the score)

1 min read

Response shape, parameters, and integration patterns

POST /api/v3/traditional/almuten takes a standard birth subject (date, time, latitude, longitude, timezone) and an optional points array.

The default points are the five hyleg: Ascendant, Sun, Moon, Lot_of_Fortune, and Prenatal_Syzygy.

You can request a subset (for example just Sun and Moon) or add any other ecliptic longitude by passing a custom point with name and longitude.

The response data block has two keys: points and almuten_figuris.

The points array gives per-point longitude, sign, almuten_planet, scores_by_planet, and scores_by_dignity_table.

The almuten_figuris block gives winner, essential_total, accidental_total, grand_total, and tie_break_applied.

The endpoint is registered as an MCP tool so Claude, GPT, and other agents can call it directly without bespoke HTTP plumbing.

The same data feeds the /traditional/dignities composite, which combines almuten with mutual receptions and hayz in one response.

A zodiac API built for traditional astrology should go beyond basic sign positions and preserve the full dignity-scoring logic used in Almuten calculations.

POST endpoint, optional points array, MCP-registered

1 min read

Use Cases

Traditional astrologers going digital

Bonatti and Lilly practitioners get the exact 5/4/3/2/1 scoring used in the classical texts, with sect-aware triplicity

Hellenistic and medieval revival apps

SaaS products in the Brennan / Dykes / Hand school can ship Figuris and hyleg almuten on day one

AI chatbots and report generators

MCP tool means LLM agents request soul-lord context directly, with no custom HTTP code and no scoring logic to maintain

Professional report PDFs

The score breakdown per dignity table renders cleanly into a side-by-side comparison in a report layer

Horary and electional workflows

Pair almuten of the Ascendant with horary querent analysis or electional inception points for layered judgment

Research and education platforms

Compare Bonatti, Ibn Ezra, and al-Biruni scoring rules on the same chart by toggling the accidental flags

Technical Specifications

Endpoint	POST /api/v3/traditional/almuten
Dignity weights	Bonatti 5/4/3/2/1 (domicile, exaltation, triplicity, term, face)
Default points	5 hyleg: Ascendant, Sun, Moon, Lot of Fortune, Prenatal Syzygy
Custom points	Any ecliptic longitude by name + degree
Triplicity	Sect-aware Dorothean (day ruler scores in day charts, night ruler in night charts)
Prenatal syzygy	Brent solver on Sun–Moon elongation mod 180 degrees
Term table	Egyptian (default), Ptolemaic via bound_system flag
Face table	Chaldean decan order
Almuten Figuris	Sum of five score vectors + accidental bonuses (angularity, sect, hayz)
Accidental bonuses	+5 angular / +4 succedent / +3 cadent, +5 sect match, +3 sect rejoicing
Tie-break order	essential > accidental > angular distance to ASC > faster planet
Modern ruler guard	Mars rules Scorpio, Saturn rules Aquarius, Jupiter rules Pisces (modern co-rulers exposed separately)
Planetary precision	1 arcsecond (Swiss Ephemeris)
P95 response time	<300ms
MCP tool registration	Yes, agent-callable

Why the Almuten API Beats Generic Dignity Scorers

Feature	Astrology API	Others
Hyleg points scored	5 (incl. prenatal syzygy)	4 (syzygy skipped)
Dignity weights	Bonatti 5/4/3/2/1	Custom or flat scoring
Triplicity	Sect-aware Dorothean, single ruler	Both rulers half-credit or sect ignored
Almuten Figuris	Returned with essential + accidental + grand_total	Not returned
Accidental bonuses	Angularity, sect match, hayz rejoicing	Essential only
Modern ruler guard	Mars / Saturn / Jupiter for Sco / Aqu / Pis	Pluto / Uranus / Neptune leak in
Tie-break logic	Bonatti 4-step order	Arbitrary or none
P95 response time	<300ms	1 to 3 seconds
MCP tool	Yes	No
Price	$11/month for 1,000 requests	$49 to $199/month
Free tier	50 requests/month forever	No free tier

Related Traditional Astrology APIs

Dignities API

Five essential dignities per planet: domicile, exaltation, triplicity, term, face

Traditional Astrology Suite

Hellenistic and medieval techniques in one suite: dignities, lots, hayz, sect

Arabic Parts API

97+ Arabic Lots including Fortune, Spirit, Eros, Necessity, Courage

Horary API

Lilly-style horary judgment with significators, receptions, and prohibitions

Lot of Spirit API

Sect-aware Spirit calculation, the mind / intention lot

Part of Fortune API

Sect-aware Fortune lot, the body / livelihood point

References & Standards

Swiss Ephemeris (DE431-based) — astronomical calculations source
NASA JPL Planetary Ephemerides — underlying ephemeris dataset
International Astronomical Union (IAU) — body designation and nomenclature standards
IANA Time Zone Database — timezone & DST resolution

Simple, Transparent Pricing

Start free, scale as you grow. No hidden fees, no surprises.

Always Free

Start Free

Perfect for learning, testing, and small personal projects

50 API calls/month

Basic natal charts

5 house systems

Community support

Pro

$11/month

For small apps and personal projects

All basic endpoints
12 house systems
Email support

Best Value

Pro Plus

$21/month

For growing apps and medium traffic

All enhanced endpoints
18 house systems
AI interpretations
Priority email support

Ultra

$37/month

For professional astrology applications

Credit math ↓

All premium endpoints
23 house systems
Advanced AI interpretations
Priority support

High Volume Plans

For enterprise-scale applications

Business

$99/month

For high-volume applications

Credit math ↓

ALL endpoints
White-label ready
Custom AI fine-tuning
Phone support

UNLIMITED

Enterprise

$399+per month

Unlimited requests with dedicated infrastructure

Dedicated server infrastructure
Sub-300ms guaranteed
24/7 dedicated support
99.99% uptime SLA

All plans include comprehensive documentation and SDKs

Questions? Talk to our team

Almuten API FAQ

Can I choose between by-sect and Ptolemaic Lot of Fortune calculation?

Build a Full Traditional Dignity Stack

Pair the Almuten API with the rest of the traditional astrology suite. Add

Dignities API Traditional astrology suite Arabic Parts API Horary API Lot of Spirit API Part of Fortune API

Ship Bonatti-Faithful Almuten in One

Per-point almuten table, Almuten Figuris winner, sect-aware Dorothean triplicity, prenatal syzygy via Brent solver. Modern outer planets locked out of traditional scoring. Sub-300ms P95.

Start Free Now Read API Docs

50 free requests per month, forever

30-day money-back guarantee

No setup fees, no credit card to start

Almuten API: Bonatti Weights, Hyleg Points, and Figuris

One endpoint that returns per-point almuten plus the chart-wide soul-lord

Use Cases

Traditional astrologers going digital

Bonatti and Lilly practitioners get the exact 5/4/3/2/1 scoring used in the classical texts, with sect-aware triplicity

Hellenistic and medieval revival apps

SaaS products in the Brennan / Dykes / Hand school can ship Figuris and hyleg almuten on day one

AI chatbots and report generators

MCP tool means LLM agents request soul-lord context directly, with no custom HTTP code and no scoring logic to maintain

Professional report PDFs

The score breakdown per dignity table renders cleanly into a side-by-side comparison in a report layer

Horary and electional workflows

Pair almuten of the Ascendant with horary querent analysis or electional inception points for layered judgment

Research and education platforms

Compare Bonatti, Ibn Ezra, and al-Biruni scoring rules on the same chart by toggling the accidental flags

Technical Specifications

Endpoint	POST /api/v3/traditional/almuten
Dignity weights	Bonatti 5/4/3/2/1 (domicile, exaltation, triplicity, term, face)
Default points	5 hyleg: Ascendant, Sun, Moon, Lot of Fortune, Prenatal Syzygy
Custom points	Any ecliptic longitude by name + degree
Triplicity	Sect-aware Dorothean (day ruler scores in day charts, night ruler in night charts)
Prenatal syzygy	Brent solver on Sun–Moon elongation mod 180 degrees
Term table	Egyptian (default), Ptolemaic via bound_system flag
Face table	Chaldean decan order
Almuten Figuris	Sum of five score vectors + accidental bonuses (angularity, sect, hayz)
Accidental bonuses	+5 angular / +4 succedent / +3 cadent, +5 sect match, +3 sect rejoicing
Tie-break order	essential > accidental > angular distance to ASC > faster planet
Modern ruler guard	Mars rules Scorpio, Saturn rules Aquarius, Jupiter rules Pisces (modern co-rulers exposed separately)
Planetary precision	1 arcsecond (Swiss Ephemeris)
P95 response time	<300ms
MCP tool registration	Yes, agent-callable

Why the Almuten API Beats Generic Dignity Scorers

Feature	Astrology API	Others
Hyleg points scored	5 (incl. prenatal syzygy)	4 (syzygy skipped)
Dignity weights	Bonatti 5/4/3/2/1	Custom or flat scoring
Triplicity	Sect-aware Dorothean, single ruler	Both rulers half-credit or sect ignored
Almuten Figuris	Returned with essential + accidental + grand_total	Not returned
Accidental bonuses	Angularity, sect match, hayz rejoicing	Essential only
Modern ruler guard	Mars / Saturn / Jupiter for Sco / Aqu / Pis	Pluto / Uranus / Neptune leak in
Tie-break logic	Bonatti 4-step order	Arbitrary or none
P95 response time	<300ms	1 to 3 seconds
MCP tool	Yes	No
Price	$11/month for 1,000 requests	$49 to $199/month
Free tier	50 requests/month forever	No free tier

Bonatti Almuten + Figuris in One Almuten API

Most APIs Skip Half the Almuten Calculation

What the Almuten API Returns

Almuten API at a Glance

Almuten API Feature List

Bonatti 5/4/3/2/1 weights

5 hyleg points scored

Prenatal syzygy via Brent solver

Sect-aware Dorothean triplicity

Almuten Figuris winner

Angularity accidental bonus

Sect and hayz bonuses

Modern ruler guard

Term / bound system flag

Per-point score breakdown

Custom points support

MCP tool registration

Lot of Fortune doctrine selector

Almuten API: Bonatti Weights, Hyleg Points, and Figuris

What does Bonatti 5/4/3/2/1 actually mean?

Why prenatal syzygy is the hyleg point most APIs skip

Sect-aware Dorothean triplicity: day vs night handled correctly

Almuten Figuris: the soul-lord with accidental bonuses

Modern rulers locked out of traditional calculations

Response shape, parameters, and integration patterns

Use Cases

Traditional astrologers going digital

Hellenistic and medieval revival apps

AI chatbots and report generators

Professional report PDFs

Horary and electional workflows

Research and education platforms

Technical Specifications

Why the Almuten API Beats Generic Dignity Scorers

Related Traditional Astrology APIs

Dignities API

Traditional Astrology Suite

Arabic Parts API

Horary API

Lot of Spirit API

Part of Fortune API

References & Standards

Simple, Transparent Pricing

Always Free

Pro

Pro Plus

Ultra

Business

Enterprise

Almuten API FAQ

What is the Almuten Figuris?

What weights does the API use? Bonatti's 5/4/3/2/1?

Does the API compute prenatal syzygy?

How is sect handled for triplicity?

What are the 5 hyleg points?

How does this compare to Solar Fire, Janus, and Morinus?

How is this different from a simple essential-dignity calculator?

How much does the Almuten API cost?

What accidental bonuses are added to the Figuris?

How are ties broken when two planets score the same?

Does the API use Egyptian or Ptolemaic terms?

Are modern outer planets included in the score?

Can I score points other than the 5 hyleg?

How fast is the calculation?

Is the endpoint registered as an MCP tool?

What programming languages can I call the API from?

Can I combine almuten with mutual receptions and hayz?

Does the API handle nocturnal charts and the night Lot of Fortune?

Does the choice of Lot of Fortune doctrine affect almuten scoring?

Can I choose between by-sect and Ptolemaic Lot of Fortune calculation?

Build a Full Traditional Dignity Stack

Ship Bonatti-Faithful Almuten in One

Most APIs Skip Half the Almuten Calculation

What the Almuten API Returns

Almuten API at a Glance

Almuten API Feature List

Bonatti 5/4/3/2/1 weights

5 hyleg points scored

Prenatal syzygy via Brent solver

Sect-aware Dorothean triplicity