Astro Agents
Research-grade astronomical data & computation API — NASA/JPL DE440 ephemerides for any date, past, present or future, reproducible and SHA-256 verifiable.
Pricing · Time series & events · vs Swiss Ephemeris or DIY · Accuracy benchmark · Catalog · Docs
Astro Agents — a research-grade, verifiable astronomical data and computation API for developers, researchers and astronomy, calendar, observation and data applications. Ephemerides from the real NASA/JPL DE440: planetary positions (geocentric & heliocentric, ecliptic & equatorial: right ascension and declination), speeds and retrograde motion, Moon phase and illumination, angular separations between bodies (aspects, declination parallels), longitude time series, and a to-the-minute celestial event calendar (solar and lunar eclipses, stations, ingresses, lunations, out-of-bounds), 1800-2200. Any date — past, present or future — reproducible: no LLM, historical time zones resolved for you, every result SHA-256 hashed and checkable, accuracy benchmarked against NASA/JPL Horizons. Pay per call over REST or natively in MCP with x402 (USDC on Base or Solana) or MPP: zero setup, no account; or with prepaid credits or a monthly plan. Data only — no predictions, never a signal or forecast.
- NASA/JPL DE440: The reference planetary ephemeris, read through Skyfield: apparent geocentric positions, true equinox of date, IAU 2006/2000A.
- Any date: past, present, future: Every date from 1800 to 2200, events to the minute; historical time zones and daylight saving resolved from the coordinates. The same request always returns the same bytes.
- SHA-256 on every result: meta.input_sha256 and meta.result_sha256 on every response; POST /v1/verify (free) recomputes them, so a result can be cached, cited and checked.
- Benchmarked against Horizons: Positions compared with NASA/JPL Horizons over 1800-2200, method and every value published at /benchmark.md.
Astronomy endpoints
POST /v1/western/positions | Planetary positions for any date (ephemeris) | $0.01 | Planetary positions for any date and time (ephemeris): tropical or sidereal longitude, latitude, speed and retrograde flag of the Sun, Moon, Mercury..Pluto, nodes and Lilith. |
POST /v1/western/sky | Sky today: retrogrades, Moon phase, next events | $0.01 | The sky today (no location needed): planet positions, retrogrades and Moon phase now, plus the exact UTC times of the next ingresses, stations (Mercury retrograde), new and full moons and aspects. |
POST /v1/western/aspects | Angles between bodies (aspects, parallels) | $0.02 | Aspects (with orb, exactness, applying/separating) for a moment, or for any longitudes you supply. |
POST /v1/finance/events | Celestial event calendar (eclipses, stations, ingresses) | $0.25 | Eclipse and Mercury retrograde calendar: every solar and lunar eclipse, station (retrograde/direct), ingress, new and full moon, aspect, parallel and out-of-bounds between two dates (1800-2200), to the minute. |
POST /v1/finance/planetary-lines | Planetary longitude series (geocentric + heliocentric) | $0.20 | Planetary longitudes (geocentric and heliocentric) at a moment or as a longitude time series at chosen intervals, with angular offsets and multi-body averages. |
POST /v1/finance/analogues | Sky similarity search (matching skies) | $0.25 | Find the past or future dates whose planetary positions best match a reference sky, ranked by a stated angular distance. |
POST /v1/time/resolve | Local time resolver (historical time zones) | $0.01 | Local time + place -> exact UT, historical UTC offset, Delta T, Local Mean Time, true solar time. |
Pay per call with x402 (USDC on Base or Solana) or MPP (Tempo: OUSD or USDC.e). No account, no API key. 1 free call per client on the $0.01-0.02 routes, over REST, MCP or A2A; every other route is always paid. Monthly plans by card: pricing.
New in 1.9.0 (2026-11-05)
- Celestial event calendar (
POST /v1/finance/events): Solar and lunar eclipses, retrograde/direct stations, sign ingresses, lunations, angular aspects, declination parallels and out-of-bounds crossings between two dates, 1800-2200, each to the UTC minute with a unix timestamp and a stable key. - Heliocentric and equatorial positions (
POST /v1/western/positions): options.perspective = heliocentric, options.coordinates = equatorial (right ascension, declination, out-of-bounds). Defaults unchanged. - Declination parallels (
POST /v1/western/aspects): options.declination: parallels and contra-parallels with orb and applying/separating. - Planetary longitude series (
POST /v1/finance/planetary-lines): Geocentric and heliocentric planet longitudes in one call, snapshot or series (1h..1w, up to 1,000 samples), with speeds, retrograde flags and declinations. - Sky similarity search (matching skies) (
POST /v1/finance/analogues): The past or future dates whose planetary positions best match a reference sky (a moment, 'now' or your own positions), ranked by a stated circular angular distance over longitudes, aspects, declinations and retrograde flags; the metric is in every response. Data only. - Sky now (
POST /v1/western/sky): Positions, retrogrades and the Moon's phase and illumination now, and the exact times of the next ingresses, stations, lunations and aspects. - Accuracy verified against NASA/JPL Horizons (
GET /v1/benchmark): 12,400 comparisons, 1800-2199: positions 0.0005" mean / 0.024" max (ICRF); longitude as served 0.048" mean over 1962-2026. Details
Try it
curl -X POST https://astro-agent.dev/v1/western/positions -H 'Content-Type: application/json' \
-d '{"datetime":"2026-11-17T12:00:00Z","options":{"coordinates":"equatorial"}}'
Why trust the numbers
- Positions from NASA/JPL DE440 (NASA/JPL), 1800-01-01..2200-01-01, via Skyfield: geocentric apparent, true equinox of date, IAU 2006/2000A.
- Historical time zones resolved for you (IANA tz database, DST of the era, Local Mean Time); ambiguous or non-existent local times are flagged, never guessed.
- Deterministic, no LLM: same input -> same bytes. Every response carries meta.input_sha256 and meta.result_sha256 (also as X-Input-SHA256 / X-Result-SHA256 headers); POST /v1/verify recomputes one.
- Every convention is in the response: frame, equinox, perspective (geocentric or heliocentric), coordinates (ecliptic or equatorial), orbs and zodiac.
- Accuracy vs NASA/JPL Horizons (12,400 comparisons, 1800-2199): positions within 0.024" (ICRF); ecliptic longitudes as served within 0.062" over 1962-2026. Method and every number: https://astro-agent.dev/benchmark.md
Python client
The official client returns pandas DataFrames: pip install "astro-agents @ git+https://github.com/aidatatools-dev/astro-agents-clients#subdirectory=python"
(docs, examples).
from astro_agents import Client
client = Client() # ASTRO_CREDITS_TOKEN, or 1 free call on the $0.01-0.02 routes
events = client.events("2020-01-01", "2024-12-31", include=["eclipse", "station"])
lines = client.planetary_lines(start="2024-01-01", end="2024-12-31", bodies=["jupiter", "saturn"])
Prepaid credits: packs
Pay once with x402 or MPP, then spend call by call with a token, no signature per call. 1 credit = $1 (USDC);
credits never expire and pay for every paid route. POST /v1/credits/topup {"pack": "probe"}.
| Pack | You pay | Credits | Bonus | Worth |
|---|---|---|---|---|
| Probe | $10.00 | 10 | +0% | 50 planetary-lines calls, or 40 event-calendar years, or 1000 planetary-position calls |
| Survey | $50.00 | 60 | +20% | 300 planetary-lines calls, or 240 event-calendar years, or 6000 planetary-position calls |
| Observatory | $200.00 | 260 | +30% | 1300 planetary-lines calls, or 1040 event-calendar years, or 26000 planetary-position calls |
| Autopilot | $1000.00 | 1400 | +40% | 7000 planetary-lines calls, or 5600 event-calendar years, or 140000 planetary-position calls |
Data only: no predictions, never a signal or forecast.
For agents
- /v1/catalog - free, live prices, schemas, examples
- Python client -
pip install "astro-agents @ git+https://github.com/aidatatools-dev/astro-agents-clients#subdirectory=python" - llms.txt / llms-full.txt / openapi.json
- MCP:
https://astro-agent.dev/mcp- A2A: agent card - x402 discovery - Accuracy benchmark vs NASA/JPL Horizons - /v1/benchmark
Listed on
- Smithery - Glama - MCP Registry
- x402scan - MPPScan