DonutSMP data,
one request away.
Players, leaderboards, every auction listing, every buy order, prices, flips, bounties and the whole economy. Live right now, and all the way back to day one.
https://api.donutstats.io/v1curl "https://api.donutstats.io/v1/players/Abuodee?lookup=none" \
-H "x-api-key: $DONUTSTATS_API_KEY"{
"player": {
"username": "Abuodee",
"uuid": "e9cbdbda-bc07-4cb5-8ad5-793a20b33dbd",
"stats": {
"money": 4800000000000,
"shards": 128000,
"kills": 8000,
"playtime": 14745600
},
"ranks": {
"money": {
"rank": 1,
"value": 4800000000000,
"updatedAt": 1792694462533
}
},
"presence": {
"online": false,
"lastOnlineAt": 1792694335419
},
"statsUpdatedAt": 1792722587957
},
"lookup": {
"status": "skipped",
"checkedAt": 1792722587957
}
}458K+
players on record
111K+
live auction listings
14K+
open buy orders
2.7K+
priced products
Everything in the API
12 resources and 38 endpoints. All GET, and everything but the images is JSON.
- 3 endpoints
Overview
Health checks, counts and freshness of every dataset.
- /v1
- /v1/status
- /health
- 6 endpoints
Players
Profiles, live stats, listings, stat history and rank history.
- /v1/players
- /v1/players/search
- /v1/players/{username}
- 4 endpoints
Leaderboards
Every leaderboard today, plus every snapshot ever recorded.
- /v1/leaderboards
- /v1/leaderboards/{board}
- /v1/leaderboards/{board}/snapshots
- 5 endpoints
Auction house
Every live listing, deals, and every listing that ever closed.
- /v1/auction
- /v1/auction/deals
- /v1/auction/summary
- 4 endpoints
Buy orders
Every open buy order, every closed one and every delivery.
- /v1/orders
- /v1/orders/summary
- /v1/orders/history
- 4 endpoints
Items and prices
Market prices, movers and full price history for every product.
- /v1/items
- /v1/items/movers
- /v1/items/{key}
- 1 endpoint
Flips
Profitable trades between the auction house and buy orders.
- /v1/flips
- 2 endpoints
Bounties
Every open bounty and every bounty that ever closed.
- /v1/bounties
- /v1/bounties/history
- 1 endpoint
Shard shop
Shard shop offers and what a shard is worth.
- /v1/shards
- 2 endpoints
Economy
Money supply, inequality, market totals and their full history.
- /v1/economy
- /v1/economy/history
- 3 endpoints
Server
Players online, latency, peaks, uptime and every check ever made.
- /v1/server
- /v1/server/history
- /v1/server/samples
- 3 endpoints
Images
Share cards for players, items and leaderboards, rendered as PNG.
- /v1/images/player/{username}.png
- /v1/images/item/{key}.png
- /v1/images/leaderboard/{board}.png
Live now, and everything before it
Live
New auction listings and buy orders show up within about a minute. Player stats refresh on request, while you wait.
Every day since day one
Closed listings, filled orders, prices, stats, leaderboards and the economy are never thrown away. Page back as far as you like.
Timestamps on everything
Every list says when it last changed and every record says when it was first and last seen, so you always know how fresh an answer is.
Share cards, ready to embed
Cards for any player, item or leaderboard, the same style donutstats.io shows in Discord and on X, as a plain PNG URL. No key needed, so they work straight in an image tag, a Discord embed or a README.
Simple pricing
Start free. Upgrade when your app needs more than 20 requests an hour.
Free
$0forever
For trying the API and small personal projects.
- 20 requests per hour
- Every endpoint, including all history
- Up to 5 API keys
- Live player lookups
Pro
Unlimited$8per month
For Discord apps, websites and dashboards that run all day.
- Unlimited requests
- Bursts up to 300 requests per minute
- Every endpoint, including all history
- Up to 5 API keys
- Cancel any time from your dashboard