OverviewCapabilities
The full capability list.
Chart families, house systems, traditional layers, event types, validation evidence, endpoints and runtime rules, in the order the homepage zooms through them.
30° · Charts
Chart families and house systems
Natal charts, transits, synastry, composite and Davison charts, progressions, directions and returns are typed calculations in one contract.
Natal and current charts
Radix and chart-for-now snapshots with configurable aspects, motion and traditional state.
/v2/charts/calculateTransits and timelines
Orb entry, exact contact, exit and retrograde contact sequences, ordered in time.
/v2/timelineSynastry and composite
Cross-chart aspects, midpoint composite and Davison charts as first-class calculations.
synastry · composite · davisonProgressions and directions
Secondary progressions, true solar arc and Naibod axes in longitude or right ascension.
4 axis methodsReturns and revolutions
Solar, lunar and planetary returns resolved to the exact returned instant.
within a 0.5 s bracketSaved profiles
Versioned calculation profiles keep house systems, aspect rules and coordinates identical across projects.
versioned profiles
House systems 14
- Whole Sign
- Placidus (high-latitude fallback)
- Equal Ascendant
- Equal Midheaven
- Vehlow Equal
- Porphyry
- Koch (high-latitude fallback)
- Regiomontanus
- Campanus
- Alcabitius
- Meridian
- Morinus
- Polich/Page Topocentric (high-latitude fallback)
- Horizontal/Azimuth
Marked systems are undefined at some high latitudes. They return an explicit warning and the documented Whole Sign fallback instead of a silent guess.
10° · Traditional layers
Layers above the longitude
The measured longitude stays underneath. Planetary hours, decans, lunar mansions and nakshatras are layers above it, and every layer names its convention.
Planetary hours
Day and night each become twelve unequal hours, from local sunrise to the next sunrise, carried correctly through daylight-saving changes. The weekday ruler opens the sequence and the Chaldean order continues it.
sunrise to sunrise · DST testedDecans
The decan layer places a body in one of the zodiac’s thirty-six ten-degree faces and adds a tradition-aware sub-ruler, without touching the longitude underneath.
/decans · longitude firstLunar mansions and nakshatras
Twenty-seven nakshatras with padas and boundary events, with date-aware Fagan/Bradley, Lahiri, Raman and Krishnamurti references or an explicit offset. The equal 28-fold Arabic mansions are labelled as a convention, never as historical stellar boundaries.
/v2/lunar-sectors/calculateCombination texts
Hour ruler, decan, mansion, dignity, aspect and lunar phase can join into one reading. Every contributing fact stays inspectable, and authored language stays separate from calculation.
measured state · explicit rules · attributed language
Also in this layer
Fixed stars
A proper-motion catalogue of 96 stars, 15 Behenian, with apparent positions, aspects, orb contacts, rising, setting and both culminations.
96 starsNodes and sensitive points
Mean and true nodes, both Liliths, Earth shadow, antisolar and seasonal points as canonical keys.
28 body and point keysAsteroids and custom orbitswith limits
Chiron, Ceres, Pallas, Juno and Vesta by name. Further objects through bounded custom orbits with an explicit error budget.
limited named catalogue
1° · Events
Events and timelines
Ingresses, stations, exact aspects, phases, eclipses and horizon events come back as typed records in one query. Stations and returns are solved by root-finding rather than read off a sampled table, so station times land with sub-minute resolution.
Event search
Ingresses, stations, aspects, phases, eclipses, seasons, elongations, occultations and horizon events in one query over a custom window.
/v2/events/searchGlobal and personal timelines
Astronomical, astrological, planetary-hour, natal-transit and custom-trigger records share one sortable contract.
/v2/timelineRetrogrades and stations
Stationary windows, exact direction changes, speed extrema and renderable retrograde calendars.
station · speed_extremumMoon, void of course, eclipses
Eight phases, exact principal phases, void-of-course intervals and global eclipse geometry.
moon_phase · void_of_coursePlanetary hours and days
Location-aware unequal hours and day rulers, tested through daylight saving and at polar latitudes.
planetary_hour · planetary_dayWebhooks and live streams
Stable event IDs, webhooks and live streams feed daily digests, notifications and widgets.
webhook · SSE · WebSocket
Every event type in the registry 26
- Sign Ingress
- Station
- Aspect Exact
- Aspect Contacts
- Aspect Orb
- Fixed Star Aspect Exact
- Fixed Star Aspect Orb
- Moon Phase
- Lunar Sector Ingress
- Solar Event
- Planetary Hour
- Planetary Day
- House Ingress
- Season
- Elongation
- Mundane Aspect
- Void Of Course
- Heliacal Rise (available with limits)
- Occultation (available with limits)
- Speed Extremum
- Distance Extremum
- Declination Aspect
- Out Of Bounds
- Eclipse (available with limits)
- Horizon Event
- Fixed Star Horizon Event
Marked types are available with disclosed limits: eclipses give global greatest-eclipse geometry only, occultations are local and topocentric, heliacal rising uses a fixed arcus visionis.
1″ · Precision
Validation and the model chain
ChronOS publishes conservative error budgets and tests itself against independent references: 2,050 adversarial epochs against DE440 through an independent ERFA path, and against INPOP21a.
Greenwich apparent sidereal time agrees with the ERFA reference routines, called through pyerfa, to better than one microarcsecond. That is roughly the width of a hair seen from 20,000 kilometres away.
- RAMC and ascendant with DUT1
- under0.5″
- fixed stars against Swiss Ephemeris
- within2″
- adversarial validation epochs
- 2,050
One continuous chain of models
- VSOP87 planets
- Chebyshev Moon
- IAU 2006/2000A precession and nutation
- ERA-based sidereal time
- embedded Earth-orientation data
Every model names its data and standard: VSOP87 and IMCCE, JPL, IERS, ERFA, Hipparcos.
These are internal validation runs against independent references, not an external certification. Tests prove implemented behaviour and stated fixtures; they do not claim universal parity with any other ephemeris.
Open the Validation CenterAPI
Endpoints and surfaces
Every exact result travels with the epoch, frame, engine version, dataset SHA, algorithm, coverage and quality state that produced it. Pin a profile, keep the provenance, and any result can be reproduced and audited later.
Endpoints
/ephemeris/instantExact UTC instant with the complete engine metadata envelope/ephemeris/instant/extendedUranus through Vesta in the shared v3 contract/stationsStation times found by root-finding, with sub-minute resolution/fixed-stars96 fixed stars with positions and typed event search/v2/charts/calculateTyped chart families, 14 house systems, historical time zones/v2/lunar-sectors/calculateNakshatras, padas and named date-aware ayanamshas/sun · /moon · /horizonLight, phase and the local horizon
Surfaces
Visual studio
Wheels, aspect and declination graphs, calendars, local-space radar, astrocartography and timeline scenes as SVG, PNG, PDF or JSON.
17 visual familiesElectional search
Rule-based windows from events, dignities, houses, planetary hours and void of course, with the scoring evidence attached.
/v2/electional/searchHeliocentric view
Heliocentric positions and a deterministic solar-system scene beside geocentric and topocentric frames.
solar_system_viewAPI and SDK surface
REST, batch, realtime, webhooks, a CLI and SDKs expose the same normalised facts.
OpenAPI · result hashes
Runtime
Runtimes and release rules
Call the hosted API from web products and backends, or run the verified Rust engine offline inside a compatible iOS product. Both return the same result structure.
Native integrations check engine version, dataset identity and response contract before they accept a precision result.
engine · dataset SHA · contractHow it stays exact after release
- Versioned calculationsEngine, datasets and contracts carry explicit versions, so results stay reproducible.
- Verified source dataScientific inputs are archived with checksums and provenance before they enter the pipeline.
- Native and API parityShared fixtures prove that compatible runtimes produce the same normalised state.
- Protected accessProject keys, scopes and usage limits keep each customer integration isolated.
- Continuous data healthCoverage and freshness checks guard time-sensitive Earth-orientation and reference data.