API

Public Ephemeris API

Authoritative UTC timestamps for lunar and planetary events. All values computed via Meeus algorithms and yearly verified against AstroPixels (Espenak) tables — flagged discrepancies tracked in our open verification log.

Endpoints

GET/api/public/lunar/events

Lunar phase events (new, first quarter, full, last quarter, plus computed eighth-phases).

Params: type, from, to, limit

/api/public/lunar/events?type=new&limit=12

GET/api/public/lunar/apsides

Lunar apogee and perigee with Earth–Moon distance in km.

Params: type, from, to, limit

/api/public/lunar/apsides?type=perigee&limit=12

Tiers

Free

—

1,000/mo · Lunar events + apsides

Tier 1

Coming soon

100,000/mo · + Planetary apsides, eclipses

Tier 2

Coming soon

1M/mo · + Galactic, exoplanet catalogs

Enterprise

Unlimited · Full ephemeris + custom feeds

All endpoints currently public + rate-limited. API keys, billing, and per-endpoint controls coming with paid tiers.

Source of truth

Computation: Jean Meeus, Astronomical Algorithms 2nd ed. (Ch. 49–50). Phase precision typically <2 minutes vs Espenak; apsides <5 minutes & <50 km.

Verification: Yearly cron compares every value to the AstroPixels (Espenak) tables. Discrepancies above 60 s are flagged in ephemeris_verification_log for review. AstroPixels is treated as the authoritative reference.

Coverage: 1900–2100 lunar phases & apsides, expanding to multi-century planetary apsides next.

Quick start

# Next 12 new moons
curl "https://timecore-utg.lovable.app/api/public/lunar/events?type=new&limit=12"

# Next perigee
curl "https://timecore-utg.lovable.app/api/public/lunar/apsides?type=perigee&limit=1"

# Full moons in 2026
curl "https://timecore-utg.lovable.app/api/public/lunar/events?type=full&from=2026-01-01&to=2026-12-31"