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.
Tropical natal chart data
Apparent geocentric positions for ten bodies, chart angles, motion fields, aspects, and nodes.
Whole-sign and optional house systems
Whole Sign is documented alongside Equal, 22 current opt-in twelve-house systems—including quadrant systems—and Houses-only Gauquelin sectors.
Aspect geometry
Fixed modern endpoint rules for angular separation and orbs, ready for your own interpretation layer.
Sect-oriented fields Current
The documented supported response can include chart_sect, planet_sect, and planet_nature.
Lots of Fortune and Spirit Current
Natal analysis and natal SVG can add both Lots explicitly, using the documented day/night reversal without automatic interpretation.
Separate timing and search primitives Current
Solar/lunar returns, secondary progressions, and bounded sampled electional search are available as calculation APIs, not a complete Hellenistic timing system.
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.