Market data can be retrieved through the API
API Host URLs
- Albion Online Americas Server:
https://west.albion-online-data.com
- Albion Online Asia Server:
https://east.albion-online-data.com
- Albion Online Europe Server:
https://europe.albion-online-data.com
API Endpoints
- Swagger documentation available here.
- Item IDs can be found in the formatted metadata items.txt or items.json files.
- Location IDs or String Names can be found in the formatted metadata world.txt or world.json files.
For any of the following URLs, .json
is optional and is the default. For XML, replace .json
with .xml
.
- Current Prices (Table View):
/api/v2/stats/view/T4_BAG,T5_BAG?locations=Caerleon,Bridgewatch&qualities=2
- Current Prices (JSON):
/api/v2/stats/prices/T4_BAG,T5_BAG.json?locations=Caerleon,Bridgewatch&qualities=2
- Historical Prices (sell orders only):
- New!
/api/v2/stats/history/T4_BAG,T5_BAG.json?date=2-5-2020&end_date=2-12-2020&locations=Caerleon&qualities=2&time-scale=6
- New! Hourly (time-scale=1):
/api/v2/stats/history/T4_BAG,T5_BAG.json?time-scale=1
- New! Daily (time-scale=24):
/api/v2/stats/history/T4_BAG,T5_BAG.json?time-scale=24
- New! For charts:
/api/v2/stats/charts/T4_BAG,T5_BAG.json?date=2-5-2020&end_date=2-12-2020&locations=Caerleon&qualities=2&time-scale=6
- New!
- Gold Prices:
- New! Over time:
/api/v2/stats/gold.json?date=2-5-2020&end_date=2-12-2020
- New! Most recent X prices:
/api/v2/stats/gold.json?count=2
- New! Over time:
API Endpoint Rate Limits
- 180 per 1 minute
- 300 per 5 minutes
“I WANT ALL THE DATA FROM THE API”
Well, you can. You just need to do it in a way that doesn’t hit the API rate limit. Combine the item’s you want to get data on, as well as locations. There’s a 4096 character limit for the url length. You can fit a lot of items and all the locations in a single call.
Something like this (too big to show on the page!).
We also ask that if you are going to write a service that continually hits the API, please use Gzip compression. The server and bandwidth isn’t free and while the monthly bandwidth limit hasn’t been exceeded that we’re aware of, the more people that use the project and it’s API, the closer we get to overages.