按需开通。 Instant Sell 按账户维度启用。你的 API 密钥开箱即可访问
GET /v1/sell/status，但在获得访问权限之前，报价和出售会返回 selling_not_enabled。请联系支持团队申请访问权限。工作原理
- 报价 —
POST /v1/sell/quotes传入 Steam 交易链接，会返回该库存中我们愿意收购的每一件物品，并给出每件物品将向你入账的确切美元金额。 - 创建订单 —
POST /v1/sell/orders传入选定的asset_ids。CSBoard 网络中的一个机器人会向卖家的交易链接发送 Steam 交易报价。较大的篮子可能会拆分为最多 3 个来自不同机器人的报价 — 订单的offers[]数组会追踪每一个。 - 卖家接受 — 订单进入
received状态。Steam 的交易保护期开始（约 8 天）。待结算金额会显示在GET /v1/balance的incoming_hold字段中。 - 结算 — 保护期结束后，订单完成，全额款项将结算至你的 CSBoard 余额。没有其他出款渠道：资金始终结算至创建该订单的 API 密钥所属的余额。
向你的用户验证报价
每个报价都会暴露发送机器人的资料和 Steam 交易报价 id：trade_offer_id 和机器人的 steam_id 进行比对 — 无论由哪个机器人发出报价，这项校验都能防范假冒诈骗。
端点
所有端点都位于/v1/sell 下，并使用与 API 其他部分相同的 csb_pub_ Bearer 密钥。
GET /v1/sell/status
功能发现。适用于每个密钥。POST /v1/sell/quotes
POST /v1/sell/orders
min_total_usd— 可选的价格波动下限。如果在报价与执行之间实时总价跌破该值，订单将以price_drift被拒绝，不会产生任何副作用。external_id— 你的幂等 id，在每个密钥下唯一。使用相同external_id重试会返回原订单，而不会创建重复订单。Idempotency-Key请求头 — 请求级的重放保护，语义与POST /v1/orders一致。
GET /v1/sell/orders/:id
也可通过GET /v1/sell/orders?external_id=… 访问。
credited_usd 会随着报价结算而增长 — 拆分订单可以部分结算，同时其余报价仍处于保护期。
POST /v1/sell/orders/:id/cancel
允许在订单状态为pending 或 offer_sent 时取消（即卖家接受之前）。此后阶段会返回 409 not_cancellable。
订单生命周期
错误
错误遵循标准的{ "code", "detail" } 结构。出售相关的错误码：invalid_trade_url、private_inventory、inventory_unavailable、item_not_in_inventory、item_not_tradable、no_eligible_items、price_drift、too_many_items、active_order_exists、too_many_active_orders、daily_cap_exceeded、offer_declined、offer_expired、sell_disabled、selling_not_enabled、rate_limited。
限制
- 报价：每个密钥每分钟 10 次请求（库存扫描开销较大）。
- 订单：每个密钥每分钟 5 次创建，10 个活跃订单，默认每日 $2,000 的成交额上限。上限可按账户提高 — 请联系支持团队。