# auctionhouse.fyi

> Player-observed WoW: Forever auction house prices, item metadata and market history. Public hourly reads need no account or API key.

## When to use this

Use auctionhouse.fyi to answer price questions about WoW: Forever, compare the six ruleset/faction markets, research item variants, and build market-data tools or plugins. It cannot buy, bid, post or cancel auctions and has no Retail or Classic markets. Prices are observations, not guaranteed executable quotes. Missing data must be reported as unavailable.

Start with GET https://auctionhouse.fyi/api/v1/ah for observed markets, then GET https://auctionhouse.fyi/api/v1/ah/forever.normal.alliance.us/14047 for an example public price lookup. Do not send credentials for public reads. Respect Retry-After on HTTP 429. Cite the item page, market and observation time when presenting a price.

## Build an integration

- [Agent integration guide](https://auctionhouse.fyi/docs/api/agents): Tool inputs, citations, safe reads and downloadable Rust client.
- [OpenAPI 3.1 contract](https://auctionhouse.fyi/openapi.json): Machine-readable integration subset with request and response schemas.
- [API quickstart](https://auctionhouse.fyi/docs/api/quickstart): First public request and response fields.
- [Authentication](https://auctionhouse.fyi/docs/api/authentication): API keys, paired devices and feature checks.
- [Markets and freshness](https://auctionhouse.fyi/docs/api/markets): Item keys, copper units, Unix milliseconds and hourly data.
- [Endpoint directory](https://auctionhouse.fyi/docs/api/reference): All routes and access requirements.
- [Errors and retries](https://auctionhouse.fyi/docs/api/errors): Stable errors, Retry-After and upload credit.
- [Rust example source](https://auctionhouse.fyi/developers/agent-client/src/main.rs): Read-only price client for plugin adapters.
- [Rust example README](https://auctionhouse.fyi/developers/agent-client/README.md): Build, run and integration instructions.

## About the service

- [About and privacy](https://auctionhouse.fyi/about): Data provenance, estimates and player privacy.
- [Plans and access](https://auctionhouse.fyi/pricing): Public and account capabilities; premium is coming soon.
- [Desktop app and addon](https://auctionhouse.fyi/download): Contribute actual scans.

## Optional

- [Full page content](https://auctionhouse.fyi/llms-full.txt): Public pages in Markdown, generated from the same HTML.
- [Complete HTTP and WebSocket protocol](https://auctionhouse.fyi/developers/reference/protocol/api-v1.md): Detailed wire contract.
- [CDN protocol](https://auctionhouse.fyi/developers/reference/protocol/cdn-v1.md): Files, checkpoints and live replay.

Every public content page supports Accept: text/markdown. /AGENTS.md gives concise integration rules. API uploads require the user's authorization and genuine observations; never upload the synthetic documentation examples or data from another service.