POST /v1/market/buy — 购买并交付到 Steam 交易链接
一次最多购买 100 件商品,并直接交付到您提供的任意 Steam 交易链接,使用已结算余额支付。专为批发与自动化交付而设计。
partner 和 token 字段组成。购买只能使用您的已结算(不可撤销)余额,因此适用于批发量与自动化交付工作流。
该端点通过 custom_id 请求体字段实现幂等性:使用相同的 custom_id 重试会重放原始的购买,而不会再次扣款;重放的响应会携带 Idempotent-Replayed: true 响应头。
需要身份验证。 请将密钥作为 Authorization: Bearer csb_pub_... 发送。
需要交易能力。 该密钥必须启用购买功能,且账户必须处于不可撤销状态干净。
请求体
partner 值(1–32 个字符)。与 token 一起构成商品交付的目标交易链接。token 值(1–32 个字符)。与 partner 一起构成目标交易链接。price_moved 被拒绝且不扣款。强烈建议使用。custom_id 重试会重放原始购买;重放响应会携带 Idempotent-Replayed: true。true,跳过已不再可用的商品而不会让整个请求失败。响应字段
示例请求
示例响应
错误代码
GET /v1/balance 上的 settled_balance_usd,并始终发送 max_price_usd 作为超额扣款保护。授权
Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.
请求体
1–100 unique listing ids to buy.
1 - 100 elementsSteam trade URL partner value. With token, forms the destination trade URL.
1 - 32Steam trade URL token value. With partner, forms the destination trade URL.
1 - 32Total ceiling in USD. Order is rejected with price_moved if the live total exceeds it.
Idempotency key. A retry with the same value replays the original purchase.
1 - 128If true, skip items that are no longer available instead of failing the whole request.
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.