Shard shop

Get the shard shop

What the shard shop sells and what one shard is worth in money.

GET/v1/shards

Lists every shard shop offer with the market price of the item, so you can see which offers are the best value. perShard at the top level is the median money value of one shard across the permanent offers. Rotating offers are flagged temporary and left out of that figure.

Authentication

API key with the read scope

Cached for

5 min

Data updates

Once a day.

curl "https://api.donutstats.io/v1/shards" \
  -H "x-api-key: $DONUTSTATS_API_KEY"

Response200OK

{
  "updatedAt": 1792722565722,
  "perShard": 14866.666666666668,
  "offers": [
    {
      "key": "netherite_shovel[efficiency:5,fortune:3,mending,unbreaking:3]",
      "item": "netherite_shovel",
      "name": "Netherite Shovel",
      "shards": 1500,
      "temporary": true,
      "details": {
        "enchantments": [
          {
            "id": "efficiency",
            "level": 5
          },
          {
            "id": "fortune",
            "level": 3
          }
        ]
      },
      "marketPrice": 6300000,
      "perShard": null
    },
    {
      "key": "netherite_shovel[efficiency:5,mending,silk_touch,unbreaking:3]",
      "item": "netherite_shovel",
      "name": "Netherite Shovel",
      "shards": 1500,
      "temporary": true,
      "details": {
        "enchantments": [
          {
            "id": "efficiency",
            "level": 5
          },
          {
            "id": "mending",
            "level": 1
          }
        ]
      },
      "marketPrice": 5700000,
      "perShard": null
    }
  ]
}

Try itCounts towards your plan

This endpoint takes no parameters.

Response

The shop and the value of a shard.

updatedAttimestamp | null
When the shop was last refreshed.
perShardnumber | null
Median money value of one shard.
offersobject[]
Every offer.
ShowHide8 child fields
- keystring
  Product key of the item on offer.
- itemstring
  Item id.
- namestring
  Display name.
- shardsinteger
  Price in shards.
- temporaryboolean
  true for rotating offers.
- detailsProductDetails | null
  Enchantments and other extras.
  ShowHide5 child fields
  - enchantmentsEnchantment[]
    Enchantments on the item itself, sorted by id. Left out when there are none.
    ShowHide2 child fields
    idstring
    Enchantment id without the minecraft: namespace, for example sharpness.
    levelinteger
    Enchantment level, starting at 1.
  - storedEnchantmentsEnchantment[]
    Enchantments stored in an enchanted book. Left out for every other item.
    ShowHide2 child fields
    idstring
    Enchantment id without the minecraft: namespace, for example sharpness.
    levelinteger
    Enchantment level, starting at 1.
  - contentsContainerEntry[]
    What a shulker box holds, one entry per item id with counts added together, largest first.
    ShowHide2 child fields
    itemstring
    Item id, for example netherite_sword.
    countinteger
    Total number of that item in the box.
  - 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.
- marketPricenumber | null
  Market price of the item on the auction house.
- perShardnumber | null
  Market price divided by shards. null for temporary offers.