# Space Objects

Asteroids, comets, close approaches, fireballs and impact-risk lookups from NASA JPL, plus asteroid size, orbit and impact-scale calculators.

## How to pay

Machine-payable over x402. USDC on: Base (eip155:8453), Solana (solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp), Polygon (eip155:137), Arbitrum One (eip155:42161).
No accounts. No API keys. No signup. The paying wallet is the account.

## Machine-readable

- OpenAPI: https://space-objects.x402tookit.com/openapi.json
- x402 manifest: https://space-objects.x402tookit.com/.well-known/x402
- Catalog (free): https://space-objects.x402tookit.com/catalog
- Health (free): https://space-objects.x402tookit.com/health
- Uptime (free): https://space-objects.x402tookit.com/uptime

## Endpoints (10)

### GET /asteroid-size — $0.02
Asteroid diameter from absolute magnitude H and albedo (or a dark-to-bright range), plus optional impact energy in megatons.
Params: H: number, albedo?: number, velocityKmS?: number, densityKgM3?: number
Example: https://space-objects.x402tookit.com/asteroid-size?H=19.09&albedo=0.35&velocityKmS=20

### GET /body-approaches — $0.02
Past and future Earth close approaches of one asteroid or comet by designation, for example Apophis in 2029.
Params: designation: string, from?: string, to?: string, maxDistanceLD?: number, limit?: integer
Example: https://space-objects.x402tookit.com/body-approaches?designation=99942&from=2025-01-01&to=2035-12-31&maxDistanceLD=20

### GET /close-approaches — $0.02
Asteroids and comets passing Earth within a lunar-distance limit in the next or last N days: distance, speed, size range.
Params: direction?: string, days?: integer, maxDistanceLD?: number, orderBy?: string, limit?: integer
Example: https://space-objects.x402tookit.com/close-approaches?direction=upcoming&days=30&maxDistanceLD=10&limit=10

### GET /fireballs — $0.02
Recorded fireball (bolide) events from US sensors: time, place, altitude, speed and impact energy in kilotons, newest first.
Params: limit?: integer, dateMin?: string, dateMax?: string, minImpactKt?: number
Example: https://space-objects.x402tookit.com/fireballs?limit=10&dateMin=2013-02-01&dateMax=2013-02-28

### GET /impact-risk-object — $0.02
Is this asteroid on the JPL Sentry impact-risk list? Probability, Palermo and Torino levels, size and likeliest impact dates.
Params: designation: string
Example: https://space-objects.x402tookit.com/impact-risk-object?designation=101955

### GET /impact-risk-table — $0.02
JPL Sentry impact-monitoring objects above a Palermo-scale threshold: probability, Torino level, size and impact years.
Params: minPalermo?: number, maxH?: number, limit?: integer
Example: https://space-objects.x402tookit.com/impact-risk-table?minPalermo=-3&maxH=24&limit=10

### GET /impact-scales — $0.02
Torino scale levels explained, or the Palermo scale value from impact probability, energy in megatons and years until impact.
Params: torino?: integer, probability?: number, energyMt?: number, yearsUntil?: number
Example: https://space-objects.x402tookit.com/impact-scales?probability=0.0005&energyMt=1400&yearsUntil=160

### GET /orbital-period — $0.02
Orbital period from semi-major axis via Kepler's third law, with perihelion, aphelion and speeds when eccentricity is given.
Params: semiMajorAxisAu: number, eccentricity?: number, centralMassSolar?: number
Example: https://space-objects.x402tookit.com/orbital-period?semiMajorAxisAu=1.458&eccentricity=0.223

### GET /small-body — $0.02
Asteroid or comet by name or designation: orbit class, NEO/hazardous flags, size, orbit elements, MOID and discovery.
Params: name: string
Example: https://space-objects.x402tookit.com/small-body?name=99942

### GET /space-distance — $0.02
Convert a distance between km, miles, astronomical units and lunar distances, with light travel time.
Params: value: number, unit: string
Example: https://space-objects.x402tookit.com/space-distance?value=0.0025&unit=au

## Terms

Small-body data comes from NASA JPL Solar System Dynamics public APIs and local computation, provided as is. Orbits are fitted to observations and change as objects are tracked; diameters from absolute magnitude are rough estimates; impact probabilities are model outputs that usually fall to zero with more data. Not an official planetary-defence notice and not advice for safety-critical decisions.