> ## Documentation Index
> Fetch the complete documentation index at: https://api.csboard.com/llms.txt
> Use this file to discover all available pages before exploring further.
# GET /v1/public/prices — 无需密钥的 CS2、Dota 2 与 Rust 最低价数据源
> 按商品名称返回 CS2、Dota 2 或 Rust 的最低报价，每个名称一个价格。无需 API 密钥、无余额要求——每个 IP 每分钟限一次请求。
公开价格数据源只回答一个问题：此刻 CSBoard 上每件商品的最低报价是多少？您会得到一个对象，把某个游戏中所有在售的 `market_hash_name` 映射到其美元最低价。没有深度、没有挂单数量、不按磨损拆分，也没有分页。
**无需 API 密钥。** 请求时不要带 `Authorization` 头，也不需要任何余额。因此，它最适合只需要“每个名称一个数字”的比价网站、电子表格和抓取程序。
## 返回内容
* **每次请求一个游戏。** `appId=730` 为 CS2（默认），`570` 为 Dota 2，`252490` 为 Rust。
* **使用 Steam 自己的名称。** CS2 的多普勒和伽马多普勒相位会合并到 Steam 使用的基础名称下，因此 `Karambit | Doppler (Factory New)` 的价格取其最便宜的相位。每个键都对应一个真实的 Steam `market_hash_name`。
* **键名有序，价格精确到美分。** 只有至少有一条在售挂单的名称才会出现。
* **`updatedAt`** 是该数据生成的时间。
## 限制与新鲜度
数据源**每分钟最多重建一次**，并以 `Cache-Control: public, max-age=60` 返回。请求限制为**每个 IP 地址每分钟 1 次**。更频繁地轮询拿不到更新的数据——只会得到一个带 `Retry-After` 头的 `429`。
这里的 `429` 来自按 IP 的限流器，而不是按密钥的限流器，因此响应体是 `{ "error": "...", "statusCode": 429 }`，没有 `code` 字段。请根据 HTTP 状态码分支处理，并等待 `Retry-After` 秒。
## 示例请求
```bash theme={null}
curl "https://csboard.com/v1/public/prices?appId=730"
```
## 示例响应
```json theme={null}
{
"appId": 730,
"currency": "USD",
"updatedAt": "2026-10-02T12:00:41.512Z",
"items": {
"AK-47 | Redline (Field-Tested)": 11.92,
"AWP | Asiimov (Field-Tested)": 96.4,
"Karambit | Doppler (Factory New)": 812.5
}
}
```
## 错误代码
| HTTP 状态码 | 代码 | 含义 |
| - | - | - |
| 400 | `invalid_param` | `appId` 不是我们提供的游戏之一。`detail` 会列出可用的值。 |
| 429 | — | 您的 IP 本分钟内的请求超过一次。请等待 `Retry-After` 响应头中的秒数。 |
需要按磨损和相位拆分、挂单数量、过滤或分页？请使用需要密钥的 [`GET /v1/prices`](/zh-Hans/api-reference/get-prices)。需要可以直接购买的具体挂单？请使用 [`GET /v1/listings`](/zh-Hans/api-reference/get-listings)——该数据源仅供参考，数据最多可能滞后一分钟。
## OpenAPI
````yaml GET /public/prices
openapi: 3.1.0
info:
title: CSBoard API
version: 1.0.0
description: >-
Market data over the CSBoard marketplace — live listings, floats, stickers,
minAsk prices, FX rates — plus opt-in buying straight from your balance.
Free to read, key-gated, built for automation.
contact:
name: CSBoard
url: https://csboard.com/docs
servers:
- url: https://csboard.com/v1
description: Production
security:
- bearerAuth: []
tags:
- name: Status
description: Liveness and freshness probes.
- name: Market data
description: Read the live catalog, prices, and FX rates.
- name: Trading
description: Buy listings from your CSBoard balance. Opt-in, key-gated.
- name: P2P
description: >-
List your own CS2 skins on the CSBoard P2P market. Free — any valid key,
no balance requirement.
- name: Account
description: Your balance, settled funds, and trading status.
- name: Webhooks
description: Register an endpoint and receive signed order updates instead of polling.
paths:
/public/prices:
get:
tags:
- Market data
summary: Keyless min-ask feed
description: >-
One number per item: the cheapest current ask in USD for every
`market_hash_name` on sale in one game. **No API key and no balance
requirement** — send no `Authorization` header. In exchange it is
limited to 1 request per minute per IP address, and the payload is
rebuilt at most once a minute (`Cache-Control: public, max-age=60`), so
polling faster gains nothing.
CS2 Doppler and Gamma Doppler phases are merged into Steam's own base
name, so every key matches a real Steam `market_hash_name`. For depth,
counts, wear, filters or paging use the keyed `GET /prices`.
operationId: getPublicPrices
parameters:
- name: appId
in: query
required: false
description: >-
Game to price: `730` = CS2 (the default), `570` = Dota 2, `252490` =
Rust. A game that is not available answers `400 invalid_param`.
schema:
type: integer
enum:
- 730
- 570
- 252490
default: 730
responses:
'200':
description: Name → min-ask map for the game.
headers:
Cache-Control:
description: '`public, max-age=60`.'
schema:
type: string
content:
application/json:
schema:
$ref: '#/components/schemas/PublicPrices'
example:
appId: 730
currency: USD
updatedAt: '2026-10-02T12:00:41.512Z'
items:
AK-47 | Redline (Field-Tested): 11.92
AWP | Asiimov (Field-Tested): 96.4
Karambit | Doppler (Factory New): 812.5
'400':
description: The `appId` is not available.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
code: invalid_param
detail: 'appId "440" is not available. Use one of: 730, 570, 252490.'
'429':
description: >-
More than 1 request in a minute from your IP address. Wait
`Retry-After` seconds. This limit is enforced per address, not per
key, and its body has no `code` field — branch on the status code.
headers:
Retry-After:
description: Seconds to wait before retrying.
schema:
type: integer
content:
application/json:
schema:
type: object
properties:
error:
type: string
statusCode:
type: integer
example:
error: Rate limit exceeded, retry in 37 seconds
statusCode: 429
security: []
components:
schemas:
PublicPrices:
type: object
properties:
appId:
type: integer
description: The game these prices are for.
example: 730
currency:
type: string
enum:
- USD
updatedAt:
type: string
format: date-time
description: When this payload was built. It is rebuilt at most once a minute.
items:
type: object
additionalProperties:
type: number
description: >-
`market_hash_name` → the cheapest current ask in USD, rounded to the
cent. Keys are sorted. Only names with at least one listing on sale
appear. CS2 Doppler and Gamma Doppler phases are merged into Steam's
base name and carry the cheapest phase.
required:
- appId
- currency
- updatedAt
- items
Error:
type: object
description: >-
All errors return { code, detail }. Some carry extra fields (e.g.
price_moved adds current_total_usd, insufficient_balance adds
required_usd/current_usd).
properties:
code:
type: string
description: >-
Machine-readable error code, e.g. rate_limit_exceeded,
trading_not_enabled, price_moved.
detail:
type: string
description: Human-readable explanation.
required:
- code
securitySchemes:
bearerAuth:
type: http
scheme: bearer
description: >-
Send your key as a Bearer token on every request: `Authorization: Bearer
csb_pub_...`. Generate keys in your CSBoard profile.
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.