Skip to main content
GET
/
prices
minAsk price list
curl --request GET \
  --url https://csboard.com/v1/prices \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "wear": "Field-Tested",
      "doppler_phase": null,
      "min_price_usd": 11.92,
      "qty": 73
    }
  ],
  "next_cursor": null
}
The prices endpoint returns a grouped price snapshot of the CSBoard marketplace. Each row represents a unique combination of market_hash_name, wear, and doppler_phase, and carries the cheapest current asking price together with how many copies are listed. This makes it efficient for building price comparison tables, alerting pipelines, or portfolio valuation — you can retrieve pricing for thousands of items without pulling individual listings. Authentication required. Send your key as Authorization: Bearer csb_pub_....

​
Query parameters

​
search
string
Full-text match on market_hash_name, e.g. AK-47 | Redline.
​
category
string
Filter by item category, e.g. Rifle, Knife, Gloves.
​
wear
string
Filter by wear bucket. One of: Factory New, Minimal Wear, Field-Tested, Well-Worn, Battle-Scarred.
​
rarity
string
Filter by rarity tier, e.g. Classified, Covert.
​
min_price
number
Minimum min_price_usd in USD (inclusive).
​
max_price
number
Maximum min_price_usd in USD (inclusive).
​
cursor
string
Keyset pagination cursor. Pass the next_cursor value from the previous response.
​
limit
integer
default:"100"
Number of rows per page. Minimum 1, maximum 500.

​
Response fields

​
items
PriceRow[]
required
Array of price rows for this page.
​
next_cursor
string | null
required
Keyset cursor for the next page. Pass as cursor on the next request. null on the last page.

​
Example request

curl "https://csboard.com/v1/prices?category=Rifle&wear=Field-Tested&limit=50" \
  -H "Authorization: Bearer csb_pub_..."

​
Example response

{
  "items": [
    {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "wear": "Field-Tested",
      "doppler_phase": null,
      "min_price_usd": 11.92,
      "qty": 73
    }
  ],
  "next_cursor": null
}

​
Error codes

HTTP statusCodeMeaning
401unauthorizedMissing or invalid API key.
429rate_limit_exceededOver 30 requests/min. Wait for the Retry-After header value before retrying.
The prices endpoint returns an indicative grouped snapshot. The data is periodically materialized and can lag behind the live marketplace. Use GET /v1/listings for the authoritative, real-time asking price of a specific item before placing an order.

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.

​
cursor
string

Keyset cursor from next_cursor.

​
limit
integer
default:100

1–500. Default 100.

Required range: 1 <= x <= 500

Response

A page of price rows.

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