Buy orders

List order fills

Every delivery to a buy order: what, how many and for how much.

GET/v1/orders/fills

Each entry is one delivery: items handed to a buy order and the money it paid out. This is the closest thing to a trade log DonutSMP has. Sum quantity and paid per product and day to get real volume, or divide them to get the price items actually traded at.

Authentication

API key with the read scope

Cached for

20 s

Data updates

New entries with every buy order refresh. Kept forever.

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

Response200OK

{
  "limit": 2,
  "next": "MTc5MjcyNzk2MDEwMi4zNjYzMTM5",
  "entries": [
    {
      "orderId": 3919185,
      "product": {
        "key": "piglin_head",
        "item": "piglin_head",
        "name": "Piglin Head",
        "variant": "",
        "category": "drops",
        "details": null
      },
      "at": 1792727960102,
      "quantity": 1,
      "paid": 2600000,
      "unitPrice": 2600000
    },
    {
      "orderId": 3916392,
      "product": {
        "key": "raw_iron_block",
        "item": "raw_iron_block",
        "name": "Block of Raw Iron",
        "variant": "",
        "category": "blocks",
        "details": {
          "customName": "Blocks of Raw Iron"
        }
      },
      "at": 1792727960102,
      "quantity": 1,
      "paid": 1400,
      "unitPrice": 1400
    }
  ]
}

Try itCounts towards your plan

Query parameters

itemstringoptional
Exact item id such as diamond_sword. Matches every variant of the item.
productstringoptional
Exact product key such as diamond_sword[sharpness:5]. Matches that variant only. URL encode the brackets.
fromtimestampoptional
Only entries at or after this time, in Unix milliseconds.
totimestampoptional
Only entries before this time, in Unix milliseconds.
limitintegeroptionaldefault 100
Entries per page.
1 to 1,000
cursorstringoptional
The next value from the previous response. Leave it out for the first page. See cursors.

Response

A feed of fills, newest first. from and to apply to at.

limitinteger
Entries per page.
nextstring | null
Pass this as cursor to get the next page. null on the last page.
entriesFill[]
The entries on this page, newest first.
ShowHide6 child fields
- orderIdinteger
  The buy order that received the items.
- productProduct
  What was delivered.
  ShowHide6 child fields
  - keystring
    Unique product key: the item id, plus the variant in square brackets when there is one. Examples: diamond, elytra[mending,unbreaking:3], potion[poison]. Use it with product= filters and /v1/items/{key}.
  - itemstring
    Minecraft item id without the minecraft: namespace, for example netherite_sword. Many products can share one item id.
  - namestring
    Display name, for example Potion of Poison.
  - variantstring
    What sets this product apart from the plain item. Empty for plain items. See variants for the rules.
  - categorystring | null
    One of combat, tools, valuables, drops, food, potions, blocks or misc.
  - detailsProductDetails | null
    Structured extras such as enchantments, shulker box contents or a custom name.
    ShowHide5 child fields
    enchantmentsEnchantment[]
    Enchantments on the item itself, sorted by id. Left out when there are none.
    storedEnchantmentsEnchantment[]
    Enchantments stored in an enchanted book. Left out for every other item.
    contentsContainerEntry[]
    What a shulker box holds, one entry per item id with counts added together, largest first.
    customNamestring
    The name shown in game when it differs from the default item name. DonutSMP renames some items, for example Dried Ghast on a skeleton skull.
    flightDurationinteger
    Flight duration of a firework rocket, from 1 to 3.
- attimestamp
  When the delivery was recorded.
- quantityinteger
  Items delivered.
- paidnumber
  Money the order paid out for them.
- unitPricenumber | null
  paid divided by quantity.

Status codes

Status	When
400Bad Request	A filter or the `cursor` is malformed.