Sign in
Documentation / Get started

WoW: Forever auction data API

Read player-sourced WoW: Forever auction prices over HTTP — no Blizzard key required. Start with the Rust client and example use cases.

For tool builders

WoW: Forever has no auction house API, so the prices here come from player-sourced uploads: scans contributed by players with the free addon and desktop app. Public reads need no key — there is no Blizzard key to request.

Start building

Connecting an assistant or building a plugin? Use our MCP server for market answers, charts and account tools, or start with the OpenAPI contract.

How the data moves

  1. 01 · OBSERVERead auctionsWoW: Forever addon
  2. 02 · TRANSFERExport a bookPixel strip → desktop
  3. 03 · INGESTUpload oncePOST /ah/books
  4. 04 · BUILDRead the marketPrices, depth & history

Each scan captures the observed auction listings as an order book. The same scan feeds the price table, historical candles and order-book views.

The essentials

Base URLHTTPS
https://auctionhouse.fyi/api/v1
FormatJSON
Unix milliseconds for HTTP timestamps. Integer copper per item for prices. Gzip supported for uploads.
AuthenticationBearer
Public reads need no key. Uploads need a paired device token or an API key with api.upload. Set up authentication →
ScopeWoW: Forever
Six separate markets. Player-observed auction facts only; never seller, bidder or character names.

Versioned contracts and runnable examples live with the source specification →.