DonutSMP API — Public Market & Stats API

DonutSMP public API

Free, read-only access to the DonutSMP economy — the same data that powers the market terminal and the stats pages. JSON over HTTPS, no SDK required.

Base URLhttps://api.donutsmp.design/v1

Auth headerX-API-Key: <your-key>

Rate limit120 req / min per key

Formatapplication/json · UTF-8

Get a free API key with /api key create in-game or via the support page. Prices are returned in in-game dollars. See the documentation for guides and examples.

Market · List all item markets

GEThttps://api.donutsmp.design/v1/market/items

Returns every tracked item market with its current price, 24h change, volume and listing count. Sorted by 24h volume by default.

Parameters

sortquery · stringprice · change24h · volume24h · listings (default volume24h)

directionquery · stringasc or desc (default desc)

limitquery · int1–200 results per page (default 50)

cursorquery · stringPagination cursor from the previous response

Example request

curl -H "X-API-Key: <your-key>" \
  https://api.donutsmp.design/v1/market/items

Example response · 200

{
  "data": [
    {
      "symbol": "SPWN",
      "name": "Spawner",
      "price": 1250000.0,
      "change24h": 4.2,
      "volume24h": 84213000,
      "listings": 312,
      "stackSize": 64
    }
  ],
  "cursor": "eyJvZmZzZXQiOjUwfQ",
  "total": 1120
}