Cycles ArcCycles 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 — every tab calls the real API and shows the JSON it returns. Each panel opens with a recorded response so you can see the exact shape before you even click; if the gateway isn't reachable from where you're viewing, it falls back to that same recorded response.

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
Every endpoint here is live over HTTP — planet/Moon positions on DE441, eclipses from Besselian elements, the star/DSO/constellation catalogs, sunrise/sunset and twilight, and the meteor-shower module. The playground calls the real API.
All verbs

Everything this API does

The playground demos six of these. Every verb below is live on the API today — same date-and-place in, flat JSON out.

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=8&day=12&hour=22
{
  "planet": "Mars",
  "lon": 91.033433,
  "lat": 0.256927,
  "distance_au": 1.945908514,
  "retrograde": 0
}

Flat JSON — the daemon's own fields, nothing wrapped. Ask for body=sun or body=moon with lat/lon and the response also carries declination and alt/az for your place.

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 for any year, plus the central-line ground path for a solar eclipse, computed from Besselian elements. Meteor showers too: /v1/meteor/showers lists active showers for a date with peak ZHR, and /v1/meteor/shower adds radiant altitude and Moon interference for your exact place and time.
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.
Are the playground calls real?+
Yes — each tab calls the live API and renders the JSON it returns. Every panel opens with a genuine recorded response so it's never empty and you can see the exact fields up front; that same recorded response is also the fallback shown if the gateway can't be reached from your network.