# x402 Live Flight States (ADS-B)

> x402 Live Flight States (ADS-B) is a paid API for AI agents from x402-endpoints.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-02).

Returns real-time aircraft positions, altitude, speed, heading and ground status for all aircraft within a geographic bounding box using ADS-B data from adsb.fi.

## Facts

- Endpoint: GET https://x402-endpoints.onrender.com/flights/states?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-live-flight-states-ads-b-53cf77be
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zwIGpQ_wQBsmEtTy02qSv

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 x402-live-flight-states-ads-b-53cf77be
```

Example prompt: Show me all aircraft currently in the air over the Paris area — use the bounding box from latitude 48.0 to 49.0 and longitude 2.0 to 3.0.

## When to prefer this

Use this endpoint when you need live, real-time aircraft positions for a specific geographic area defined by a lat/lon bounding box, powered by global ADS-B open data from adsb.fi. Prefer this over historical flight APIs when current airspace situational awareness is required, and over airline schedule APIs when you need actual live positions rather than scheduled routes.

## Known failure modes

- Missing or invalid bounding box parameters returns a 400 error
- Extremely large bounding boxes may return excessive or truncated results
- No aircraft in the bounding box returns an empty state list
- Temporary adsb.fi data feed outages may result in stale or unavailable data
- Payment failure (x402) returns a 402 response before data is served

## How this service works

Real-time aircraft states and live flight tracking worldwide from adsb.fi open data (ADS-B) — give a bounding box, get every aircraft in the area with live position, altitude, speed, heading and ground status. Data by adsb.fi (ODbL).

## Output

A list of all aircraft currently within the specified bounding box, each with live position (lat/lon), altitude, speed, heading, callsign, and whether the aircraft is on the ground or airborne, sourced from adsb.fi ADS-B open data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "lamin",
      "lomin",
      "lamax",
      "lomax"
     ],
     "properties": {
      "lamax": {
       "type": "number",
       "description": "Max latitude of bounding box, e.g. 49.0"
      },
      "lamin": {
       "type": "number",
       "description": "Min latitude of bounding box, e.g. 48.0"
      },
      "lomax": {
       "type": "number",
       "description": "Max longitude of bounding box, e.g. 3.0"
      },
      "lomin": {
       "type": "number",
       "description": "Min longitude of bounding box, e.g. 2.0"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "bbox": {
   "lamax": 49,
   "lamin": 48,
   "lomax": 3,
   "lomin": 2
  },
  "time": 1782418394,
  "count": 1,
  "cached": false,
  "source": "adsb.fi open data (opendata.adsb.fi)",
  "states": [
   {
    "icao24": "3c49b1",
    "squawk": "1000",
    "callsign": "TUI6HA",
    "latitude": 48.820775,
    "longitude": 2.189676,
    "on_ground": false,
    "velocity_ms": 239.01,
    "last_contact": 1782418393,
    "registration": "D-ABMQ",
    "aircraft_type": "B738",
    "geo_altitude_m": 11887.2,
    "origin_country": null,
    "true_track_deg": 44.22,
    "baro_altitude_m": 11582.4,
    "vertical_rate_ms": -2.28
   }
  ],
  "timestamp": "2026-06-24T14:25:00Z",
  "attribution": "Live ADS-B data by adsb.fi (https://adsb.fi) — community ODbL, free open data."
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-live-flight-states-ads-b-53cf77be/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-endpoints.onrender.com](https://www.zero.xyz/host/x402-endpoints.onrender.com/llms.txt)