# Forgemesh Space Asteroid Watch API

> Forgemesh Space Asteroid Watch API is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Returns structured JSON of all known near-Earth objects making close approaches to Earth this week, including size, miss distance, velocity, approach date, and hazard classification.

## Facts

- Endpoint: POST https://x402.forgemesh.io/space-asteroid-watch
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-space-asteroid-watch-api-eb85878b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tzp0JDCTSk5qm96Cf6ZUz

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 forgemesh-space-asteroid-watch-api-eb85878b -d '<json body>'
```

Example prompt: What asteroids are flying past Earth this week? I want to see each one's size estimate, how close it'll get, its speed, and whether it's classified as potentially hazardous.

## When to prefer this

Use this endpoint when you need a ready-made, pre-aggregated weekly snapshot of all near-Earth asteroid close approaches with hazard classifications, rather than querying NASA's NeoWs API directly. Ideal for space-risk dashboards, science content generators, education agents, or novelty feeds that need current asteroid data without building NASA API integration. The 6-hour cache keeps costs low for repeated polling scenarios.

## Known failure modes

- No NEOs in the current weekly window — returns empty array or minimal dataset
- NASA data source temporarily unavailable — stale cache (up to 6 hours old) may be served
- Payment not processed — HTTP 402 returned, endpoint access blocked
- Malformed POST body — may return 400 error if body parsing fails
- Network timeout if upstream NASA API is slow to respond

## How this service works

Asteroid close-approach API: every known near-earth object passing Earth this week — size estimates, closest-approach date and miss distance, velocity, and the potentially-hazardous classification, as structured JSON. Use for space-risk dashboards, science content, education agents, and novelty feeds. Cached 6 hours.

## Output

A structured JSON array of near-Earth objects with close-approach data for the current week, including each object's estimated size range, closest-approach date, miss distance from Earth, relative velocity, and NASA potentially-hazardous object (PHO) classification flag. Response is cached for 6 hours.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "type": "object",
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "element_count": 24,
   "near_earth_objects": {
    "2026-07-15": [
     {
      "name": "(2019 GT3)",
      "is_potentially_hazardous_asteroid": false
     }
    ]
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-space-asteroid-watch-api-eb85878b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)