Asteroid Approaches · Data API

Near Earth Asteroid Approaches

Upcoming close approaches of asteroids and comets to Earth, with date, distance and speed.

Computed close-approach events for near-Earth objects from NASA's Jet Propulsion Laboratory, covering the coming year within a defined distance threshold. Each row gives the object designation, approach time, nominal and minimum distance, relative velocity and brightness. Space-sector tools, science media and educational products use it to show what is passing by and when.

Source: NASA JPL Center for Near-Earth Object Studies — Close-Approach Data API · Public Domain (U.S. Government Work) · Data courtesy NASA/JPL-Caltech, Center for Near-Earth Object Studies Close-Approach Data API.

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

  • GET /v1/data/near-earth-asteroid-approaches
  • GET /v1/data/near-earth-asteroid-approaches/search?q=...
  • GET /v1/data/near-earth-asteroid-approaches/{key}

Base path /v1/data/near-earth-asteroid-approaches · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

FieldTypeDescription
designationstrObject primary designation, e.g. 2024 AB1 or 433 Eros
orbit_idstrIdentifier of the orbit solution used for the prediction
close_approach_timestrClose-approach date and time in universal time, as published by the source
julian_datefloatClose-approach time as a Julian date, useful for sorting and maths
distance_aufloatNominal approach distance in astronomical units
distance_min_aufloatMinimum approach distance within the uncertainty range, in astronomical units
distance_max_aufloatMaximum approach distance within the uncertainty range, in astronomical units
relative_velocity_km_sfloatVelocity relative to Earth at approach, kilometres per second
absolute_magnitudefloatAbsolute magnitude, a proxy for object size — smaller numbers mean larger objects

What you get

Rolling window of close approaches for the year ahead
Named columns instead of the source's positional arrays
Distance uncertainty range, not just the nominal value
Relative velocity and brightness on every event
Chronologically sorted for instant 'what is next' answers

FAQ

Are these predictions or observations?
They are computed predictions from current orbit solutions, and they shift slightly as new observations refine an object's orbit.
What is an astronomical unit?
Roughly 150 million kilometres, the average Earth–Sun distance. Most listed approaches are a small fraction of that.
Does a close approach mean an impact risk?
No. Close approach simply means passing within the distance threshold; impact risk is assessed separately.
How often is it refreshed?
We re-ingest daily so the rolling one-year window and any updated orbit solutions stay current.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day
  • 100 API requests per day
  • All endpoints included
  • Community support
Most popular

Pro

$9/month

For production apps and AI agents

10,000 requests/day
  • 10,000 API requests per day
  • All endpoints included
  • Priority support
  • Usage dashboard

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests
  • Unlimited API requests
  • All endpoints included
  • Priority support
  • Usage dashboard
  • Dedicated support channel

Getting Started

Start building in minutes

Register for a free API key, make your first request, and upgrade when you're ready.

1

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'
2

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"
3

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"
4

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"