{"uid":"cap_zwIGpQ_wQBsmEtTy02qSv","slug":"x402-live-flight-states-ads-b-53cf77be","name":"x402 Live Flight States (ADS-B)","description":"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).","url":"https://x402-endpoints.onrender.com/flights/states?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"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"}}}}},"responseSchema":{"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."}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_c41FzqXv8bjdOu48-lUpb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":null,"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:36:05.446Z","isFirstParty":false,"canonicalSlug":"x402-live-flight-states-ads-b-53cf77be"}