Astro Agents
Astro Agents — a research-grade, verifiable astronomical data and computation API for developers, researchers and astronomy, calendar, observation and data…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
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.
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.
Official Python client: pip install "astro-agents @ git+https://github.com/aidatatools-dev/astro-agents-clients#subdirectory=python" (https://github.com/aidatatools-dev/astro-agents-clients/tree/main/python#readme).
- 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
Endpoints 13
astronomy
- POSTLocal time resolver (historical time zones) ($0.01)
/v1/time/resolveLocal time + place -> exact UT, historical UTC offset, Delta T, Local Mean Time, true solar time. The step LLMs most often get wrong. Resolves the IANA time… - POSTPlanetary positions for any date (ephemeris) ($0.01)
/v1/western/positionsPlanetary positions for any date and time (ephemeris): tropical or sidereal longitude, latitude, speed and retrograde flag of the Sun, Moon, Mercury..Pluto,… - POSTSky today: retrogrades, Moon phase, next events ($0.01)
/v1/western/skyThe sky today (no location needed): planet positions, retrogrades and Moon phase now, plus the exact UTC times of the next ingresses, stations (Mercury… - POSTAngles between bodies (aspects, parallels) ($0.02)
/v1/western/aspectsAspects (with orb, exactness, applying/separating) for a moment, or for any longitudes you supply. Either give a moment (datetime, optional place) and get the… - POSTPlanetary longitude series (geocentric + heliocentric) ($0.20)
/v1/finance/planetary-linesPlanetary longitudes (geocentric and heliocentric) at a moment or as a longitude time series at chosen intervals, with angular offsets and multi-body… - POSTCelestial event calendar (eclipses, stations, ingresses) ($0.25)
/v1/finance/eventsEclipse and Mercury retrograde calendar: every solar and lunar eclipse, station (retrograde/direct), ingress, new and full moon, aspect, parallel and… - POSTSky similarity search (matching skies) ($0.25)
/v1/finance/analoguesFind the past or future dates whose planetary positions best match a reference sky, ranked by a stated angular distance. Matching skies by geometry, data…
reference
- POSTSky configuration at a datetime & location (positional snapshot) ($0.06)
/v1/western/natalThe sky at a date, time and place: planets in the ecliptic signs and in houses, ascendant, MC, 11 house systems, aspects, summary. A positional snapshot,… - POSTTransits ($0.08)
/v1/western/transitsAngles from the sky at a moment to a reference sky configuration, and exact hit times over up to a year. 'transit': aspects from the sky at a moment to every… - POSTPairwise angular geometry between two sky states ($0.12)
/v1/western/synastryTwo sky configurations compared: cross-aspects, house overlays both ways, composite midpoints. Two sky configurations (datetime & location each) compared:…
free
- GETCatalog: every endpoint, price, schema, example (free)
/v1/catalog - GETLiveness, versions, live payment status (free)
/v1/health - POSTRecompute the SHA-256 of a result (free)
/v1/verify
API details
- Base URL
https://astro-agent.dev- Authentication
- An API key in the X-Credits-Token header
- Operations
- 13 operations on 13 pathsPOST 11GET 2
- Main resources
- astronomy 7free 3reference 3
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.9.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Astro Agent's published OpenAPI description
How to test the Astro Agents in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Astro Agents collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-Credits-Token header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Local time resolver (historical time zones) ($0.01)” (POST /v1/time/resolve), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Astro Agents?
Astro Agents — a research-grade, verifiable astronomical data and computation API for developers, researchers and astronomy, calendar, observation and data… It is listed under Media & content and has 13 endpoints.
Who publishes the Astro Agents?
It is listed from Astro Agent's public API description (an OpenAPI document), not published by Astro Agent on Swastik Codes. Anyone who controls astro-agent.dev can claim the profile by adding a DNS TXT record.
What is the base URL of the Astro Agents?
Requests go to https://astro-agent.dev. Endpoint paths are added to this base URL.
How do I authenticate with the Astro Agents?
With an API key in the X-Credits-Token header.
How many endpoints does the Astro Agents have?
13 operations on 13 paths (11 POST, 2 GET). The largest groups are astronomy, free, reference.
Is forking the Astro Agents free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.