predictive

Annual Profections Time Lords

Calculate annual profections — the foundational Hellenistic timing technique that advances one zodiac sign per birthday from the natal Ascendant. Returns the profected sign, activated house, time lord planet, element, modality, and a full multi-year timeline.

Profections are the simplest and most widely used timing technique in traditional astrology, experiencing a major revival in modern Hellenistic practice. Each year of life activates one whole-sign house from the Ascendant; the ruler of that sign becomes the "time lord" coloring the entire year. Angular years (1st, 4th, 7th, 10th) are typically the most eventful.

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

post/predictive/time-lords/profections

Request

  • Base URL: https://api.openephemeris.com
  • URL: https://api.openephemeris.com/predictive/time-lords/profections
  • 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

ascendant_signinteger required

Natal ascendant sign index (0 = Aries, 1 = Taurus, … 11 = Pisces). Determines the 1st-house starting sign for the profection wheel.

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.

target_datetimestring date-time

Date to evaluate the profection for. Defaults to the current date if omitted.

years_backwardinteger

Number of past profection years to include in the timeline. Default: 5.

years_forwardinteger

Number of future profection years to include in the timeline. Default: 10.

Response

Successful Response

ascendant_sign_namestring

Natal Ascendant sign name for reference.

birth_datetimestring

Birth datetime used for the calculation.

output_modestring nullable

Output projection mode (json | llm).

successboolean required

Whether the calculation succeeded.

Changes

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