{"openapi":"3.1.0","info":{"title":"Albion Online API","version":"1.0.0","description":"Albion Online game data as an API, powered by the community Albion Online Data Project and the official game-info API (Americas / West server). Pull live Trading Post prices for any item across all the royal cities (Caerleon, Bridgewatch, Lymhurst, Martlock, Thetford, Fort Sterling, Brecilien) and the Black Market — minimum and maximum sell and buy prices broken down by item quality, with the timestamps so you know how fresh each quote is — read the price-and-volume history of any item over the last hours or days, and track the gold price in silver. Look up players by name for their kill and death fame, fame ratio, guild, alliance and kill counts, and search guilds. Item ids follow the simple pattern T4_BAG, T8_PLATE_HELMET (add @1, @2, @3 for enchantment level). This is exactly the data that powers Albion flipping and trading tools, transport and crafting profit calculators, market dashboards, guild and PvP trackers and Discord bots. Prices are in silver. No accounts, no upstream key.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/albion-api","description":"oanor gateway"}],"tags":[{"name":"Market"},{"name":"Players"},{"name":"Reference"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/gold":{"get":{"operationId":"get_v1_gold","tags":["Market"],"summary":"Gold price (silver)","description":"","parameters":[{"name":"count","in":"query","required":false,"description":"Points 1-100","schema":{"type":"string"},"example":"10"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"latest":7330,"history":[{"price":7330,"timestamp":"2026-06-01T00:00:00"},{"price":7331,"timestamp":"2026-05-31T23:00:00"},{"price":7316,"timestamp":"2026-05-31T22:00:00"},{"price":7297,"timestamp":"2026-05-31T21:00:00"},{"price":7304,"timestamp":"2026-05-31T20:00:00"},{"price":7327,"timestamp":"2026-05-31T19:00:00"},{"price":7335,"timestamp":"2026-05-31T18:00:00"},{"price":7318,"timestamp":"2026-05-31T17:00:00"},{"price":7307,"timestamp":"2026-05-31T16:00:00"},{"price":7289,"timestamp":"2026-05-31T15:00:00"}]},"meta":{"timestamp":"2026-06-01T00:03:30.371Z","request_id":"2ceb084a-d46f-41ee-82a8-f298d3e06da1"},"status":"ok","message":"Gold retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/history":{"get":{"operationId":"get_v1_history","tags":["Market"],"summary":"Price & volume history","description":"","parameters":[{"name":"item","in":"query","required":true,"description":"Item id","schema":{"type":"string"},"example":"T4_BAG"},{"name":"city","in":"query","required":false,"description":"City","schema":{"type":"string"},"example":"Caerleon"},{"name":"scale","in":"query","required":false,"description":"1|6|24 hours","schema":{"type":"string"},"example":"24"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"item":"T4_BAG","series":[{"city":"Caerleon","data":[{"avg_price":7334,"timestamp":"2026-05-02T00:00:00","item_count":117},{"avg_price":7559,"timestamp":"2026-05-03T00:00:00","item_count":259},{"avg_price":7871,"timestamp":"2026-05-04T00:00:00","item_count":117},{"avg_price":5930,"timestamp":"2026-05-05T00:00:00","item_count":249},{"avg_price":7568,"timestamp":"2026-05-06T00:00:00","item_count":146},{"avg_price":7213,"timestamp":"2026-05-07T00:00:00","item_count":94},{"avg_price":6537,"timestamp":"2026-05-08T00:00:00","item_count":226},{"avg_price":7528,"timestamp":"2026-05-09T00:00:00","item_count":164},{"avg_price":7204,"timestamp":"2026-05-10T00:00:00","item_count":191},{"avg_price":6731,"timestamp":"2026-05-11T00:00:00","item_count":201},{"avg_price":6663,"timestamp":"2026-05-12T00:00:00","item_count":147},{"avg_price":7255,"timestamp":"2026-05-13T00:00:00","item_count":90},{"avg_price":6458,"timestamp":"2026-05-14T00:00:00","item_count":87},{"avg_price":7245,"timestamp":"2026-05-15T00:00:00","item_count":109},{"avg_price":6803,"timestamp":"2026-05-16T00:00:00","item_count":105},{"avg_price":6701,"timestamp":"2026-05-17T00:00:00","item_count":165},{"avg_price":7249,"timestamp":"2026-05-18T00:00:00","item_count":135},{"avg_price":7410,"timestamp":"2026-05-19T00:00:00","item_count":121},{"avg_price":6423,"timestamp":"2026-05-20T00:00:00","item_count":162},{"avg_price":6589,"timestamp":"2026-05-21T00:00:00","item_count":68},{"avg_price":6843,"timestamp":"2026-05-22T00:00:00","item_count":188},{"avg_price":6732,"timestamp":"2026-05-23T00:00:00","item_count":207},{"avg_price":6609,"timestamp":"2026-05-24T00:00:00","item_count":108},{"avg_price":4874,"timestamp":"2026-05-25T00:00:00","item_count":219},{"avg_price":4253,"timestamp":"2026-05-26T00:00:00","item_count":72},{"avg_price":5154,"timestamp":"2026-05-27T00:00:00","item_count":113},{"avg_price":5413,"timestamp":"2026-05-28T00:00:00","item_count":126},{"avg_price":5385,"timestamp":"2026-05-29T00:00:00","item_count":97},{"avg_price":5182,"timestamp":"2026-05-30T00:00:00","item_count":178}],"count":29,"quality":1},{"city":"Caerleon","data":[{"avg_price":7202,"timestamp":"2026-05-02T00:00:00","item_count":170},{"avg_price":7272,"timestamp":"2026-05-03T00:00:00","item_count":191},{"avg_price":7516,"timestamp":"2026-05-04T00:00:00","item_count":236},{"avg_price":6532,"timestamp":"2026-05-05T00:00:00","item_count":288},{"avg_price":7322,"timestamp":"2026-05-06T00:00:00","item_count":206},{"avg_price":6685,"timestamp":"2026-05-07T00:00:00","item_count":143},{"avg_price":7514,"timestamp":"2026-05-08T00:00:00","item_count":197},{"avg_price":7655,"timestamp":"2026-05-09T00:00:00","item_count":338},{"avg_price":7420,"timestamp":"2026-05-10T00:00:00","item_count":243},{"avg_price":6698,"timestamp":"2026-05-11T00:00:00","item_count":190},{"avg_price":7050,"timestamp":"2026-05-12T00:00:00","item_count":212},{"avg_price":7741,"timestamp":"2026-05-13T00:00:00","item_count":252},{"avg_price":7266,"timestamp":"2026-05-14T00:00:00","item_count":287},{"avg_price":7229,"timestamp":"2026-05-15T00:00:00","item_count":204},{"avg_price":7164,"timestamp":"2026-05-16T00:00:00","item_count":287},{"avg_price":7471,"timestamp":"2026-05-17T00:00:00","item_count":245},{"avg_price":7429,"timestamp":"2026-05-18T00:00:00","item_count":207},{"avg_price":7729,"timestamp":"2026-05-19T00:00:00","item_count":231},{"avg_price":7266,"timestamp":"2026-05-20T00:00:00","item_count":287},{"avg_price":7754,"timestamp":"2026-05-21T00:00:00","item_count":785},{"avg_price":6878,"timestamp":"2026-05-22T00:00:00","item_count":145},{"avg_price":7041,"timestamp":"2026-05-23T00:00:00","item_count":336},{"avg_price":6934,"timestamp":"2026-05-24T00:00:00","item_count":305},{"avg_price":4929,"timestamp":"2026-05-25T00:00:00","item_count":601},{"avg_price":4399,"timestamp":"2026-05-26T00:00:00","item_count":283},{"avg_price":5504,"timestamp":"2026-05-27T00:00:00","item_count":241},{"avg_price":4745,"timestamp":"2026-05-28T00:00:00","item_count":338}],"count":27,"quality":2},{"city":"Caerleon","data":[{"avg_price":7744,"timestamp":"2026-05-02T00:00:00","item_count":109},{"avg_price":7625,"timestamp":"2026-05-03T00:00:00","item_count":50},{"avg_price":7014,"timestamp":"2026-05-04T00:00:00","item_count":61},{"avg_price":5979,"timestamp":"2026-05-05T00:00:00","item_count":75},{"avg_price":7735,"timestamp":"2026-05-06T00:00:00","item_count":95},{"avg_price":7679,"timestamp":"2026-05-07T00:00:00","item_count":185},{"avg_price":8007,"timestamp":"2026-05-08T00:00:00","item_count":132},{"avg_price":7502,"timestamp":"2026-05-09T00:00:00","item_count":87},{"avg_price":7187,"timestamp":"2026-05-10T00:00:00","item_count":96},{"avg_price":7320,"timestamp":"2026-05-11T00:00:00","item_count":39},{"avg_price":7064,"timestamp":"2026-05-12T00:00:00","item_count":80},{"avg_price":7279,"timestamp":"2026-05-13T00:00:00","item_count":51},{"avg_price":7407,"timestamp":"2026-05-14T00:00:00","item_count":73},{"avg_price":7648,"timestamp":"2026-05-15T00:00:00","item_count":173},{"avg_price":7636,"timestamp":"2026-05-16T00:00:00","item_count":223},{"avg_price":7813,"timestamp":"2026-05-17T00:00:00","item_count":224},{"avg_price":7731,"timestamp":"2026-05-18T00:00:00","item_count":122}],"count":17,"quality":3},{"city":"Caerleon","data":[{"avg_price":9127,"timestamp":"2026-05-02T00:00:00","item_count":42},{"avg_price":8199,"timestamp":"2026-05-03T00:00:00","item_count":25},{"avg_price":8324,"timestamp":"2026-05-04T00:00:00","item_count":37},{"avg_price":8494,"timestamp":"2026-05-05T00:00:00","item_count":42},{"avg_price":9098,"timestamp":"2026-05-06T00:00:00","item_count":33},{"avg_price":7603,"timestamp":"2026-05-07T00:00:00","item_count":53},{"avg_price":9191,"timestamp":"2026-05-08T00:00:00","item_count":37},{"avg_price":8946,"timestamp":"2026-05-09T00:00:00","item_count":34},{"avg_price":8666,"timestamp":"2026-05-10T00:00:00","item_count":43},{"avg_price":8752,"timestamp":"2026-05-11T00:00:00","item_count":49},{"avg_price":8843,"timestamp":"2026-05-12T00:00:00","item_count":46},{"avg_price":9631,"timestamp":"2026-05-13T00:00:00","item_count":38},{"avg_price":9013,"timestamp":"2026-05-14T00:00:00","item_count":38},{"avg_price":8922,"timestamp":"2026-05-15T00:00:00","item_count":34}],"count":14,"quality":4}],"scale_hours":24},"meta":{"timestamp":"2026-06-01T00:03:30.471Z","request_id":"5392bcb6-0a22-43a8-94d7-f3625cc92459"},"status":"ok","message":"History retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/price":{"get":{"operationId":"get_v1_price","tags":["Market"],"summary":"Trading Post prices","description":"","parameters":[{"name":"item","in":"query","required":true,"description":"Item id","schema":{"type":"string"},"example":"T4_BAG"},{"name":"cities","in":"query","required":false,"description":"Comma cities","schema":{"type":"string"},"example":"Caerleon,Martlock"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"item":"T4_BAG","count":10,"prices":[{"city":"Caerleon","buy_max":2574,"buy_min":1,"quality":1,"sell_max":5898,"sell_min":5250,"buy_max_date":"2026-05-31T05:55:00","sell_min_date":"2026-05-31T22:00:00"},{"city":"Caerleon","buy_max":3847,"buy_min":3847,"quality":2,"sell_max":5469,"sell_min":5469,"buy_max_date":"2026-05-31T22:50:00","sell_min_date":"2026-05-31T22:45:00"},{"city":"Caerleon","buy_max":0,"buy_min":0,"quality":3,"sell_max":5480,"sell_min":5480,"buy_max_date":"0001-01-01T00:00:00","sell_min_date":"2026-05-31T22:45:00"},{"city":"Caerleon","buy_max":0,"buy_min":0,"quality":4,"sell_max":9597,"sell_min":9250,"buy_max_date":"0001-01-01T00:00:00","sell_min_date":"2026-05-31T21:35:00"},{"city":"Caerleon","buy_max":0,"buy_min":0,"quality":5,"sell_max":14998,"sell_min":14998,"buy_max_date":"0001-01-01T00:00:00","sell_min_date":"2026-05-31T21:35:00"},{"city":"Martlock","buy_max":50,"buy_min":50,"quality":1,"sell_max":4000,"sell_min":3995,"buy_max_date":"2026-05-31T22:45:00","sell_min_date":"2026-05-31T12:40:00"},{"city":"Martlock","buy_max":2498,"buy_min":1,"quality":2,"sell_max":4000,"sell_min":3995,"buy_max_date":"2026-05-31T00:40:00","sell_min_date":"2026-05-31T12:40:00"},{"city":"Martlock","buy_max":2498,"buy_min":20,"quality":3,"sell_max":4000,"sell_min":3995,"buy_max_date":"2026-05-31T00:40:00","sell_min_date":"2026-05-31T12:40:00"},{"city":"Martlock","buy_max":0,"buy_min":0,"quality":4,"sell_max":0,"sell_min":0,"buy_max_date":"0001-01-01T00:00:00","sell_min_date":"0001-01-01T00:00:00"},{"city":"Martlock","buy_max":0,"buy_min":0,"quality":5,"sell_max":0,"sell_min":0,"buy_max_date":"0001-01-01T00:00:00","sell_min_date":"0001-01-01T00:00:00"}]},"meta":{"timestamp":"2026-06-01T00:03:30.556Z","request_id":"a3d8bc45-445c-488e-a04a-e69c1a5a0ea5"},"status":"ok","message":"Prices retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/guild":{"get":{"operationId":"get_v1_guild","tags":["Players"],"summary":"Search guilds","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Guild name","schema":{"type":"string"},"example":"Money"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"query":"Money","guilds":[{"id":"N6Y9p3RsQsScUf5UXlet7A","name":"Money","death_fame":6458890},{"id":"fZkeg87iS_iGJwIGESC1lw","name":"MONEY 001","death_fame":0},{"id":"2km-ULCKQlG2-c0W28JeZw","name":"Money 004","death_fame":0},{"id":"HAJ4E5jlQQKt1_Y2X1N_EA","name":"Money 01","death_fame":0},{"id":"uCfj2A3KSxKIj8_8paAvJQ","name":"money 010","death_fame":0},{"id":"WBehNb8LTdO5u3XQJaDc5Q","name":"Money 02","death_fame":0},{"id":"Qo8LqSxXQJiaQ2rhvG9SWw","name":"Money 03","death_fame":0},{"id":"L9yrJzV-R8eef8nBKktHCA","name":"Money 04","death_fame":0},{"id":"vkRygYJNQR-LM-06miwvjQ","name":"Money 05","death_fame":0},{"id":"KLWJloSUQWSCbj5aK6YwNg","name":"Money 06","death_fame":0}]},"meta":{"timestamp":"2026-06-01T00:03:33.107Z","request_id":"9200d3bb-2984-4262-9416-53536c832972"},"status":"ok","message":"Guilds retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/player":{"get":{"operationId":"get_v1_player","tags":["Players"],"summary":"Search players","description":"","parameters":[{"name":"name","in":"query","required":true,"description":"Player name","schema":{"type":"string"},"example":"Robinhood"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"query":"Robinhood","players":[{"id":"nU1Y8JrkRrW8lCLMhPZFpQ","name":"RobinHood","kill_fame":0,"death_fame":0,"fame_ratio":0},{"id":"2rR2UOYvSYyPy5WQCnBHuQ","name":"RobinHood0","kill_fame":0,"death_fame":0,"fame_ratio":0},{"id":"M1Rd9IzcSCi2NDBYwg7hcw","name":"RobinHood0","kill_fame":0,"death_fame":0,"fame_ratio":0},{"id":"l00n3T9vQqKTxm64Ik_J2Q","name":"robinhood00","kill_fame":0,"death_fame":21720,"fame_ratio":0},{"id":"G-ac7uBdShWA70K7ix18Sw","name":"RobinHood0007","kill_fame":0,"death_fame":0,"fame_ratio":0},{"id":"Gh4RZasRRC-VNvdXUDS7VQ","name":"RobinHood0007","kill_fame":0,"death_fame":0,"fame_ratio":0},{"id":"Cp1KeXtCT_aRTLXTztlOlw","name":"RobinHood0007","kill_fame":0,"death_fame":0,"fame_ratio":0},{"id":"gM3S4SKvTO6FT0fHA41U9Q","name":"RobinHood0007","kill_fame":0,"death_fame":0,"fame_ratio":0},{"id":"k2k1gypDSMyXwXrMugv2lg","name":"RobinHood0007","kill_fame":0,"death_fame":0,"fame_ratio":0},{"id":"7gSn0DrHTkS_pIaURlNDPg","name":"RobinHood0007","kill_fame":0,"death_fame":0,"fame_ratio":0}]},"meta":{"timestamp":"2026-06-01T00:03:35.141Z","request_id":"87f6a949-f220-4b75-bd84-31217461f198"},"status":"ok","message":"Players retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/cities":{"get":{"operationId":"get_v1_cities","tags":["Reference"],"summary":"Markets list","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Use these city names (or their no-space form) in the cities= parameter.","count":8,"cities":["Caerleon","Bridgewatch","Lymhurst","Martlock","Thetford","Fort Sterling","Brecilien","Black Market"]},"meta":{"timestamp":"2026-06-01T00:03:35.212Z","request_id":"daa126bc-9767-4128-811c-57155ea0b715"},"status":"ok","message":"Cities retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"Albion Online data (Americas/West server). /v1/price?item=T4_BAG&cities=Caerleon,Bridgewatch = current Trading Post sell/buy prices per city & quality (item ids look like T4_BAG, T8_PLATE_HELMET, add @1 for enchant); /v1/history?item=T4_BAG&city=Caerleon&scale=24 = price & volume history; /v1/gold = the gold price in silver; /v1/player?name=Robinhood = search players (kill fame, guild, kills); /v1/guild?name=Money Guild = search guilds; /v1/cities = the royal cities & Black Market. Prices in silver. Community-sourced market data from the Albion Online Data Project.","source":"Albion Online Data Project (albion-online-data.com) + Albion game-info API","endpoints":["/v1/price","/v1/history","/v1/gold","/v1/player","/v1/guild","/v1/cities","/v1/meta"]},"meta":{"timestamp":"2026-06-01T00:03:35.259Z","request_id":"fba876f5-e702-4eaf-9d71-3f090a20acf4"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3400,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":460,"monthly_call_quota":44500,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":1400,"monthly_call_quota":217000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":3900,"monthly_call_quota":1075000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/albion-api"}