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",
      "refund_percent": 100,
      "listed_at": "2026-06-29T08:41:17.000Z"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

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

Pass appId=570 for Dota 2 or appId=252490 for Rust. Those rows have the same keys; the CS2-only fields (wear, doppler_phase, float_value, paint_seed, inspect_link, tradable_at, listed_at) are null and stickers is []. See Games.

Query parameters

integer

default:"730"

Game to read: 730 = CS2, 570 = Dota 2, 252490 = Rust. Omit it for CS2. See GET /v1/games for the games your key can use.

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. CS2 only — with another appId it answers 400 invalid_param.

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. CS2 only — with another appId it answers 400 invalid_param.

number

Maximum float value (inclusive). Accepts values from 0.0 to 1.0. CS2 only — with another appId it answers 400 invalid_param.

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. CS2 only — with another appId it answers 400 invalid_param.

string

Souvenir filter. only returns only Souvenir items; exclude removes them from results. CS2 only — with another appId it answers 400 invalid_param.

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.CS2 only — with another appId it answers 400 invalid_param.

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. newest is CS2 only — with another appId it answers 400 invalid_param.

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",
      "refund_percent": 100,
      "listed_at": "2026-06-29T08:41:17.000Z"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

Error codes

HTTP status	Code	Meaning
400	`invalid_param`	A malformed parameter, or a CS2-only filter sent with another `appId`.
400	`unsupported_game`	Your key cannot use this `appId`. `supported_app_ids` lists the ones it can.
401	`missing_api_key`, `invalid_api_key`	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

appId

enum<integer>

default:730

Steam appId of the game. 730 = CS2 (the default), 570 = Dota 2, 252490 = Rust. Omit it and the endpoint answers for CS2 exactly as before. An appId this key may not use answers 400 unsupported_game, whose supported_app_ids lists the ones it may — see GET /games.

Available options:

730,

570,

252490

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",
      "refund_percent": 100,
      "listed_at": "2026-06-29T08:41:17.000Z"
    }
  ],
  "next_cursor": "eyJpZCI6Iml0bV84ODQxMjAxIn0="
}

Market Data

Trading

Instant Sell

P2P

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