DonutStats API
DonutSMP players, leaderboards, markets and the economy as clean JSON. Live right now, and all the way back to day one.
The DonutStats API is the data behind donutstats.io, open to your own apps. It is a read only REST API: every endpoint is a GET, every response is JSON, and every list tells you how fresh it is.
Use it for Discord apps that look players up, price trackers, flip finders, leaderboard sites, economy dashboards or research. Accounts are free and come with 20 requests an hour. The Pro plan removes the cap for $8 a month.
curl "https://api.donutstats.io/v1/leaderboards/money?limit=3" \
-H "x-api-key: $DONUTSTATS_API_KEY"https://api.donutstats.io/v1The version is part of the path. New fields and new endpoints are added to version 1 without notice, so ignore keys you do not recognise. Anything that would break existing code ships as /v2 instead.
Every data endpoint needs an API key in the x-api-key header. Create an account to get one, then follow the quickstart.
- Overview3Health checks, counts and freshness of every dataset.
- Players6Profiles, live stats, listings, stat history and rank history.
- Leaderboards4Every leaderboard today, plus every snapshot ever recorded.
- Auction house5Every live listing, deals, and every listing that ever closed.
- Buy orders4Every open buy order, every closed one and every delivery.
- Items and prices4Market prices, movers and full price history for every product.
- Flips1Profitable trades between the auction house and buy orders.
- Bounties2Every open bounty and every bounty that ever closed.
- Shard shop1Shard shop offers and what a shard is worth.
- Economy2Money supply, inequality, market totals and their full history.
- Server3Players online, latency, peaks, uptime and every check ever made.
- Images3Share cards for players, items and leaderboards, rendered as PNG.
Most datasets come in two forms:
Nothing is thrown away
Closed listings, closed orders, fills, prices, player stats, leaderboard snapshots, bounties, economy samples and server checks are all kept. Read historical data to page through them.
- QuickstartMake your first request in under a minute.
- AuthenticationAccounts, API keys, scopes and keeping keys safe.
- Rate limits and plansFree and Pro plans, limits, headers and handling 429s.
- Historical dataEvery listing, order, fill, price and snapshot ever recorded.
- Data conventionsTimestamps, money, product keys, variants and stats.
- PaginationPage numbers for live lists, cursors for history.
- Caching and freshnessETags, cache headers and how often each dataset updates.
- Live lookupsHow player stats are refreshed on demand.
- ErrorsEvery status code and what to do about it.