Forever AH API

Every price on this site is available as JSON, as a whole-house CSV, and through an MCP server for AI assistants. It's free and read-only, and needs no key. Please cache what you can and keep to about one request a second. Credit "Forever AH" and Blizzard's Battle.net API as the source.

All prices are copper per unit (1 gold = 100 silver = 10,000 copper). Data is refreshed about once an hour per auction house.

Auction houses

GET /v1/houses lists every house with its house_key (used in every other path). Each region (us, eu, kr, tw) has an "All Auction Houses" house (house_type: "unified") that pools all its houses.

Download everything

GET /v1/houses/{house_key}/export?format=csv (or format=json): every item listed now, with lowest buyout, p10, median, units, auctions, 14-day market value, 60-day value, 7-day trend, estimated units sold per day, vendor price and the time of the snapshot. Cached for 5 minutes.

curl -o us.csv "https://forever-ah.com/v1/houses/HOUSE_KEY/export?format=csv"

Endpoints

Path	What
`/v1/items/search?q=linen`	Find items by name or id
`/v1/items/{id}`	Item details, including vendor prices
`/v1/houses/{key}/market`	Current market table: filter by `class`, `quality`, `q`, `ids=1,2,3`; sort and page
`/v1/houses/{key}/items/{id}/history?from&to&resolution=day`	Price history (hourly up to 62 days, daily for longer)
`/v1/houses/{key}/items/{id}/stats`	Market value, 60-day value, trend, sold per day
`/v1/houses/{key}/items/{id}/auctions`	The item's individual auctions right now
`/v1/items/{id}/houses?region=us`	The item's price in every house of a region
`/v1/houses/{key}/movers?window=24`	Biggest risers and fallers
`/v1/houses/{key}/deals?mode=market`	Auctions below market value (or `mode=vendor`: below vendor price)
`/v1/houses/{key}/shopping?items=2589:20,2770:5`	Price a shopping list against current auctions
`/v1/houses/{key}/crafting?profession=197`	Recipes ranked by profit
`/v1/houses/{key}/overview?window=24`	Every category: gold listed, sold per day, price change
`/v1/items/{id}/icon`	Item icon (JPEG)

Responses are JSON. Errors come back as {"error": "..."} with a 4xx/5xx status. Too many requests gets 429 with Retry-After. Browsers on any site may call the API (CORS is open). The full reference is in the project's docs/api.md.

MCP server for AI assistants

Forever AH speaks the Model Context Protocol, so an assistant such as Claude can look up WoW: Forever prices for you. Add a remote (Streamable HTTP) MCP server with this URL:

https://forever-ah.com/mcp

No sign-in is needed. Tools:

Tool	Does
`search_items`	Name → item id
`get_item_price`	Lowest, median, market value, trend, sold per day, vendor price, cheapest house
`get_price_history`	Daily or hourly history
`find_deals`	Underpriced auctions
`market_movers`	Biggest price changes
`price_shopping_list`	Cost of a list of items and quantities
`crafting_profit`	Profitable recipes
`list_houses`	Houses and their names for the `house` argument (`us-all`, `eu-113`, ...)

For example, ask: "What's linen cloth worth on WoW Forever in the US right now, and is it cheaper to buy bolts or make them?"

Estimates

Market value is a 14-day average of each day's 10th-percentile price, with recent days counting more. Sold per day counts auctions that disappeared between hourly snapshots while they still had at least 2 hours left: those were bought or cancelled, so treat it as an estimate.

Data: Blizzard Battle.net API. World of Warcraft is a trademark of Blizzard Entertainment, Inc. Not affiliated with Blizzard.