Donut.Auction

API v1

Access active order listings on DonutSMP programmatically.

Live JSFiddle Example

Code Examples

Rate Limiting

You may fetch all pages once every 30 minutes maximum. Please be respectful of our servers.

Terms of Use

By using this API, you agree to provide visible attribution by linking to donut.auction as the data source in any application, website, or project that uses this data.

Endpoints

GET /orders

Retrieve active order listings from DonutSMP. Uses cursor-based pagination.

Base URL

https://api.donut.auction/orders

Query Parameters

ParameterTypeRequiredDescription
cursorstringNoPagination cursor. Leave empty for the first page.

Response

{
  "orders": [
    {
      "item": {
        "itemId": "diamond",
        "enchantments": []
      },
      "userName": "PlayerName",
      "itemPrice": 4500,
      "amountOrdered": 64,
      "amountDelivered": 10,
      "creationDate": "2026-01-30T12:05:00Z",
      "expirationDate": "2026-02-06T12:05:00Z",
      "lastUpdated": "2026-01-30T12:10:53.741Z"
    },
    {
      "item": {
        "itemId": "enchanted_book",
        "enchantments": [
          { "name": "mending", "level": 1 }
        ]
      },
      "userName": "AnotherPlayer",
      "itemPrice": 20000,
      "amountOrdered": 10,
      "amountDelivered": 2,
      "creationDate": "2026-01-30T12:05:00Z",
      "expirationDate": "2026-02-06T12:05:00Z",
      "lastUpdated": "2026-01-30T12:10:53.866Z"
    }
  ],
  "nextCursor": "eyJJZCI6Ii4uLiJ9"
}

Response Fields

FieldTypeDescription
ordersarrayArray of order objects
orders[].item.itemIdstringMinecraft item identifier
orders[].item.enchantmentsarrayArray of enchantments with name and level
orders[].userNamestringMinecraft username of the buyer
orders[].itemPricenumberPrice per item (in-game currency)
orders[].amountOrderednumberTotal quantity requested
orders[].amountDeliverednumberQuantity already delivered
orders[].creationDatestringISO 8601 timestamp when order was created
orders[].expirationDatestringISO 8601 timestamp when order expires
orders[].lastUpdatedstringISO 8601 timestamp of last update
nextCursorstring | nullCursor for the next page. null if no more pages.

Questions? Reach out on the Donut.Auction Discord.