List an item's lots

GET/v1/market/items/{slug}/lots

Everything on sale under one item, the cheapest first. 30 lots to a page. A lot describes the item as the seller's inventory did: the protection is the hold and the dispute.

Request

Path parameters

slugstringrequired
The item's slug, from a market card.

Query parameters

phasestring
The phase of a Doppler or Gamma Doppler.
stickersstring
with or without.
float_minstring
The lowest float.
float_maxstring
The highest float.
paint_seedstring
One paint seed.
sortstring
price_desc, float, float_desc or newest. Without it, the cheapest come first.
pagestring
Which page, from 1.

curl 'https://api.rockvel.store/v1/market/items/ak-47-redline-field-tested/lots?float_min=0.15&float_max=0.30' \
  -H "Authorization: Bearer $ROCKVEL_KEY"

Answer 200

lotsobject[]
The lots of this page.
Fields of lots
- idstring
  The lot's id, to buy it by.
- price_centsinteger
  The price in US cents.
- floatnumberoptional
  The float the seller's inventory showed.
- paint_seedintegeroptional
  The paint seed the seller's inventory showed.
- phasestringoptional
  The phase of a Doppler or Gamma Doppler.
- image_urlstring
  The item's picture.
- stickersobject[]optional
  Stickers the seller's inventory showed.
  Fields of stickers
  idintegeroptional
  Its number in the game.
  namestring
  Its name.
  image_urlstringoptional
  Its picture.
  slotinteger
  Which place on the item it takes.
  wearnumberoptional
  How scraped it is, 0 for intact.
  scalenumberoptional
  Its scale, as the game places it.
  rotationnumberoptional
  Its rotation, as the game places it.
  offset_xnumberoptional
  Its offset along x, as the game places it.
  offset_ynumberoptional
  Its offset along y, as the game places it.
  offset_znumberoptional
  Its offset along z, as the game places it.
  tint_idintegeroptional
  Its tint's number in the game.
  patternintegeroptional
  The pattern of a charm.
  highlightintegeroptional
  The moment on a souvenir charm.
- descriptionstringoptional
  What the seller wrote about the lot. Plain text.
- max_discountintegeroptional
  How far below the price, in percent, the seller takes bargains. Left out if they take none.
- sellerobjectoptional
  Who sells it. Left out if their stall is closed.
  Fields of seller
  steam_idstring
  The seller's SteamID64.
  namestring
  The seller's name when the lot went on sale.
  avatar_urlstringoptional
  The seller's avatar when the lot went on sale.
- ownbooleanoptional
  The lot is yours. Left out otherwise.
- listed_atdate-time
  When the lot went on sale.
totalinteger
How many there are on all pages.
page_sizeinteger
How many fit on one page.

{
  "lots": [
    {
      "id": "019a4b9d-2e17-7a58-b1c6-0d3f6a9e4b12",
      "price_cents": 3250,
      "float": 0.2613,
      "paint_seed": 412,
      "image_url": "https://community.akamai.steamstatic.com/economy/image/i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGIGz3UqlXOLrxM-vMGmW8VNxu5Dx60noTyLwlcK3wiFO0POlPPNSI_-RHGavzOtyufRkASq2lkxx4W-HnNyqJC3FZwYoC5p0Q7FfthW6wdWxPu-371Pdit5HnyXgznQeHYY5wyA",
      "stickers": [
        {
          "id": 1693,
          "name": "Sticker | Crown (Foil)",
          "slot": 1,
          "wear": 0.08
        }
      ],
      "max_discount": 10,
      "seller": {
        "steam_id": "76561198012345678",
        "name": "frostbyte",
        "avatar_url": "https://avatars.steamstatic.com/fef49e7fa7e1997310d705b2a6158ff8dc1cdfeb_full.jpg"
      },
      "listed_at": "2026-11-01T07:41:17Z"
    }
  ],
  "total": 14,
  "page_size": 30
}

Any route can also answer with the statuses on the Errors page.