Conventions

Money

Prices are Chinese yuan, sent as decimal strings rather than integer minor units. Parse them as decimals; do not use binary floating point for ledger arithmetic.

Timestamps

Timestamps are Unix seconds unless an operation states otherwise.

Identifiers

goods_id identifies a catalog entry — one item name, not one asset. market_hash_name is the Steam-side name for the same entry and is accepted by several operations in place of goods_id.

Pagination

Paginated official operations use page_num and page_size. page_num is one-based.

Response envelope

Both APIs wrap payloads in an application-level envelope:

{
  "code": "OK",
  "data": {},
  "msg": null
}

Check code on every response. A 200 HTTP status only means the request reached BUFF, not that the operation succeeded.

Limits

Access level, update frequency, and request limit differ per operation and are stated on each one. Enterprise operations generally allow 5,000 requests per 24 hours against Developer's 500, and the sell-order book allows 3 requests per second.