API documentation
Albion Market exposes a public JSON API so scripts and AI agents can search items, fetch live prices, and compute the same arbitrage and route opportunities as the website. No API key. 100 requests per minute per client.
Discovery
- /openapi.json — OpenAPI 3.1 spec
- /llms.txt and /llms-full.txt — agent-oriented guides
- /.well-known/api-catalog — RFC 9727 service catalog
Endpoints
| Method | Path | Purpose |
|---|---|---|
| GET | /api/items?q=bag | Search the item catalog by display name. Use the returned id with the other endpoints. |
| GET | /api/prices?items=T4_BAG&server=west | Raw city and quality prices. Requires a unique item name, not a numeric id. |
| GET | /api/arbitrage?item=T4_BAG | Lowest sell order versus highest buy order per server and quality. |
| GET | /api/routes?item=T4_BAG&origin=Caerleon | City-to-city hops with optional fees, distance cap, and sort. |
| GET | /api/health | Service status plus links to OpenAPI and llms.txt. |
Suggested workflow
- Search names:
GET /api/items?q=bag - Copy a unique id such as
T4_BAG - Fetch prices or computed trades with
/api/prices,/api/arbitrage, or/api/routes
Errors include a machine-readable code. On ITEM_NOT_FOUND, retry with suggestion or search again. On RATE_LIMITED or UPSTREAM_TIMEOUT, wait retryAfter seconds.
Human tools live on Home, Arbitrage, and Routes. Market data comes from the Albion Online Data Project.