# Conventions (/conventions)



## Money [#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]

Timestamps are Unix seconds unless an operation states otherwise.

## Identifiers [#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 [#pagination]

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

## Response envelope [#response-envelope]

Both APIs wrap payloads in an application-level envelope:

```json
{
  "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 [#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.