GET /v1/prices — CS2 minAsk Price List by Item Group

GET

prices

minAsk price list

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

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

fetch('https://csboard.com/v1/prices', 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/prices",
  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/prices"

	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/prices")

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": [
    {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "wear": "Field-Tested",
      "doppler_phase": null,
      "min_price_usd": 11.92,
      "qty": 73
    }
  ],
  "next_cursor": null
}

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

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

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

string

Fuzzy match on market_hash_name — splits the query into words and substring-matches each. A name that is a word-subset of a longer item’s name (e.g. Spectrum Case vs Spectrum 2 Case) cannot be isolated this way; use name for an exact lookup.

string

Exact market_hash_name (case-insensitive) — the precise single-item lookup. name=Spectrum Case returns only the Spectrum Case group, never Spectrum 2 Case. Takes precedence over search.

string

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

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.

number

Minimum min_price_usd in USD (inclusive).

number

Maximum min_price_usd in USD (inclusive).

string

Keyset pagination cursor. Pass the next_cursor value from the previous response.

integer

default:"100"

Number of rows per page. Minimum 1, maximum 500.

Response fields

PriceRow[]

required

Array of price rows for this page.

Show PriceRow object

string

required

Steam market hash name, e.g. AK-47 | Redline (Field-Tested).

string | null

Wear bucket for this price group. null for items without a wear tier.

string | null

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

number

required

Cheapest current asking price in USD across all listings in this group.

integer

required

Number of listings currently available in this group.

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 status	Code	Meaning
401	`unauthorized`	Missing or invalid API key.
429	`rate_limit_exceeded`	Over 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

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 price rows.

items

object[]

required

Show child attributes

next_cursor

string | null

required

minAsk price list

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

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

fetch('https://csboard.com/v1/prices', 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/prices",
  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/prices"

	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/prices")

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": [
    {
      "market_hash_name": "AK-47 | Redline (Field-Tested)",
      "wear": "Field-Tested",
      "doppler_phase": null,
      "min_price_usd": 11.92,
      "qty": 73
    }
  ],
  "next_cursor": null
}

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

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

Market Data

Trading

Account

Webhooks

Status

GET /v1/prices — CS2 minAsk Price List by Item Group

Query parameters

Response fields

Example request

Example response

Error codes

Authorizations

Query Parameters

Response

​Query parameters

​Response fields

​Example request

​Example response

​Error codes

Authorizations

Query Parameters

Response

Query parameters

Response fields

Example request

Example response

Error codes