Skip to main content
POST
Buy and deliver to a Steam trade URL
Этот эндпоинт позволяет покупать и доставлять предметы напрямую на любой указанный вами Steam trade URL — не только на trade URL, привязанный к вашему аккаунту. Trade URL формируется из полей partner и token. Покупки финансируются только из вашего подтверждённого (защищённого от реверса) баланса, что делает эндпоинт пригодным для оптовых объёмов и потоков автоматической доставки. Эндпоинт идемпотентен через поле тела custom_id: повтор с тем же custom_id воспроизводит исходную покупку, а не делает покупку дважды, и воспроизведённый ответ содержит заголовок Idempotent-Replayed: true.
Этот эндпоинт работает за kill-switch и требует аккаунта, для которого включена торговля и нет истории реверсов. Когда kill-switch выключен, возвращается 403 external_buy_disabled.
Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_.... Требуется возможность торговли. Для ключа должны быть включены покупки, а аккаунт должен быть чистым от реверсов.

Тело запроса

string[]
обязательно
От 1 до 100 уникальных id листингов для покупки.
string
обязательно
Значение partner из Steam trade URL (1–32 символа). Вместе с token образует конечный trade URL, на который доставляются предметы.
string
обязательно
Значение token из Steam trade URL (1–32 символа). Вместе с partner образует конечный trade URL.
number
Верхняя граница итоговой цены в USD. Если живой итог превышает её, заказ отклоняется с ошибкой price_moved и ничего не списывается. Настоятельно рекомендуется.
string
Ключ идемпотентности (1–128 символов). Повтор с тем же custom_id воспроизводит исходную покупку; ответ при повторе содержит Idempotent-Replayed: true.
boolean
по умолчанию:"false"
Если true, пропускать предметы, которые больше недоступны, вместо того чтобы отклонить весь запрос.

Поля ответа

object
обязательно

Пример запроса

Пример ответа

Коды ошибок

Средства берутся исключительно из вашего подтверждённого баланса. Перед большой партией проверяйте settled_balance_usd через GET /v1/balance и всегда передавайте 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
обязательно