API
Donut API logo
Unofficial. Open now, no key needed.See status

DonutSMP won't give us an API.So we took the job.

Our bots sit in DonutSMP and read the auction house and the buy orders every five minutes. You get the result as JSON over plain HTTP.

Read the docs See plans
GET/v1/ah/itemsReal data, trimmed to three items
{
  "snapshot": { "at": 1794383619041, "pages": 80, "complete": false },
  "items": [
    { "item": "ender_chest", "listings": 201,
      "lowest_unit_price": 18500, "total_count": 201 },
    { "item": "written_book", "listings": 106,
      "lowest_unit_price": 1000, "total_count": 106 },
    { "item": "spruce_slab", "listings": 89,
      "lowest_unit_price": 62.5, "total_count": 5548 }
  ]
}

Donut API is an independent project. It is not official and not affiliated with DonutSMP. Without a key you get 10 calls per minute. Free keys are in the dashboard.

Player lookup

Look up a player

Type a player name to read their stats straight from the game: money, shards, kills, deaths, playtime, blocks and mobs.

Java names, or Bedrock names with their leading dot.

Values are rounded the way the game shows them. Source: /v1/player/<name>, in beta.

Account verification

Prove who owns an account

Know that a visitor really owns the Minecraft account they claim, with one small payment made in the game. No password, no mod, nothing to type in the chat.

  1. The API picks a player and a sumA player picked at random and a small amount, between $11 and $989 of game money.
  2. Your visitor runs one commandThe /pay command you show them, typed in the game from the account they want to prove.
  3. The account is verifiedThe API sees the payment in the game, and the link turns verified a few seconds later.

What your visitor sees

Example
/pay ExamplePlayer 427

verifiedA few seconds after the payment shows up in the game.

  • Nobody writes to them.
  • Nobody follows them.
  • The only name they see is the player they pay.
  • Nothing to type in the chat.

ExamplePlayer and the amount are made up. The real ones are picked again for each verification.

Who gets the moneyYour visitor pays the amount, plus the 2% tax that DonutSMP adds to the payer. The money goes to the player who was picked, never to Donut API and never to you.
Try it with your account Read the docs Trying it is the sign-in of the dashboard, with the same steps. Developers use POST /v1/links, with a key.
Live market

What the market looks like

Both boards read the API live, from this page: the auction house on the left, the in-game money leaderboard on the right.

Baltop

Loading

    From the in-game money leaderboard. Amounts are rounded by the game. Source: /v1/leaderboard/money, in beta.

    Live chat

    What players are saying

    The public chat of the server, as it happens. Player names are never exposed: every author is an anonymous id.

    Public chat

    Starting

    Unfiltered messages written by players. Type several words to search the whole chat history for the messages that contain all of them, or click an author to see only their messages. The feed pauses itself after three minutes. Source: /v1/chat.

    Price history

    How prices moved

    The lowest listed price of an item over time, live from the history route. The tabs are the most valuable items our bots search in the game.

    Loading.

    Why it exists

    What you get

    DonutSMP disabled its official API in 2026. API keys were first restricted to ranked players on July 3, 2026, then DonutSMP staff announced on September 29, 2026 that it was fully disabled, for abuse and safety reasons. In the game, the /api command now answers that the API has been disabled. Donut API is an independent, unofficial replacement that provides the same kind of data through bots in the game.

    Fresh data

    Every few minutes our bots read the auction house and the orders, and search the most traded items one by one to get their real lowest price. Each response says when it was read and where it comes from.

    History

    We keep every snapshot. Ask for an item's price and listing count over the last few hours and plot it yourself.

    Dead simple

    GET requests, JSON back, Minecraft item ids like diamond and netherite_ingot. Works from any language without an SDK.

    Routes

    The routes

    Read only routes for the auction house, orders, price history and the public chat, plus two in beta: the money leaderboard and player stats. Account linking and payments between players use POST and need a key.

    Full reference
    GET/v1/statusWhen the last snapshots were taken and how big they were. GET/v1/status/historyPlayers, latency and outages of the DonutSMP servers over time. GET/v1/ahAuction house offers from the latest snapshot. GET/v1/ah/itemsOne summary line per item: listings, lowest unit price, total count. GET/v1/ordersOpen buy orders with price, wanted and delivered amounts. GET/v1/historyPrice and listing counts over time. GET/v1/chatThe public chat, with anonymous authors and keyword search. GET/v1/chat/dailyDaily chat stats: most said words, most active chatter, busiest hour. BETA/v1/leaderboard/moneyRichest players, ranked by balance. BETA/v1/player/<name>One player: money, shards, kills, deaths, playtime and more. BETA/v1/staffDonutSMP staff members our bots know, and who is seen online. POST/v1/linksProve that a visitor owns a Minecraft account, with a small payment made in the game. Needs a key. POST/v1/paymentsKnow when a player has paid another player in the game. Needs a key. GET/v1/tx/<id>Follow one payment step by step, with the time of each step. GET/v1/chainThe public chain of payment steps, with hashes anyone can check. POST/v1/trackersFollow one player: joins, leaves, payments and purchases. Pro plan.
    Under the hood

    How it works

    We do the collecting. You only talk to a cached HTTP API.

    1. We collectBots read the auction house and orders every five minutes and store each snapshot.
    2. We serveA cached API sits in front, with an API key and a monthly quota per plan.
    3. You buildPrice trackers, flipping tools, Discord bots, dashboards: whatever you want, fed by a GET.

    Open now, no key needed

    Call https://api.donutapi.app from anything that speaks HTTP, at 10 calls per minute without a key. Free keys are in the dashboard, and paid plans are coming.

    Read the docs Get a free key See plans