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.

Astronomy endpoints

POST /v1/western/positionsPlanetary positions for any date (ephemeris)$0.01Planetary 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/skySky today: retrogrades, Moon phase, next events$0.01The 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/aspectsAngles between bodies (aspects, parallels)$0.02Aspects (with orb, exactness, applying/separating) for a moment, or for any longitudes you supply.
POST /v1/finance/eventsCelestial event calendar (eclipses, stations, ingresses)$0.25Eclipse 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-linesPlanetary longitude series (geocentric + heliocentric)$0.20Planetary 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/analoguesSky similarity search (matching skies)$0.25Find the past or future dates whose planetary positions best match a reference sky, ranked by a stated angular distance.
POST /v1/time/resolveLocal time resolver (historical time zones)$0.01Local 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)

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

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"}.

PackYou payCreditsBonusWorth
Probe$10.0010+0%50 planetary-lines calls, or 40 event-calendar years, or 1000 planetary-position calls
Survey$50.0060+20%300 planetary-lines calls, or 240 event-calendar years, or 6000 planetary-position calls
Observatory$200.00260+30%1300 planetary-lines calls, or 1040 event-calendar years, or 26000 planetary-position calls
Autopilot$1000.001400+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

Listed on

Support · Privacy · Terms · aidatatools@proton.me