Documented scope, not a complete tradition engine

Hellenistic Astrology API Building Blocks

Two date modes: standard civil inputs cover 1800–2200. All 77 date-bearing operations also accept explicit historical inputs from 1000 BCE (BC) to 2500 CE (AD), with a chosen calendar and, for timed calculations, UT1 or a fixed UT1 offset. Date-only numerology requires an explicit year-digit convention. Place search is date-independent. Each tool retains its search, geometry, derived-date and export limits; historical iCalendar is not supported. The ordinary date-string examples below describe standard mode. Historical input guide and current schemas.

Cosmic Ephemeris is not a complete Hellenistic astrology system. It provides selected building blocks—most notably tropical chart calculations, whole-sign houses, and supported structured fields involving sect—that developers can combine with their own historically grounded rules and editorial judgment.

What is supported today?

Tropical zodiac output is Cosmic Ephemeris's default. The chart engine returns planetary longitudes, the Ascendant and Midheaven, aspects, lunar-node fields, and equal and whole-sign house layouts. Selecting whole_sign places the first cusp at the beginning of the Ascendant's sign and advances subsequent cusps in 30-degree steps. The separate Houses API also exposes 22 current opt-in twelve-house systems, including quadrant systems, plus Houses-only Gauquelin sectors; choosing one is a calculation option, not an endorsement of a particular historical practice.

The current horoscope endpoint is deterministic and rule based. Its sect-related values are product heuristics—not a claim of scholarly consensus, a complete reconstruction of an ancient technique, or generated astrological advice.

What is not implemented?

Whole-sign houses alone do not make a complete Hellenistic astrology engine. Cosmic Ephemeris does not currently calculate or interpret the broader systems commonly required for a dedicated Hellenistic product.

  • Annual profections, zodiacal releasing, or other time-lord procedures
  • Bounds or terms, triplicity rulers, decans, or complete traditional dignity logic
  • Primary directions or a complete historically specified timing system
  • Traditional condition scoring, house-overlay scoring, or prose delineations
  • A historically authoritative orb model or applying/separating aspect state

Appropriate product uses

These endpoints can supply calculation geometry for a product whose authors independently implement and document their own Hellenistic rules. Suitable uses include:

  • Whole-sign chart wheels and accessible chart tables
  • Educational interfaces that explain which values come from the API and which come from editorial rules
  • Research prototypes that compare an explicitly documented interpretation model with raw chart data
  • Custom engines where broader lots, dignities, time lords, and textual delineation remain application-owned

Cosmic Ephemeris does not establish whether an interpretation is historically correct. Products should cite their sources and identify their chosen school, definitions, and exceptions.

Shared calculation boundaries

Zodiac
Tropical by default
House choices
Whole Sign or Equal on the core chart route; the separate Houses route offers 25 explicit choices
Date range
1800-01-01 through 2200-12-31

Houses use date-dependent true obliquity. Legacy chart lunar nodes use a mean-node polynomial, and their true field is not a distinct true-node calculation. The separate lunar-nodes supported provides a distinct osculating model. See the methodology page for the complete boundary.