Auction Oracle

Economic intelligence for World of Warcraft: Forever. Auction Oracle is a local application that collects prices, history and recipes from several sources and turns them into decisions:

what to buy now;
what to sell, craft or keep;
which resources may become scarce;
how to deploy a given amount of capital.

Each figure is labelled OBSERVED, ESTIMATED, PREDICTED or UNKNOWN, with its source and an explanation. When data is missing, the app says so instead of inventing a price.

Auction Oracle never acts in the game for you: no bot, no automatic buying, no injection. It is an analysis tool.

Quick start (Windows)

Install: double-click install.bat.
Python 3.11+ is required. If it is missing: winget install --id Python.Python.3.12 --scope user.
The script creates an isolated environment in %USERPROFILE%\.auction-oracle\venv, installs the dependencies and runs a diagnostic.
Start: double-click start.bat. The app opens at http://127.0.0.1:8765.
It collects automatically every 60 minutes while the window stays open.
Check: diagnose.bat shows the live state of every source (API) and every engine.
Back up: backup.bat takes a consistent copy in data\backups (the 14 most recent are kept).
Restore: scripts\restore.bat <file>.
Update: scripts\update.bat.

The first collection runs about 10 seconds after start-up. You can also click Collect now in the top bar.

Data sources (as of 2026-11-05)

Source	Status	Used for
auctionhouse.fyi	✅ public, hourly	AH prices (US Normal/PvP Horde markets), 7 days of history, full item catalogue with NPC prices
Everloot	✅ public	game-file recipe graph (3,900 recipes), vendor prices reported by players
Blizzard API	⚠️ the Forever auctions endpoint returns 404	connector ready; it switches on as soon as Blizzard opens the route (your Battle.net credentials)
ForeverDB	🔑 personal key	exact recipe quantities
wow.gg	❌ 403	monitored
AuctionOracle addon	✅ local	full order book (market depth), your exact recipes
CSV/JSON import, manual entry	✅	your own data

Details and endpoint tests: docs/RESEARCH_REPORT.md.

Documentation

User guide: every screen, daily workflow, interpreting the scores.
Developer guide: architecture, adding a connector, tests.
Architecture and SaaS architecture.
WoW addon.
Final audit report.

Command line

python -m auction_oracle serve | collect | diagnose | evaluate | backtest | backup | restore <file> | export <dir> | import-addon <file>

Licences and attribution

Prices: auctionhouse.fyi (player contributions).
Recipes: data from Everloot (https://everloot.app), CC BY-SA 4.0.

Auction Oracle is not affiliated with Blizzard Entertainment.