# Aircraft Tracker API (ADS-B)

> Aircraft Tracker API (ADS-B) is a paid API for AI agents from agent-data.centorprat.workers.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-10-28).

Returns live ADS-B aircraft data around any lat/lon coordinate, including callsign, type, altitude, speed, distance, closest point of approach (CPA), ETA, and flags for inbound, military, and unidentified aircraft.

## Facts

- Endpoint: POST https://agent-data.centorprat.workers.dev/tools/aircraft-tracker-adsb?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/aircraft-tracker-api-ads-b-01f28cf2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_OvI6h8_I7WiaYDS5E57fZ

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 aircraft-tracker-api-ads-b-01f28cf2 -d '<json body>'
```

Example prompt: What aircraft are currently flying within 30 nautical miles of London Heathrow (lat 51.4775, lon -0.4614)? Include military and unidentified planes, and flag anything that will come within 10 km in the next 15 minutes.

## When to prefer this

Choose this endpoint when you need real-time positional data on aircraft around a specific geographic point, especially when you need military or unidentified aircraft flags, closest-approach calculations, and inbound alerting — capabilities not available on most generic flight-tracker APIs. Best suited for geofencing alerts, airspace awareness, and security or defense monitoring use cases.

## Known failure modes

- No aircraft found in the specified radius — returns empty result set without charge
- Invalid latitude/longitude values outside decimal degree bounds
- Radius exceeds the 250 NM maximum, returning an error
- Unsupported category enum value causing a validation error
- Network timeout or worker outage returning a 5xx error

## How this service works

Pay-per-call data and tools for AI agents, $0.002-0.01 per call in USDC via x402 (Base, Polygon or Solana), no account or API key; MAX tiers ($0.05-0.25) run deeper jobs. Agent toolkit: web search, search + read top pages, any page as clean markdown with a prompt-injection check, which-x402-API-to-call recommender, seller check. Data: Google Maps places with contacts, YouTube video data and transcripts, job listings (Indeed, LinkedIn, 13 boards), Google Ads Transparency, TikTok comments, Pinterest, Airbnb, Redfin, AliExpress, app stores, live sports, website and SEO checks, Shopify store tech stacks, and onchain token / address risk checks.

## Output

Returns up to 3 aircraft (or up to the requested cap) near the specified coordinates, each with callsign, aircraft type, altitude, speed, current distance from center, closest point of approach (CPA), estimated time of arrival at CPA, and boolean flags for inbound status, military classification, and unidentified status. Failed lookups are not billed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "category": {
   "enum": [
    "all",
    "military",
    "unidentified",
    "military_or_unidentified"
   ],
   "type": "string",
   "description": "Filter by classification. 'unidentified' = transmitting but with no registration/type/callsign (what appears as N/A on public trackers); 'military' = detected by hex block, callsign prefix, type code, or the feed's military flag."
  },
  "latitude": {
   "type": "number",
   "description": "Latitude of the point to watch, in decimal degrees. Example: 40.4936 (north is positive, south negative)."
  },
  "radiusNm": {
   "type": "integer",
   "description": "How far out to look, 1-250 NM (250 NM is about 460 km, the data source maximum)."
  },
  "longitude": {
   "type": "number",
   "description": "Longitude of the point to watch, in decimal degrees. Example: -3.5668 (east is positive, west negative)."
  },
  "maxResults": {
   "type": "integer",
   "description": "Optional cap on how many aircraft to return."
  },
  "inboundAlertKm": {
   "type": "integer",
   "description": "An aircraft is flagged inbound=true if it will pass within this many km of the center."
  },
  "inboundMinutes": {
   "type": "integer",
   "description": "...and will do so within this many minutes from now."
  },
  "onlyApproaching": {
   "type": "boolean",
   "description": "If true, return only aircraft that are getting closer to the center (closest point of approach is nearer than their current distance)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "hex": "3451cf",
    "type": "B788",
    "squawk": "1000",
    "country": "Spain",
    "callsign": "AEA11PN",
    "category": "civil",
    "latitude": 40.577258,
    "emergency": false,
    "longitude": -3.545151,
    "altitudeFt": 4350,
    "isMilitary": false,
    "description": null,
    "registration": "EC-MIH",
    "isUnidentified": false
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/aircraft-tracker-api-ads-b-01f28cf2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent-data.centorprat.workers.dev](https://www.zero.xyz/host/agent-data.centorprat.workers.dev/llms.txt)