Skip to main content
GET
/
listings
Live buyable listings
curl --request GET \
  --url https://csboard.com/v1/listings \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "id": "itm_8841201",
      "market_hash_name": "AK-47 | Redline (Minimal Wear)",
      "wear": "Minimal Wear",
      "doppler_phase": null,
      "float_value": 0.0912,
      "paint_seed": 412,
      "stickers": [
        {
          "name": "Crown (Foil)",
          "image": "https://cdn.csboard.com/stickers/crown_foil.png",
          "slot": 0,
          "wear": 0
        }
      ],
      "price_usd": 14.37,
      "category": "Rifle",
      "rarity": "Classified",
      "image": "https://cdn.csboard.com/items/ak47_redline_mw.png",
      "inspect_link": "steam://rungame/730/76561202255233023/+csgo_econ_action_preview%20...",
      "tradable": false,
      "tradable_at": "2026-07-06T12:00:00Z",
      "delivery": "hold"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

Authorizations

​
Authorization
string
header
required

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

Query Parameters

​
search
string

Full-text match on market hash name.

​
category
string

e.g. Rifle, Knife, Gloves.

​
wear
enum<string>

Item wear bucket.

Available options:
Factory New,
Minimal Wear,
Field-Tested,
Well-Worn,
Battle-Scarred
​
rarity
string

e.g. Classified, Covert.

​
min_price
number

Minimum price in USD.

​
max_price
number

Maximum price in USD.

​
min_float
number

Minimum float value.

​
max_float
number

Maximum float value.

​
stat_trak
enum<string>

Filter StatTrak™ items.

Available options:
only,
exclude
​
souvenir
enum<string>

Filter Souvenir items.

Available options:
only,
exclude
​
sort
enum<string>
default:id

Sort order. Default id.

Available options:
id,
newest,
price_asc,
price_desc
​
cursor
string

Keyset cursor from next_cursor.

​
limit
integer
default:50

1–200. Default 50.

Required range: 1 <= x <= 200

Response

A page of listings.

​
items
object[]
required
​
next_cursor
string | null
required

Pass back as cursor to fetch the next page. Null on the last page.