GET /v1/prices — 按商品组的 CS2 minAsk 价格列表

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
}

prices 端点返回 CSBoard 市场的分组价格快照。每一行代表 market_hash_name、wear 与 doppler_phase 的一个唯一组合，并附带当前最低报价以及挂单的数量。这使其非常适合用于构建比价表、告警管道或资产估值——您可以为成千上万的商品获取价格而无需拉取每条挂单。 需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。

传入 appId=570 读取 Dota 2，传入 appId=252490 读取 Rust。对这些游戏，每行对应一个 market_hash_name，wear 和 doppler_phase 为 null。参见游戏。每个名称只需要一个价格？GET /v1/public/prices 无需密钥即可使用。

查询参数

integer

默认值:"730"

要读取的游戏：730 = CS2，570 = Dota 2，252490 = Rust。不传则为 CS2。您的密钥可用的游戏请参见 GET /v1/games。

string

对 market_hash_name 进行模糊匹配 —— 将查询拆分为多个词，并对每个词进行子串匹配。如果某个名称是更长商品名称的词子集（例如 Spectrum Case 与 Spectrum 2 Case），则无法通过此方式单独筛选；要精确查询，请使用 name。

string

精确的 market_hash_name（不区分大小写）—— 单个商品的精确查询方式。name=Spectrum Case 仅返回 Spectrum Case 组，绝不会返回 Spectrum 2 Case。优先于 search。

string

按商品类别过滤，例如 Rifle、Knife、Gloves。

string

按磨损档位过滤。可选值：Factory New、Minimal Wear、Field-Tested、Well-Worn、Battle-Scarred 之一。仅限 CS2——在其他 appId 下发送会返回 400 invalid_param。

string

按稀有度档位过滤，例如 Classified、Covert。

number

最低 min_price_usd，单位美元（含）。

number

最高 min_price_usd，单位美元（含）。

string

键集分页游标。传入上一次响应中的 next_cursor 值。

integer

默认值:"100"

每页行数。最小 1，最大 500。

响应字段

PriceRow[]

必填

本页的价格行数组。

显示 PriceRow object

string

必填

Steam 市场哈希名称，例如 AK-47 | Redline (Field-Tested)。

string | null

该价格组的磨损档位。对于没有磨损档位的商品为 null。

string | null

该价格组的多普勒或伽马多普勒相位，例如 "Phase 2"、"Ruby"。非多普勒商品为 null。

number

必填

该组中所有挂单的当前最低美元报价。

integer

必填

该组中当前可用的挂单数量。

string | null

必填

下一页的键集游标。在下一次请求时作为 cursor 传入。最后一页为 null。

示例请求

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

示例响应

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

错误代码

HTTP 状态码	代码	含义
400	`invalid_param`	在 Dota 2 或 Rust 的 `appId` 下发送了 `wear`。
400	`unsupported_game`	您的密钥无法使用该 `appId`。`supported_app_ids` 列出了可用的值。
401	`missing_api_key`, `invalid_api_key`	API 密钥缺失或无效。
429	`rate_limit_exceeded`	超过密钥的读取限制（默认 100 次/分钟）。请在重试前等待 `Retry-After` 响应头中的秒数。

prices 端点返回的是指示性分组快照。该数据是周期性实体化的，可能滞后于实时市场。在下单前，请使用 GET /v1/listings 获取特定商品权威的实时报价。

授权

Authorization

string

header

必填

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile. Calls made with a key are metered only by that key's own limits — there is no per-IP limit on top — and every answer carries X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and X-RateLimit-Bucket for the bucket the call spent. See Rate limits.

查询参数

appId

enum<integer>

默认值: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.

可用选项:

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.

响应

A page of price rows.

items

object[]

必填

Show child attributes

next_cursor

string | null

必填

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
}

市场数据

交易

P2P

账户

状态

GET /v1/prices — 按商品组的 CS2 minAsk 价格列表

查询参数

响应字段

示例请求

示例响应

错误代码

授权

查询参数

响应