GET /v1/listings — Browse Live CS2 Marketplace Listings

GET

listings

Live buyable listings

curl --request GET \
  --url https://csboard.com/v1/listings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/listings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://csboard.com/v1/listings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://csboard.com/v1/listings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/listings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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="
}

{
  "code": "unauthorized",
  "message": "Missing or invalid API key."
}

{
  "code": "rate_limit_exceeded",
  "message": "Too many requests."
}

The listings endpoint exposes every buyable item currently on the CSBoard marketplace. Each record includes the complete inspection data you need for evaluation — float value, paint seed, applied stickers with their wear — alongside the authoritative asking price in USD. Results are paginated using a keyset cursor so you can reliably walk the full catalog even as new listings arrive. Authentication required. Send your key as Authorization: Bearer csb_pub_....

Query parameters

string

Fuzzy match on the item’s market_hash_name — splits the query into words and substring-matches each, ideal for discovery. Note: a name whose words are a subset of a longer item’s name (e.g. Spectrum Case vs Spectrum 2 Case) cannot be isolated this way. For a single specific item, use name.

string

Exact market_hash_name (case-insensitive). The precise way to fetch one specific item’s listings — name=Spectrum Case returns only Spectrum Case, never Spectrum 2 Case. Takes precedence over search when both are supplied.

string

Filter by item category, e.g. Rifle, Knife, Gloves, Pistol.

string

Filter by wear bucket. One of: Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred.

string

Filter by rarity tier, e.g. Classified, Covert, Extraordinary.

number

Minimum asking price in USD (inclusive).

number

Maximum asking price in USD (inclusive).

number

Minimum float value (inclusive). Accepts values from 0.0 to 1.0.

number

Maximum float value (inclusive). Accepts values from 0.0 to 1.0.

string

Delivery bucket — the same three the site’s own grid shows. One of:

instant — bot fulfilment. Seconds to a few minutes.
up_to_12h — a human seller on the source market has to send the trade. Displayed as ≤12h on the site.
hold — inside a Steam trade lock until the item’s tradable_at.

Use delivery=instant for any flow that must deliver now — a withdrawal, a bot payout, a user waiting on a screen. Any other value is a 400, so a typo fails loudly instead of quietly widening your results.

number

Only listings whose refund_percent is at least this (0–100). Listings with no published figure are excluded, not assumed.?delivery=instant&min_refund_percent=100 is the pool a withdrawal flow wants: ships immediately, and a Steam reversal costs nobody anything.

string

StatTrak™ filter. only returns only StatTrak™ items; exclude removes them from results.

string

Souvenir filter. only returns only Souvenir items; exclude removes them from results.

string (ISO 8601)

Only return listings that entered the catalogue after this timestamp — the delta-poll parameter. Pair it with sort=newest and the usual response is an empty page, which is what makes frequent polling cheap instead of a full rescan every tick.Overlap your watermark by ~60 seconds and dedupe by id. Send max(listed_at) - 60s, never the bare maximum. Timestamps come from the start of the database transaction that published the listing, so a large batch can commit rows stamped earlier than rows a smaller, later batch already committed — a watermark advanced to the exact maximum steps over those listings permanently.

string

default:"id"

Sort order. One of: id (stable default), newest, price_asc, price_desc. newest orders by listed_at, so re-listings surface alongside genuinely new inventory.

string

Keyset pagination cursor. Pass the next_cursor value from the previous response to fetch the next page.

integer

default:"50"

Number of results per page. Minimum 1, maximum 200.

Response fields

Listing[]

required

Array of listing objects for this page.

Show Listing object

string

required

Stable listing identifier. Pass this to POST /v1/orders to purchase the item.

string

required

Steam market hash name, e.g. AK-47 | Redline (Minimal Wear).

string | null

Wear bucket: Factory New, Minimal Wear, Field-Tested, Well-Worn, or Battle-Scarred. null for items without wear (e.g. some knives or gloves).

string | null

Doppler or Gamma Doppler phase, e.g. "Phase 2", "Ruby", "Emerald". null for non-Doppler items.

number | null

Item float value between 0.0 and 1.0. null if not applicable.

integer | null

Paint seed (pattern index). null if not applicable.

Sticker[]

required

Applied stickers. Empty array if none.

Show Sticker object

string

Sticker name, e.g. Crown (Foil).

string (URI)

CDN URL of the sticker image.

integer

Sticker slot position, 0 through 4.

number | null

Sticker wear between 0.0 and 1.0. null if the sticker has not been scraped.

number

required

Authoritative asking price in USD. This is exactly the amount charged if you buy this listing via POST /v1/orders.

string

required

Item category, e.g. Rifle, Knife, Gloves.

string

Rarity tier, e.g. Classified, Covert.

string (URI)

CDN URL of the item image.

string

Steam inspect link (steam://rungame/...) for this item.

boolean

required

Whether the item is currently tradable. false means it is in a trade hold.

datetime | null

ISO 8601 timestamp indicating when the item leaves its trade hold. null if already tradable.

string

required

Expected delivery mode: instant (bot, seconds to minutes), up_to_12h (a human seller on the source market must send the trade), or hold (inside a Steam trade lock until tradable_at).

number | null

How much of the purchase comes back if Valve reverses the Steam trade. This is a property of the market the listing came from, not a support policy, and it ranges from 0 to 100 across our sources.null means we have no published figure for that listing — treat it as unknown, never as 100. Filter with min_refund_percent to build a pool where every item is made whole.

datetime | null

When this item entered the catalogue. Not the same as when the row was created: items return to the catalogue constantly — cancelled orders, expired trade offers, released holds — and a re-listed item is new to you even though it existed before. This is the value to feed back as available_after.

string | null

required

Opaque keyset cursor. Pass this as the cursor query parameter to fetch the next page. null on the last page.

Pagination

This endpoint uses keyset pagination. To walk all pages:

Make the initial request (no cursor).
If next_cursor is non-null, repeat the request with cursor=<next_cursor>.
Stop when next_cursor is null — you have reached the last page.

Keyset pagination is stable: new listings appearing during iteration won’t cause duplicates or skipped rows.

Example request

curl "https://csboard.com/v1/listings?category=Rifle&wear=Minimal+Wear&min_float=0.07&max_float=0.12&sort=price_asc&limit=20" \
  -H "Authorization: Bearer csb_pub_..."

Example response

{
  "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.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="
}

Error codes

HTTP status	Code	Meaning
401	`unauthorized`	Missing or invalid API key.
429	`rate_limit_exceeded`	Over your key’s per-minute limit (100/min by default). Back off for the number of seconds in the `Retry-After` header.

price_usd on each listing is the authoritative buy price — it reflects the live asking price at query time and is exactly what you’ll be charged. Do not use the min_price_usd from the /prices endpoint as a buy-price estimate; that value can lag.

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

string

Full-text match on market hash name.

name

string

Exact market_hash_name (case-insensitive) — the precise single-item lookup. Unlike fuzzy search, it isolates one item even when its name is a word-subset of a longer one (e.g. Spectrum Case vs Spectrum 2 Case). Takes precedence over search.

Response

A page of listings.

items

object[]

required

Show child attributes

next_cursor

string | null

required

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

Live buyable listings

curl --request GET \
  --url https://csboard.com/v1/listings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/listings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://csboard.com/v1/listings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://csboard.com/v1/listings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/listings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "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="
}

{
  "code": "unauthorized",
  "message": "Missing or invalid API key."
}

{
  "code": "rate_limit_exceeded",
  "message": "Too many requests."
}

Market Data

Trading

Account

Webhooks

Status

GET /v1/listings — Browse Live CS2 Marketplace Listings

Query parameters

Response fields

Example request

Example response

Error codes

Authorizations

Query Parameters

Response

​Query parameters

​Response fields

​Pagination

​Example request

​Example response

​Error codes

Authorizations

Query Parameters

Response

Query parameters

Response fields

Pagination

Example request

Example response

Error codes