# NASA JPL Near-Earth Close Approach Data

> NASA JPL Near-Earth Close Approach Data is a paid API for AI agents from 2s.io, paid per call via x402, $0.00144/call, status unknown (last checked 2026-09-13).

Lists near-Earth asteroids and comets making close approaches to Earth within a specified date window and maximum distance, using NASA JPL data.

## Facts

- Endpoint: GET https://2s.io/api/space/close-approaches
- Price: $0.00144/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/nasa-jpl-near-earth-close-approach-data-b1b58e7a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7sJ52u4CqN6pdYNeAk5IT

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability nasa-jpl-near-earth-close-approach-data-b1b58e7a
```

Example prompt: What asteroids and comets are making close passes by Earth between January 1 and March 31 2025, coming within 0.05 AU? Show me the top 20 nearest ones.

## When to prefer this

Use this endpoint when you need a filtered, date-bounded list of near-Earth object close approaches with distance and velocity data, especially for planetary defense research, amateur astronomy observation planning, or answering 'what's passing by Earth soon' queries. Prefer this over general space body endpoints when you specifically want approach events rather than orbital or physical parameters of a single known object.

## Known failure modes

- Invalid date format (non-YYYY-MM-DD) returns a 400 error
- distMaxAu outside 0.0001–1.0 range returns a validation error
- dateMin after dateMax returns an empty result or error
- limit outside 1–200 range returns a validation error
- No close approaches found in the specified window returns an empty list
- Upstream NASA/JPL data unavailable returns a 503 or timeout

## How this service works

List near-Earth asteroid/comet close approaches to Earth within a date window and maximum distance, from NASA JPL's Close-Approach Data API. Filter by dateMin / dateMax (YYYY-MM-DD) and distMaxAu (max approach distance in AU; default 0.05 AU ≈ 19.5 lunar distances). Each approach: object designation, close-approach date (UTC), nominal + minimum distance in AU and lunar distances, relative velocity (km/s), and absolute magnitude H (a size proxy). Sorted nearest-first. Planetary-defense, observation planning, and "what's passing by this month" queries. Public-domain NASA/JPL data; for full physical/orbital params of a listed object see /api/space/body.

## Output

A list of near-Earth asteroid and comet close-approach events sorted nearest-first, each including the object's designation, UTC close-approach date, nominal and minimum approach distances in both AU and lunar distances, relative velocity in km/s, and absolute magnitude H as a size proxy.

## Example request

```json
{
 "input": {
  "type": "http",
  "method": "GET",
  "queryParams": {
   "limit": 20,
   "dateMax": "2025-03-31",
   "dateMin": "2025-01-01",
   "distMaxAu": 0.05
  }
 }
}
```

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "const": "http"
    },
    "method": {
     "const": "GET"
    },
    "queryParams": {
     "properties": {
      "limit": {
       "type": "integer",
       "default": 50,
       "maximum": 200,
       "minimum": 1
      },
      "dateMax": {
       "type": "string"
      },
      "dateMin": {
       "type": "string"
      },
      "distMaxAu": {
       "type": "number",
       "default": 0.05,
       "maximum": 1,
       "minimum": 0.0001
      }
     }
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/nasa-jpl-near-earth-close-approach-data-b1b58e7a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from 2s.io](https://www.zero.xyz/host/2s.io/llms.txt)