ChronOS ephemeris and astrology APIOne instant.
One verifiable sky.

Positions, charts, events and planetary time for any UTC instant from 1600 to 2200. Every result carries its declared precision and the engine and dataset that produced it.

The whole sky in one call.

Send one UTC instant. ChronOS answers for every body you ask for with position, motion, frame, quality and declared precision, labelled with the engine version and dataset SHA that computed it.

years of coverage, 1600 to 2200
600
bodies and points
28
house systems
14
event types
26
fixed stars with proper motion
96

Thirty degrees is one sign. Charts start here.

Natal charts, transits, synastry, composite and Davison charts, progressions, directions and returns are typed calculations in one contract.

Natal and current charts
/v2/charts/calculate
Transits and timelines
/v2/timeline
Synastry and composite
synastry · composite · davison
Progressions and directions
4 axis methods
Returns and revolutions
within a 0.5 s bracket
Saved profiles
versioned profiles
The first 30 degrees of ecliptic longitude, the sign Aries, divided into degrees and three decans.0°10°20°30°IIIIII
Ecliptic longitude 0° to 30°: Aries, with its three decans.

Ten degrees is a decan. Traditional layers start here.

Planetary hours, decans, lunar mansions and nakshatras sit above the measured longitude, each under its named convention.

Four rings over the same circle of longitude: 24 planetary hours, 12 signs, 36 decans and 28 lunar mansions.
  1. Planetary hoursavailable via API

    Twelve unequal hours by day, twelve by night.

    sunrise to sunrise · DST tested
  2. Decansavailable via API

    Three decans per sign, each with a sub-ruler.

    /decans · longitude first
  3. Lunar mansions and nakshatrasavailable via API

    Lunar divisions with an explicit reference.

    /v2/lunar-sectors/calculate
  4. Combination textsinterpretive layer

    A reading should show how it was composed.

    measured state · explicit rules · attributed language

The Sun moves about one degree a day. ChronOS finds the events inside it.

Ingresses, stations, exact aspects, phases, eclipses and horizon events come back as typed records in one query.

Event search
/v2/events/search
Global and personal timelines
/v2/timeline
Retrogrades and stations
station · speed_extremum
Moon, void of course, eclipses
moon_phase · void_of_course
Planetary hours and days
planetary_hour · planetary_day
Webhooks and live streams
webhook · SSE · WebSocket
One degree of ecliptic longitude divided into sixty arcminutes, with the mean Sun’s position in today’s crossing.0′10′20′30′40′50′60′

Mean solar motion is 0°59′08″ a day. The disc marks where the mean Sun stands in today’s degree, at the current UTC time.

One arcminute

One arcminute is about the finest detail an unaided eye can separate. At this scale the turning Earth carries a star across the whole field in four seconds. Past this line, only instruments can tell positions apart.

A one-arcminute field of view with a crosshair, divided in ten-arcsecond steps.+20″−20″
A star on the celestial equator crossing a one-arcminute field at the sidereal rate.

Each error, drawn to scale against its budget.

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.

RAMC and ascendant with DUT1
under 0.5″
fixed stars against Swiss Ephemeris
within 2″
adversarial validation epochs
2,050
Lunar error budget drawn to scaleA 2 arcsecond budget ring around a filled disc of 0.54 arcseconds, the largest difference against INPOP21a, and a 0.45 arcsecond ring, the largest difference against DE440.1″2″budget 2″INPOP21a 0.54″DE440 0.45″
The Moon, the fastest-moving body and the hardest to model, drawn at one scale. The outer ring is the declared 2″ budget; the filled disc is the largest difference observed against INPOP21a, the inner ring the largest against DE440.
Largest measured difference against each declared error budget, in arcseconds
BodyReferenceMeasuredBudgetShare of budget
SunDE440, max0.20″5″
MoonDE4400.45″2″
MoonINPOP21a0.54″2″
Mercury to Saturnmax2.45″10″

Below one microarcsecond.

Greenwich apparent sidereal time agrees with the ERFA reference routines to better than one microarcsecond, roughly the width of a hair seen from 20,000 kilometres away.

One continuous chain of models

  1. VSOP87 planets
  2. Chebyshev Moon
  3. IAU 2006/2000A precession and nutation
  4. ERA-based sidereal time
  5. embedded Earth-orientation data

Every model names its data and standard: VSOP87 and IMCCE, JPL, IERS, ERFA, Hipparcos.

Back to 360°

The response records how it was computed.

Pin a profile, keep the provenance, and any result can be reproduced and audited later.

/ephemeris/instant
Exact UTC instant with the complete engine metadata envelope
/ephemeris/instant/extended
Uranus through Vesta in the shared v3 contract
/stations
Station times found by root-finding, with sub-minute resolution
/fixed-stars
96 fixed stars with positions and typed event search
/v2/charts/calculate
Typed chart families, 14 house systems, historical time zones
/v2/lunar-sectors/calculate
Nakshatras, padas and named date-aware ayanamshas
/sun · /moon · /horizon
Light, phase and the local horizon

POST /v2/ephemeriscURL

curl --request POST \
  --url https://api.chronos-ephemeris.com/v2/ephemeris \
  --header "Authorization: Bearer $CHRONOS_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "datetime_utc": "2026-07-16T12:00:00Z",
    "bodies": ["sun", "moon", "mercury", "venus", "mars"],
    "profile": "chronos.standard@1"
  }'

Keep keys in server-side secret storage. Your dashboard has runnable examples for the plan you are on.

What comes back with every exact result

epoch
the instant, normalised to explicit time scales
frame
equinox of date or mean J2000, apparent or geometric
engine
the engine release that computed it
dataset
the SHA of the astronomical data it used
algorithm
the model behind each body
coverage
the validated time range
quality
precision or a declared analytic fallback

Same core on the server and on the device.

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.

  1. native iOSprecision

    On-device

    The verified Rust engine runs offline inside compatible iOS products.

  2. HTTPSprecision

    ChronOS API

    The same calculation core for web products, services and mobile backends.

  3. analyticanalytic

    Declared fallback

    If a product falls back to an analytic path, the change in quality stays visible instead of hidden.

Native integrations check engine version, dataset identity and response contract before they accept a precision result.

engine · dataset SHA · contract

Start free. Pay when the product grows.

Monthly plans in euro. Move up whenever you need more requests, projects, chart families or realtime features. Applicable taxes are shown at checkout.

Free is open now. Paid plans open after the final operational and legal checks.

Every plan starts with a private dashboard, usage visibility and secure key management. Self-service plans are for business customers.

Free

€0forever

Evaluate the contract and ship a prototype.

  • 2,500 requests a month
  • One project, two keys
  • Natal charts
  • Default radix SVG
Start free

Developer

€24a month

Build one focused astrology feature.

  • 25,000 requests a month
  • Two projects, five keys
  • Natal, transit and synastry
  • Three webhooks

Controlled launch

Studio

€79a month

Run a complete astrology product.

  • 150,000 requests a month
  • All chart families
  • All render formats
  • Batch and electional search

Controlled launch

Scale

€199a month

Operate high-volume products with live sky state.

  • 3M requests a month
  • 25 projects, 100 keys
  • Realtime SSE and WebSocket
  • Extended analytics

Controlled launch

Understand the calculation, not only the response.

Technical guides to the time systems, coordinate choices and model limits behind the API. Each pairs the method with a runnable request and the evidence to check it.

Build the sky into your product.

Release
July 16, 2026
Engine
4.0.0
Coverage
1600 to 2200
UTC 00:00:00JD 2461000.00000 (now; read the Julian Day guide)