Skip to content
DonutStatsAPI
Sign up
Object

Flip

A buy low, deliver high opportunity.

Flips are simulated against real listings and real buy orders, walking each side of the book until the trade stops paying. Profit is what you would make if you did it right now.

Returned by

GETList flips

Fields

  • kindstring

    direct: buy listings and deliver them to buy orders as they are. craft: buy ingredients, craft, then deliver.

  • productProduct

    What you end up delivering.

    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.

  • makesinteger

    Items one craft makes. 1 for direct flips.

  • ingredientsobject[]

    What you buy for one craft.

    Show3 child fields
    • productProduct

      The ingredient.

      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.

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

    • countinteger

      How many one craft needs.

    • unitCostnumber

      Average price paid per ingredient across the listings used.

  • craftsinteger

    How many times to repeat the flip.

  • quantityinteger

    Items delivered in total.

  • costnumber

    Money spent buying listings.

  • revenuenumber

    Money the buy orders pay out.

  • profitnumber

    revenue minus cost.

  • marginnumber

    profit divided by cost. Flips under 0.03 are left out.

  • listingsUsedinteger

    Listings bought from.

  • ordersUsedinteger

    Buy orders delivered to.

  • topOrdernumber

    The best buy order used, per item.

  • marketPricenumber | null

    Market price of the delivered product.

  • orderSeenAttimestamp | null

    When the best order was last confirmed open.