predictive

Zodiacal Releasing Time Lords

Calculate zodiacal releasing — the Hellenistic timing technique of Vettius Valens (Anthology IV), which divides a life into a handful of chapters released from a sensitive Lot (Fortune for body and health, Spirit for career and action).

Each sign releases for its own minor years: Aries 15, Taurus 8, Gemini 20, Cancer 25, Leo 19, Virgo 20, Libra 8, Scorpio 15, Sagittarius 12, Capricorn 27, Aquarius 30, Pisces 12 — a full circuit of 211. Levels run on the traditional clock: a level-1 "year" is 360 days and a level-2 "month" is 30, each sub-level exactly one twelfth of the level above.

Angular periods (1st, 4th, 7th, 10th from the Lot) mark peak chapters. The loosing of the bond is an event in the sub-period sequence, not a property of a sign: when the level-2 walk would return to the sign its general period began on, it jumps to the sign opposite that period and carries on forward. Only general periods longer than one circuit (211 months ≈ 17.58 years) can contain one — Gemini, Cancer, Leo, Virgo, Capricorn and Aquarius.

When the Lots of Fortune and Spirit fall in the same sign, releasing from Spirit begins one sign forward (Valens IV, 4:7); spirit_advanced reports when that rule fired.

Returns L1 general periods with their L2 sub-periods as absolute dates, peak-period identification, angular/loosing flags, and the active period at the target datetime.

🤖 Agent-first endpoint — pure deterministic math, no ephemeris required.

post/predictive/time-lords/zodiacal-releasing

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/predictive/time-lords/zodiacal-releasing
  • Auth: one of:
    • HTTP bearer
    • API key in header X-OpenEphemeris-API-Key
    • API key in header X-API-Key
    • API key in header X-Service-Key

Query parameters

formatstring

Response format: json | llm.

output_modestring nullable

Deprecated: use format. Accepts full|simple|llm.

Request body

birth_datetimestring date-time required

Natal birth datetime in ISO 8601 UTC format.

house_systemstring

Optional.

latitudenumber

Optional. If provided, calculates natal chart to determine ascendant/sect/lots.

longitudenumber

Optional.

lot_name'fortune' | 'spirit' required

Which Lot to release from. 'fortune' for body/health chapters, 'spirit' for career/action chapters.

lot_signinteger required

Zodiac sign of the releasing Lot (0 = Aries, 1 = Taurus, … 11 = Pisces).

max_yearsinteger

How far to run the timeline, in calendar years. Default: 100.

other_lot_signinteger

Optional. Sign of the OTHER Lot (0 = Aries … 11 = Pisces). Supplied only so Valens' same-sign rule can fire: releasing from Spirit when it shares Fortune's sign begins one sign forward. Omit it and the rule does not apply. Ignored when latitude/longitude are given, since both Lots are then computed.

target_datetimestring date-time

Date to highlight the active period for. Defaults to the current date if omitted.

Response

Successful Response

lot_signinteger required

Sign index of the Lot actually released from (0–11). When spirit_advanced is true this is one sign past the submitted lot_sign.

lot_sign_namestring required

Name of the sign actually released from (e.g., 'Leo').

output_modestring nullable

Output projection mode (json | llm).

peak_period_indexinteger required

Index of the longest angular L1 period (the peak chapter).

spirit_advancedboolean required

True when Valens' same-sign rule (IV, 4:7) moved Spirit forward one sign because it shared Fortune's. It changes every date in the timeline, so surface it.

starting_lotstring required

Name of the releasing Lot ('fortune' or 'spirit').

successboolean required

Whether the calculation succeeded.

total_yearsinteger required

Total 360-day years covered by the L1 timeline.

Changes

No recorded changes to this operation across all 1 revision of this API.