Skip to main content
POST
Buy and deliver to a Steam trade URL
此端点允许您将商品购买并直接交付到您提供的任意 Steam 交易链接——而不仅限于绑定到您账户的交易链接。交易链接由 partnertoken 字段组成。购买只能使用您的已结算(不可撤销)余额,因此适用于批发量与自动化交付工作流。 该端点通过 custom_id 请求体字段实现幂等性:使用相同的 custom_id 重试会重放原始的购买,而不会再次扣款;重放的响应会携带 Idempotent-Replayed: true 响应头。
此端点处于熔断开关保护之下,要求账户启用了交易且不可撤销状态干净。熔断开关关闭时,将返回 403 external_buy_disabled
需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。 需要交易能力。 该密钥必须启用购买功能,且账户必须处于不可撤销状态干净。

请求体

string[]
必填
1–100 个唯一的挂单 id。
string
必填
Steam 交易链接中的 partner 值(1–32 个字符)。与 token 一起构成商品交付的目标交易链接。
string
必填
Steam 交易链接中的 token 值(1–32 个字符)。与 partner 一起构成目标交易链接。
number
美元价格上限。如果实时总价超过该值,订单将以 price_moved 被拒绝且不扣款。强烈建议使用。
string
幂等键(1–128 个字符)。使用相同 custom_id 重试会重放原始购买;重放响应会携带 Idempotent-Replayed: true
boolean
默认值:"false"
如果为 true,跳过已不再可用的商品而不会让整个请求失败。

响应字段

object
必填

示例请求

示例响应

错误代码

资金完全来自您的已结算余额。在大批量下单前,请检查 GET /v1/balance 上的 settled_balance_usd,并始终发送 max_price_usd 作为超额扣款保护。

授权

Authorization
string
header
必填

Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.

请求体

application/json
item_ids
string[]
必填

1–100 unique listing ids to buy.

Required array length: 1 - 100 elements
partner
string
必填

Steam trade URL partner value. With token, forms the destination trade URL.

Required string length: 1 - 32
token
string
必填

Steam trade URL token value. With partner, forms the destination trade URL.

Required string length: 1 - 32
max_price_usd
number

Total ceiling in USD. Order is rejected with price_moved if the live total exceeds it.

custom_id
string

Idempotency key. A retry with the same value replays the original purchase.

Required string length: 1 - 128
skip_unavailable
boolean
默认值:false

If true, skip items that are no longer available instead of failing the whole request.

autoclaim
boolean

Sticky per-account setting (not per-order). Send true once to switch your key into auto-claim mode: every held order is then auto-released the moment its hold clears (your bot must auto-accept the Steam trade offer within ~15 minutes). Send false to switch back to manual claiming via POST /orders/{id}/claim. Omit to leave the setting unchanged.

响应

Purchase accepted and debited from settled balance.

data
object
必填