Astro Agents

Research-grade astronomical data & computation API — NASA/JPL DE440 ephemerides for any date, past, present or future, reproducible and SHA-256 verifiable.

Get a free key: email only, no card Try it in the browserSee pricing
Free$0 / month
1,000 calls / month
Indie$19 / month
100,000 calls / month
Pro$79 / month
500,000 calls / month
Scale$299 / month
2,000,000 calls / month

Plans are paid by card. Free needs only an email. Details and what each plan includes: pricing.

Try it

Sunrise, sunset and twilight in New York on 21 December 2026. Paste the request in a terminal: no key needed for your first call.

curl -X POST https://astro-agent.dev/v1/astronomy/rise-set \
  -H 'Content-Type: application/json' \
  -d '{"date": "2026-12-21", "latitude": 40.7128, "longitude": -74.006}'
{
  "endpoint": "astronomy/rise-set",
  "result": {
    "subject": {
      "timezone": "America/New_York",
      "date": "2026-12-21"
    },
    "sun": {
      "sunrise": {
        "utc": "2026-12-21T12:16:35Z",
        "local": "2026-12-21T07:16:35-05:00",
        "timestamp": 1797855395,
        "azimuth": 120.82
      },
      "solar_noon": {
        "utc": "2026-12-21T16:54:11Z",
        "local": "2026-12-21T11:54:11-05:00",
        "timestamp": 1797872051,
        "altitude": 25.85
      },
      "sunset": {
        "utc": "2026-12-21T21:31:48Z",
        "local": "2026-12-21T16:31:48-05:00",
        "timestamp": 1797888708,
        "azimuth": 239.18
      },
      "civil_dusk": {
        "utc": "2026-12-21T22:02:48Z",
        "local": "2026-12-21T17:02:48-05:00",
        "timestamp": 1797890568
      },
      "day_length_minutes": 555.2
    }
  },
  "meta": {
    "ephemeris": "NASA/JPL DE440 (1800-01-01..2200-01-01)",
    "result_sha256": "9952407e5fd4554cec0fbd237188eb1ef76e1bfaec40c3464844d6c5086fc414"
  }
}

Right: an excerpt of the real response to this request (times to the second, in UTC and local time; the full response also lists the Moon and the planets). The same request always returns the same result_sha256.

What you can build

A photography app: when is the light good tonight?

San Francisco, 21 June 2026 · POST /v1/astronomy/rise-set

Sunset 20:35, evening golden hour 19:55-20:54, civil dusk 21:06 (local time, America/Los_Angeles).

Request {"date": "2026-06-21", "latitude": 37.7749, "longitude": -122.4194}
result_sha256 c8d49c7a3abf5cc2...

An astronomy club: which planets can we observe tonight?

London, night of 12 December 2026 · POST /v1/astronomy/visibility

Venus highest at 07:16 (24 deg); Mars highest at 05:08 (50 deg); Jupiter highest at 04:32 (52 deg); Saturn highest at 19:08 (39 deg) (local time).

Request {"date": "2026-12-12", "latitude": 51.5074, "longitude": -0.1278}
result_sha256 8fc6375d699589d5...

An eclipse planner: what will we see from here?

Luxor, Egypt, August 2027 · POST /v1/astronomy/eclipse-local

The total solar eclipse of 2 August is total here: magnitude 1.035, maximum at 13:05 local time with the Sun 81.8 deg above the horizon, 6 min 20 s of totality.

Request {"start": "2027-08-01", "end": "2027-08-31", "latitude": 25.6872, "longitude": 32.6396}
result_sha256 4025fd5c69649f1e...

Why Astro Agents

Trust and accuracy

Breadth

For agents and developers

Access

Astro Agents — a research-grade, verifiable astronomical data and computation API for developers, researchers and astronomy, calendar, observation and data applications. From the NASA/JPL DE440 ephemeris: sunrise, sunset and twilight, altitude and azimuth, observation windows, the Moon's phase and distance, the day's sky for a place, planetary positions (geocentric & heliocentric, ecliptic & equatorial), angular separations, longitude time series, eclipses with local circumstances, planetary phenomena, seasons, time scales and coordinate conversion, and a to-the-minute celestial event calendar (solar and lunar eclipses, stations, lunations), 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. A free key with an email, plans by card, or, for software agents, prepaid credits or pay per call in USDC (x402, MPP). Data only — no predictions, never a signal or forecast.

Astronomy endpoints

POST /v1/astronomy/positionsPlanetary positions for any date (ephemeris)$0.01Ecliptic longitude and latitude, daily speed, retrograde flag and distance of the Sun, the Moon, Mercury..Pluto and the lunar nodes, for any moment 1800-2200.
POST /v1/astronomy/skyThe sky now: positions, Moon phase, next events$0.01The sky at a moment: planetary positions, which planets are retrograde, the Moon's phase and illumination, and the exact times of the next stations, lunations and separations.
POST /v1/astronomy/rise-setRise, set and twilight times for a place$0.01Rise, transit and set of the Sun, Moon and planets for a place and local day, with civil, nautical and astronomical twilight, day length, golden hour and blue hour.
POST /v1/astronomy/altazAltitude and azimuth of every body from a place$0.01Where the Sun, Moon and planets are in the sky from a place at a moment: altitude, azimuth, compass point, topocentric right ascension and declination, distance, elongation, illumination and magnitude.
POST /v1/astronomy/visibilityObservation windows for a night$0.02When each planet and the Moon can be observed from a place during a night: windows above a minimum altitude while the sky is dark, with the best time, altitude, azimuth and magnitude.
POST /v1/astronomy/moonMoon phase, illumination, distance and next phases$0.01The Moon at a moment: phase name and angle, illuminated fraction, age, lunation number, distance and apparent size, the next new, first quarter, full and last quarter Moons, and the next perigee and apogee.
POST /v1/astronomy/dayAstronomical summary of the day for a place$0.02One call for a day at a place: sunrise, sunset, twilight, day length, golden and blue hour; the Moon's phase, illumination, rise and set; the planets observable that night; the next lunations, planetary stations and eclipse.
POST /v1/astronomy/seasonsEquinoxes, solstices, perihelion and day length over a year$0.01The year's equinoxes and solstices and Earth's perihelion and aphelion to the second; optionally the Sun day by day: sunrise, sunset, day length, solar noon, declination and equation of time.
POST /v1/astronomy/timeJulian day, sidereal time, Delta T and time scales$0.01One moment in every astronomical time scale: UTC, unix time, Julian day (UTC, UT1, TT, TDB), MJD, Julian centuries, Delta T, TAI-UTC, UT1-UTC, Greenwich and local mean and apparent sidereal time.
POST /v1/astronomy/convertCoordinate conversion between sky frames$0.01Convert one direction on the sky between equatorial (J2000 and of date), ecliptic (J2000 and of date), galactic and, with a moment and a place, horizontal coordinates.
POST /v1/astronomy/phenomenaPlanetary phenomena: oppositions, conjunctions, elongations$0.10Every conjunction with the Sun (inferior / superior for Mercury and Venus), opposition, greatest elongation, conjunction between two planets, perihelion and aphelion between two dates, to the second.
POST /v1/astronomy/eclipse-localLocal circumstances of solar and lunar eclipses$0.10For a place: every solar and lunar eclipse between two dates with its local circumstances: whether and how it is seen, contact times, magnitude, obscuration, duration and the Sun's or Moon's altitude.
POST /v1/astronomy/solunarSolunar periods: lunar transits, moonrise and moonset$0.01The day's solunar periods for a place: major periods centred on the Moon's upper and lower meridian transits, minor periods centred on moonrise and moonset, with the Moon's phase.
POST /v1/astronomy/anglesAngular separations between bodies$0.02Pairs of bodies whose ecliptic separation is within a tolerance of 0, 60, 90, 120 or 180 degrees (or any angle you choose), with the deviation; optionally equal and opposite declinations.
POST /v1/astronomy/eventsCelestial event calendar (eclipses, stations, lunations)$0.25Solar and lunar eclipses, planetary stations, lunations, separations, longitude crossings and declination events between two dates (1800-2200), to the minute.
POST /v1/astronomy/longitude-seriesPlanetary longitude series (geocentric + heliocentric)$0.20Ecliptic longitudes of the planets at one moment or as a time series (1 hour to 1 week steps), geocentric and heliocentric, with optional angle offsets, multi-body averages and declinations.
POST /v1/astronomy/sky-analoguesSky similarity search (matching skies)$0.25The past or future dates whose planetary positions best match a reference sky, ranked by a stated angular distance.
POST /v1/astronomy/local-timeLocal time resolver (historical time zones)$0.01Local time + place -> exact UT, historical UTC offset, Delta T, Local Mean Time, true solar time.

How to pay

Every visitor also gets 1 free call on the $0.01-0.02 routes, without a key. Pricing.

New in 1.10.0 (2026-11-19)

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"])

Prepaid credits: packs

For software agents: pay once in USDC, then spend call by call with a token. 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 longitude-series calls, or 40 event-calendar years, or 1000 planetary-position calls
Survey$50.0060+20%300 longitude-series calls, or 240 event-calendar years, or 6000 planetary-position calls
Observatory$200.00260+30%1300 longitude-series calls, or 1040 event-calendar years, or 26000 planetary-position calls
Autopilot$1000.001400+40%7000 longitude-series 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