POST /v1/market/buy — покупка и доставка на Steam trade URL
Покупайте до 100 предметов и доставляйте их прямо на любой указанный вами Steam trade URL, оплачивая из подтверждённого баланса. Создано для оптовых покупок и автоматической доставки.
partner и token. Покупки финансируются только из вашего подтверждённого (защищённого от реверса) баланса, что делает эндпоинт пригодным для оптовых объёмов и потоков автоматической доставки.
Эндпоинт идемпотентен через поле тела custom_id: повтор с тем же custom_id воспроизводит исходную покупку, а не делает покупку дважды, и воспроизведённый ответ содержит заголовок Idempotent-Replayed: true.
Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....
Требуется возможность торговли. Для ключа должны быть включены покупки, а аккаунт должен быть чистым от реверсов.
Тело запроса
partner из Steam trade URL (1–32 символа). Вместе с token образует конечный trade URL, на который доставляются предметы.token из Steam trade URL (1–32 символа). Вместе с partner образует конечный trade URL.price_moved и ничего не списывается. Настоятельно рекомендуется.custom_id воспроизводит исходную покупку; ответ при повторе содержит Idempotent-Replayed: true.true, пропускать предметы, которые больше недоступны, вместо того чтобы отклонить весь запрос.Поля ответа
Пример запроса
Пример ответа
Коды ошибок
settled_balance_usd через GET /v1/balance и всегда передавайте 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.