Players

List players

Browse players by balance, by recent refreshes or by popularity.

GET/v1/players

Pages through every player on record. With sort=money you get the richest players first, which covers everyone with a known balance, not only the baltop. sort=recent shows the players whose stats were refreshed most recently and sort=trending shows the most viewed profiles on DonutStats over the last 7 days.

Use q to narrow the list to usernames that start with some letters.

Authentication

API key with the read scope

Cached for

30 s

Data updates

Balances update with every lookup and every leaderboard update.

curl "https://api.donutstats.io/v1/players?limit=3" \
  -H "x-api-key: $DONUTSTATS_API_KEY"

Response200OK

{
  "page": 1,
  "limit": 3,
  "total": 144624,
  "updatedAt": null,
  "entries": [
    {
      "username": "Abuodee",
      "uuid": "e9cbdbda-bc07-4cb5-8ad5-793a20b33dbd",
      "money": 4800000000000,
      "playtime": 14745600,
      "kills": 8000,
      "statsUpdatedAt": 1792722587957,
      "views7d": 679
    },
    {
      "username": "Wampiptiii01",
      "uuid": "f6a98cc5-86ee-4f24-b980-600aa81bcff2",
      "money": 3900000000000,
      "playtime": 12416400,
      "kills": 3100,
      "statsUpdatedAt": 1792722180270,
      "views7d": 118
    }
  ]
}

Try itCounts towards your plan

Query parameters

sortstringoptionaldefault money
money: richest first. recent: most recently refreshed stats first. trending: most viewed in the last 7 days.
moneyrecenttrending
qstringoptional
Only usernames starting with this, case insensitive. Ignored when sort is trending.
pageintegeroptionaldefault 1
Page to return, starting at 1.
1 to 100,000
limitintegeroptionaldefault 50
Entries per page.
1 to 200

Response

A page of player summaries. updatedAt is always null here.

pageinteger
The page you asked for, starting at 1.
limitinteger
Entries per page.
totalinteger
Entries across every page that match your filters.
updatedAttimestamp | null
When the underlying data last changed. null where it does not apply.
entriesPlayerSummary[]
The entries on this page.
ShowHide7 child fields
- usernamestring
  Username with its current capitalization.
- uuidstring | null
  Minecraft UUID, once known.
- moneynumber | null
  Balance in DonutSMP dollars.
- playtimeinteger | null
  Playtime in seconds.
- killsinteger | null
  Player kills.
- statsUpdatedAttimestamp | null
  When the player's full stats were last refreshed.
- views7dinteger
  Profile views on DonutStats in the last 7 days.