# Kansai ADS-B Live API

> Live aircraft positions and flight history over Kansai / western Japan, received by an independent ADS-B station (readsb, ~1s freshness), enriched with callsign-to-route resolution from official airline timetables. Pay per call with USDC on Base mainnet via the x402 protocol — no signup, no API key. Payments settle via EIP-3009 so buyers need no gas.

## Paid endpoints (x402, USDC on Base mainnet)

- GET https://x402-adsb.x402-adsb-worker.workers.dev/aircraft — $0.001: one live snapshot of every aircraft currently received, with origin/destination route resolution
- GET https://x402-adsb.x402-adsb-worker.workers.dev/history/flight?hex=<icao24>&from=<unix>&to=<unix> — $0.01: one aircraft's track at 60s granularity, up to a 24h window, 90-day retention
- GET https://x402-adsb.x402-adsb-worker.workers.dev/pass/hour — $0.50: bearer token for 1 hour of UNLIMITED access via /live/aircraft and /live/history/flight (best for polling/radar apps)
- GET https://x402-adsb.x402-adsb-worker.workers.dev/typhoon/verification — $0.05: verification dataset of an experimental AI typhoon model vs JMA analysis (historical records, NOT a forecast)

## How to pay

A GET without payment returns HTTP 402 with the payment requirements base64-encoded in the PAYMENT-REQUIRED response header (x402 v2). Any x402 client (e.g. @x402/fetch on npm) handles the flow automatically: sign an EIP-3009 USDC authorization, retry with the PAYMENT-SIGNATURE header, receive data.

## Free endpoints

- GET https://x402-adsb.x402-adsb-worker.workers.dev/health — data freshness check
- GET https://x402-adsb.x402-adsb-worker.workers.dev/history/coverage — archived history range
- GET https://x402-adsb.x402-adsb-worker.workers.dev/typhoon/summary — dataset preview
- GET https://x402-adsb.x402-adsb-worker.workers.dev/docs — field dictionary, coverage, pricing, disclaimer
- GET https://x402-adsb.x402-adsb-worker.workers.dev/aircraft-testnet — integration test on base-sepolia test-USDC (5-aircraft sample)
- GET https://x402-adsb.x402-adsb-worker.workers.dev/openapi.json — OpenAPI 3.1 spec
- GET https://x402-adsb.x402-adsb-worker.workers.dev/.well-known/x402 — machine-readable paid-resource manifest

## Notes

Coverage: Kansai / western Japan airspace, radius up to ~250 km depending on altitude. Single receiver, raw as-received data. NOT for operational, navigation, or safety-of-life use.