Cycles ArcAstronomy API
The complete sky, one endpoint

Planets, the Moon, eclipses, stars, and meteor showers — computed for your exact place and moment.

Send a date, a place, and what you want to know. Get back positions, phases, rise and set times, eclipse circumstances, and what's visible tonight — planet and Moon positions computed on JPL DE441, the same ephemeris professional observatories use, not a low-order approximation.

JPL DE441
planet & Moon positions, observatory-grade ephemeris
8,870 + 88
catalogued stars, deep-sky objects, and every constellation
One call
single GET, JSON back — no desktop app, no data files
Positions are computed from JPL DE441 Chebyshev ephemerides where covered, with an analytic fallback outside the range — and the response tells you which was used. Stars come from the Hipparcos catalog, deep-sky objects from OpenNGC, constellations from the IAU boundaries.
Playground

Call the real API

Pick a tab, fill in a date and place, hit run. The public astronomy gateway is being wired up now — until it's live, every tab shows a verified-shape sample so you can see exactly what comes back. Live calls switch on the moment the gateway ships.

Proof

Real basis, not adjectives

Every claim here traces to a named ephemeris or catalog, not a marketing estimate.

JPL DE441
planet & Moon positions, with analytic fallback labeled in the response
8,870
stars (Hipparcos), plus OpenNGC deep-sky objects
88
constellations with IAU boundaries
One API
positions, phases, eclipses, catalogs, and showers together
CapabilityCycles Arc Astronomy APITypical astronomy API
Planet & Moon positionsJPL DE441 ephemeris, honestly labeledLow-order analytic approximation
EclipsesSolar & lunar, with local circumstances and ground pathOften not offered, or dates only
CatalogsStars, deep-sky objects, and constellations built inFrequently a separate paid product
Meteor showersActive showers, radiant altitude, and Moon interferenceRarely available
Access modelSingle GET call, JSON responseVaries
Honest status: the compute behind every endpoint here is real and running on the engine today — planet/Moon positions on DE441, eclipses from Besselian elements, the star/DSO/constellation catalogs, sunrise/sunset and twilight. What's still being built is the public astronomy gateway that exposes these over HTTP, plus the brand-new meteor-shower module. Until the gateway ships, the playground shows verified-shape samples rather than live calls, and the meteor-shower response format may still change.
All verbs

Everything this API does

The playground demos six of these. The full astronomy surface below is engine-live today and being wired onto the public gateway — each card is marked accordingly.

How it works

Date and place in — sky data out

01

Send a date, place, and what you want

A body name, a date and hour, and a latitude/longitude — plain query parameters, no payloads.

02

Ephemeris or catalog lookup

Positions come from JPL DE441 (analytic fallback labeled); catalog queries hit the star, deep-sky, and constellation datasets directly.

03

Reduced to your local sky

Coordinates are transformed to altitude and azimuth for your exact place and moment, with rise/set and visibility resolved.

04

Get JSON back

Flat, predictable fields — including which ephemeris was used, so you always know the basis of the number.

Use cases

Who this is for

Stargazing & weather apps

Tell users what's up tonight, when the Moon rises, and when the next eclipse or meteor shower is visible from where they are.

Planetarium & sky-map apps

Drop-in planet positions and star/DSO/constellation data without shipping your own ephemeris or catalog.

Education & museums

Answer "where is Mars", "what phase is the Moon", "when's the next eclipse" for any place and date, on demand.

Astrophotography planners

Combine visibility, Moon interference, and meteor-shower timing to plan a session around real sky conditions.

Docs

Example request

GET /v1/astronomy/position?body=mars&year=2026&month=7&day=27&hour=22&lat=19.4326&lon=-99.1332
{
  "ok": true,
  "fields": {
    "body": "mars",
    "ra_deg": "138.42",
    "dec_deg": "18.63",
    "distance_au": "2.411",
    "alt_deg": "-31.8",
    "az_deg": "302.4",
    "ephemeris": "de441",
    "above_horizon": "0"
  }
}
Pricing

Pay for calls, not seats

Starter
$0 / mo
  • 1,000 calls / month
  • Full ephemeris and catalog access
  • Community support
Get started
Scale
Custom
  • Volume pricing
  • Dedicated throughput
  • Direct engineering support
Talk to us

Ready to read the sky?

No signup required to try the playground above.

Try it live
FAQ

Common questions

How accurate are the planet positions?+
Planet and Moon positions come from JPL DE441 Chebyshev ephemerides — the same source professional observatories use — wherever the date falls inside its coverage. Outside that range the API falls back to an analytic model, and every response includes an ephemeris field telling you which was used, so you're never guessing about the basis of a number.
Do you cover eclipses and meteor showers?+
Eclipses, yes — solar and lunar, with local circumstances and ground paths, computed from Besselian elements. Meteor showers are a new module shipping alongside the public gateway: active showers for a date, radiant altitude for your place, peak ZHR, and Moon interference.
Are the star and deep-sky catalogs included?+
Yes — 8,870 stars from the Hipparcos catalog, deep-sky objects from OpenNGC, and all 88 constellations with IAU boundaries, all searchable by name or by sky position. No separate catalog product to buy.
Is this the same as your astrology API?+
No. This is a straight astronomy API — positions, phases, eclipses, catalogs, and showers, as physics. The astrology API is a separate product with its own site and pricing.
Why do the playground tabs say "Sample"?+
The compute is already running on the engine; the public HTTP gateway that exposes it is being wired up now. Until it's live, each tab shows a verified-shape sample response so you can see the exact fields you'll get. Live calls turn on the moment the gateway ships — no change to your integration.