Skip to content
DonutStatsAPI
Sign up
Object

ClosedListing

A listing that has left the auction house.

Returned by GET /v1/auction/history, which keeps every listing that ever closed. The auction house does not say whether a listing sold or was cancelled, so treat these as likely sales and look at how long they were up.

Returned by

GETList recently closed listingsGETList auction history

Fields

  • idinteger

    Stable id of the listing. It never changes or gets reused.

  • productProduct

    What is being sold.

    Show6 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.

      Show5 child fields
      • enchantmentsEnchantment[]

        Enchantments on the item itself, sorted by id. Left out when there are none.

        Show2 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.

        Show2 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.

        Show2 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.

  • countinteger

    Stack size, from 1 to 64.

  • pricenumber

    Asking price for the whole stack.

  • unitPricenumber

    Asking price per item: price divided by count.

  • detailsProductDetails | null

    Details of this exact stack. They can carry more than the product does, such as the full contents of a shulker box.

    Show5 child fields
    • enchantmentsEnchantment[]

      Enchantments on the item itself, sorted by id. Left out when there are none.

      Show2 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.

      Show2 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.

      Show2 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.

  • firstSeenAttimestamp

    When the listing first appeared.

  • lastSeenAttimestamp

    When the listing was last confirmed on the auction house.

  • sellerstring | null

    Username of the seller, once known. null until then.

  • closedAttimestamp

    When the listing left the auction house: it sold, was cancelled or expired.