# Satellite Catalog

CelesTrak satellite search, orbital elements, orbit classification and decay screens.

## 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://satellite-catalog.x402tookit.com/openapi.json
- x402 manifest: https://satellite-catalog.x402tookit.com/.well-known/x402
- Catalog (free): https://satellite-catalog.x402tookit.com/catalog
- Health (free): https://satellite-catalog.x402tookit.com/health
- Uptime (free): https://satellite-catalog.x402tookit.com/uptime

## Endpoints (7)

### GET /decay-risk — $0.03
Screen a CelesTrak group for low-perigee objects (default under 250 km). A heuristic flag, not a re-entry prediction.
Params: group: string, perigee_km?: integer
Example: https://satellite-catalog.x402tookit.com/decay-risk?group=stations&perigee_km=250

### GET /ground-track-period — $0.02
Ground-track westward shift per orbit and repeat-cycle estimate (orbits per days) from an orbital period in minutes.
Params: period_min: number, day?: string, max_days?: integer, tolerance_deg?: number
Example: https://satellite-catalog.x402tookit.com/ground-track-period?period_min=98.88&day=solar&max_days=30&tolerance_deg=0.5

### GET /group-summary — $0.03
Object count, altitude and inclination ranges and orbit-class mix for a CelesTrak group (stations, starlink, gps-ops...).
Params: group: string
Example: https://satellite-catalog.x402tookit.com/group-summary?group=stations

### GET /orbit-class — $0.02
Classify an orbit as LEO, MEO, GEO, HEO or beyond-GEO from altitude, with SSO, GTO and Molniya hints and a period check.
Params: altitude_km: number, eccentricity?: number, inclination_deg?: number, period_min?: number
Example: https://satellite-catalog.x402tookit.com/orbit-class?altitude_km=35786&eccentricity=0&inclination_deg=0.1&period_min=1436

### GET /satellite-compare — $0.03
Compare two satellites by NORAD id side by side: period, altitudes, inclination, node and orbit class.
Params: norad_id_a: string, norad_id_b: string
Example: https://satellite-catalog.x402tookit.com/satellite-compare?norad_id_a=25544&norad_id_b=48274

### GET /satellite-elements — $0.02
Current orbital elements for a NORAD id with computed period, semi-major axis, perigee and apogee altitude.
Params: norad_id: string
Example: https://satellite-catalog.x402tookit.com/satellite-elements?norad_id=25544

### GET /satellite-search — $0.02
Find satellites by name in the CelesTrak catalog: NORAD id, international designator, epoch and orbit class.
Params: name: string, limit?: integer
Example: https://satellite-catalog.x402tookit.com/satellite-search?name=ISS&limit=10

## Terms

Orbital elements are CelesTrak general-perturbations data, provided as is; derived altitudes are mean-element estimates, not tracking data. Decay screens are heuristics, not predictions. No positions or passes are provided. Not for navigation, collision avoidance or operations.