2s-jwnd2jdga-alleyford.vercel.app · satellites

Search the catalog of every cataloged Earth-orbiting object — ~69,000 satellites, rocket bodies, and debris tracked by US Space Force / 18 SDS (via CelesTrak SATCAT). Filter by name (q, e.g. "starlink"), owner/launching country (owner — code like US/PRC/CIS or a name like "china"), object type (type = payload | rocket body | debris | unknown), launch-year range (launchYearFrom/launchYearTo), international/COSPAR designator prefix (intlDesignator, e.g. "2024-"), on-orbit vs decayed (onOrbit), or exact NORAD number (noradId). Each result carries the NORAD id, name, international designator, object type, owner + resolved country, launch date + site, decay date (null = still in orbit), and orbital parameters (period, inclination, apogee, perigee). The envelope total is the full count matching your filter — so onOrbit=true&type=payload answers "how many active satellites are up there", and owner=PRC tells you who launched them. For a satellite's live sub-point position, pass its noradId to /api/space/satellite.

Call it in 30 seconds

// This service settles on Base Sepolia.
// Use an x402 client with a matching signer (e.g. an @x402 Solana client).
// First, inspect the payment terms for free:
const r = await fetch("https://2s-jwnd2jdga-alleyford.vercel.app/api/space/satellites"); // returns HTTP 402 + machine-readable terms
console.log(r.status, await r.json());

# This service settles on Base Sepolia.
# Use an x402 client with a matching signer. To see the terms first, for free:
import httpx
r = httpx.get("https://2s-jwnd2jdga-alleyford.vercel.app/api/space/satellites")  # HTTP 402 + machine-readable payment terms
print(r.status_code, r.json())

# 1) An unpaid request returns HTTP 402 with the exact payment terms:
curl -i "https://2s-jwnd2jdga-alleyford.vercel.app/api/space/satellites?limit=3&onOrbit=true&q=starlink"

# 2) Paying + retrying requires an x402 client that can sign the USDC
#    authorization (curl alone cannot). See the JS / Python tabs below.

New to x402? Read the 5-minute quickstart →