Skip to main content
POST
Buy and deliver to a Steam trade URL
This endpoint lets you buy and deliver items directly to any Steam trade URL you supply — not just the trade URL linked to your account. The trade URL is built from the partner and token fields. Purchases are funded only from your settled (reversal-safe) balance, making it suitable for wholesale volume and automated delivery workflows. The endpoint is idempotent via the custom_id body field: retrying with the same custom_id replays the original purchase rather than buying twice, and the replayed response carries the header Idempotent-Replayed: true.
This endpoint ships behind a kill-switch and requires a trading-enabled, reversal-clean account. When the kill-switch is off it returns 403 external_buy_disabled.
Authentication required. Send your key as Authorization: Bearer csb_pub_.... Trading capability required. Buying must be enabled for the key, and the account must be reversal-clean.

Request body

string[]
required
1–100 unique listing ids to buy.
string
required
Steam trade URL partner value (1–32 chars). Together with token, forms the destination trade URL items are delivered to.
string
required
Steam trade URL token value (1–32 chars). Together with partner, forms the destination trade URL.
number
Total price ceiling in USD. If the live total exceeds it, the order is rejected with price_moved and nothing is charged. Strongly recommended.
string
Idempotency key (1–128 chars). A retry with the same custom_id replays the original purchase; the replay response carries Idempotent-Replayed: true.
boolean
default:"false"
If true, skip items that are no longer available instead of failing the whole request.

Response fields

object
required

Example request

Example response

Error codes

Funds come exclusively from your settled balance. Check settled_balance_usd on GET /v1/balance before a large batch, and always send max_price_usd as overcharge protection.

Authorizations

Authorization
string
header
required

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

Body

application/json
item_ids
string[]
required

1–100 unique listing ids to buy.

Required array length: 1 - 100 elements
partner
string
required

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

Required string length: 1 - 32
token
string
required

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
default: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.

Response

Purchase accepted and debited from settled balance.

data
object
required