In addition to the browsable map of real-time data, ADS-B Exchange is also making available historical and real-time data for personal/non-profit use at a very low cost. I f you find this data useful, or just want to see it’s distribution continue, we greatly appreciate any donations, especially monthly recurring donations to fund the ongoing operation of the site. This data would cost a significant amount of money to buy elsewhere.
As noted in the legal terms and conditions, commercial use requires written authorization from ADS-B Exchange. This is necessary to ensure operating this site remains financially viable so we can continue to provide the service. We may ask that certain commercial users contribute financially to the operation of this site if they desire to use the data in revenue-generating products.
This service could end at any time if the cost to provide it outweighs incoming revenue/donations. Please keep that in mind when downloading data/using this service – go easy on the infrastructure if you can. There are quite a few hosting/bandwidth/storage costs for a large and growing data archive such as we have here.
Attention Developers! Please contact us to use the API in your public app. We will publish a blog post about our app, if you would like us to do so. We will also work with you to provide the data you require in the most cost efficient way for ADSBx.
Querying Live Position Data
Live position data can be queried with various parameters are results returned in a JSON format. As you may be aware, ADSBexchange is based on the excellent Virtual Radar Server product by Andrew Whewell.
The base URL to query is: http://public-api.adsbexchange.com/VirtualRadar/AircraftList.json (querying this URL by itself will yield a JSON with _all_ airborne aircraft).
To further filter and slice the data, use the querystrings shown in the documentation. For example, based on the above, to query all aircraft between 0 and 100 km of the lat/long of Phoenix Sky Harbor Airport, use:
This is a good way to get LIVE data. If you want historical, do NOT call this JSON repeatedly and store it. Instead, see below!
Feed Live Data to your own VRS Installation
Do you run a local copy of VRS? Again, if your use is non-profit and you do not share your VRS site with the general public, feel free to make use of our data by getting a live feed of everything we have!
Within VRS, go to Tools > Options, click on “Receivers”, then click the green “+” to add a new receiver. Configure it as shown below. Depending on your bandwidth and power of your local computer, you may want to choose a different update interval. This is done by changing the last two digits of the port number. Available options are shown below.
Important note: If you use this method, and you also feed us via VRS, please ensure that you are not sending our data feed back to us in your feed! It uses our (and your) resources for no reason. Thanks! Also, please ensure that your system clock is synced reasonably well with an internet time source via NTP.
Live Data via TCP Connection
To retrieve Live data via a TCP connection, connect to pub-vrs.adsbexchange.com on port 32001, or one of the ports below for a slower update rate. The 1 second update rate requires 1.5 – 2 mbps of bandwidth during busy times.
- Port 32001 – 1 second updates (realtime)
- Port 32005 – 5 second updates
- Port 32010 – 10 second updates
- Port 32015 – 15 second updates
- Port 32030 – 30 second updates
Historical Data (by date/time)
If you want to download a historical record of all data received by ADSBexchange, this is the section for you.
Requirements for JSON Historical Data Access:
- Hosting a feeder sending data to ADSBx. [instructions]
- You are a non-commercial personal user for research, and/or personal knowledge.
- Donation for JSON Data is 0.15 USD per GB to cover bandwidth and storage costs, $500 one year minimum.
Each day is approximately 10-14 GB, thus 1 day is approximately $1.50-$2.10 USD to download. [donate here]
ADSBx requires all academic researchers cover the cost of ingest, aggregation, download, and storage for their use. If you are and academic researcher with an official email, contact ADSBx for an agreement.
ADSBexchange.com requires that all qualifying academic researchers donate a minimum $500 per year of data download to cover infrastructure costs to ingest, aggregate, and archive the data set. This is not optional due to the cost of this data and the cost of infrastructure to support the archive.
Data is available beginning on June 9, 2016.
If you meet all 3 requirements, you can request access to download the JSON archive historical files here.
Please explain your use, commercial or non-commercial or otherwise and intentions for the data, and how many days of data and how often you would like to download. An account will be created and you will receive an email with information. ADSBx requires that all published work using ADSBx data credits ADSBexchange.com or ADSBexchange, LLC for providing the data.
All use other the personal non-commercial must have a commercial data license agreement.
How the data is created:
Building on the “Querying Live Data” section above, essentially, every 60 seconds, we issue the following JSON query and store the results: http://public-api.adsbexchange.com/VirtualRadar/AircraftList.json?trFmt=sa
Essentially, this is a JSON of all aircraft, with “short trails” activated. The short trail duration used in the historical data archive is 65 seconds. This gives all the current information on the aircraft, plus any known positions, altitudes and timestamps for the previous 65 seconds. Since this query is issued every 60 seconds, all known positions should be captured in the data. Please consult this page for an explanation of data field contents.
This file is captured every 60 seconds, typically on the 30-second mark of any given minute. This generates 1,440 files daily, which then get zipped into a single archive per day. The archive for the previous day is typically available by 0100Z (01:00 UTC) the following day. Data is available beginning on June 9, 2016. Daily files are currently in the neighborhood of 10 GB each.
Transfer rates may be somewhat limited depending on the latency of your connection.
JSON Download URL request format:
Simply extrapolate the pattern for any subsequent date.
For a full explanation of fields: https://www.adsbexchange.com/datafields
Historical Data (by specific aircraft/ICAO codes)
While this data is contained in the JSON files discussed above, it is not easily searchable for a single aircraft. Historical data for specific aircraft can be searched here: https://flight-data.adsbexchange.com/. The server for these queries is our AWS data warehouse (described below).
SQL Query-able Amazon Redshift Database
Amazon Redshift is based on PostgreSQL. The data contained in the JSON files discussed above is also loaded into an Amazon Redshift database that can be queried with SQL syntax, or linked to any number of data analysis tools such as Tableau, redash.io, chartio, Microsoft Power BI, and more.
The ADSBexchange Amazon Redshift database can be queried directly via the internet. Click here for instructions on how to connect.
While Amazon Redshift contains the data already available in the JSON files discussed above, storing, indexing, and making this data available via Redshift does carry a non-trivial financial cost to ADSBexchange. Access to our Redshift database has an associated cost. If you have a personal, non-profit, or commercial use in mind, please contact us for more information on getting access.
Click here for a description of some of the fields available to query. There are nearly 13 billion records and counting.
Redshift access is available on a pay per use model to cover cluster costs, bandwidth, and maintenance. Contact for more information.