{"openapi":"3.1.0","info":{"title":"ahprice","version":"1.0.0","summary":"Read-only World of Warcraft Forever auction prices.","description":"Crowd-sourced auction scans from the free ahprice addon. Prices are integer copper. No API key. Market average is a quantity-weighted 7-day half-life, not the latest listing. True value is what it sells for now: weighted median of hourly prices, 1-day half-life. See https://ahprice.com/developers."},"servers":[{"url":"https://ahprice.com"}],"paths":{"/api/v1":{"get":{"operationId":"apiIndex","summary":"API index","responses":{"200":{"description":"Index","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/realms":{"get":{"operationId":"listRealms","summary":"Markets (region + ruleset + faction) and the realm names each covers","responses":{"200":{"description":"Realms","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/items":{"get":{"operationId":"searchItems","summary":"Search items","parameters":[{"name":"q","in":"query","required":false,"schema":{"type":"string","description":"Item name fragment (2\u201360 characters) or an item id."}},{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25,"default":10}}],"responses":{"200":{"description":"Search hits","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/items/{item_id}":{"get":{"operationId":"getItemPrice","summary":"One item's market average and latest listing","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}}],"responses":{"200":{"description":"Price card","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/items/{item_id}/history":{"get":{"operationId":"priceHistory","summary":"Price history","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}},{"name":"days","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":180,"default":30}}],"responses":{"200":{"description":"History","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/prices":{"get":{"operationId":"getPrices","summary":"Batch price cards","parameters":[{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}},{"name":"ids","in":"query","required":false,"schema":{"type":"string","description":"Comma-separated item ids, at most 50."}}],"responses":{"200":{"description":"Batch","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/insights":{"get":{"operationId":"topCrafts","summary":"Trusted profitable crafts (profit after the 5% AH cut)","parameters":[{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}},{"name":"profession","in":"query","required":false,"schema":{"type":"string","description":"Profession name, such as Tailoring, or a profession id."}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25,"default":10}}],"responses":{"200":{"description":"Crafts","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/crafts/{spell_id}":{"get":{"operationId":"getCraft","summary":"One craft, with materials","parameters":[{"name":"spell_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}}],"responses":{"200":{"description":"Craft","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/deals":{"get":{"operationId":"findDeals","summary":"Listings well under the true value","parameters":[{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}},{"name":"min_discount","in":"query","required":false,"schema":{"type":"integer","minimum":10,"maximum":90,"default":25}},{"name":"min_samples","in":"query","required":false,"schema":{"type":"integer","minimum":1,"default":5}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":25,"default":10}}],"responses":{"200":{"description":"Deals","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}}}}},"/api/v1/disenchants/{item_id}":{"get":{"operationId":"disenchantValue","summary":"Expected disenchant value","parameters":[{"name":"item_id","in":"path","required":true,"schema":{"type":"integer"}},{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}}],"responses":{"200":{"description":"Disenchant","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"404":{"description":"Error","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"hint":{"type":"string"}},"required":["code","message"]}},"required":["error"]}}}}}}},"/api/v1/export/prices.csv":{"get":{"operationId":"exportPrices","summary":"CSV of every item's market average","parameters":[{"name":"realm","in":"query","required":true,"schema":{"type":"string","description":"Market id from /api/v1/realms, such as us-normal-horde (region-ruleset-faction). An old realm name or slug also works and returns its market's prices."}},{"name":"faction","in":"query","required":true,"schema":{"type":"string","enum":["alliance","horde"]}}],"responses":{"200":{"description":"CSV","content":{"text/csv":{"schema":{"type":"string"}}}}}}}}}