POST /v1/orders — покупка листингов CS2 со своего баланса
Покупайте 1–10 листингов CS2 по ID в одном атомарном запросе со списанием с баланса CSBoard. Требуется API-ключ с включённой торговлей и привязанный аккаунт Steam.
/v1/listings. Чтобы защититься от движений цены между запросом и покупкой, всегда указывайте max_price_usd как верхнюю границу итога. Эндпоинт идемпотентен: повтор с тем же Idempotency-Key воспроизводит исходный заказ, а не создаёт дубликат списания.
Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....
Требуется возможность торговли. Для API-ключа должны быть включены покупки. Настройте это в профиле CSBoard.
Предварительные условия
Перед оформлением заказа убедитесь, что:- Ключ с включённой торговлей — покупки должны быть включены для вашего API-ключа в настройках профиля CSBoard.
- Привязанный аккаунт Steam и trade URL — к аккаунту CSBoard должен быть привязан аккаунт Steam с валидным trade URL, чтобы предметы можно было доставить.
- Достаточный баланс — баланс CSBoard должен покрывать суммарную стоимость предметов по их живым ценам.
Заголовки запроса
Тело запроса
id ответов GET /v1/listings. Каждый ID должен встречаться в запросе только один раз.price_moved и списания не происходит. Настоятельно рекомендуется — без него у вас нет защиты от переплаты.Idempotency-Key. Если переданы оба, заголовок имеет приоритет. Используйте что-то одно.Поля ответа
ord_01J9Z3K8Q2.processing, completed или failed.Пример запроса
Пример ответа
Коды ошибок
hold, попадают под торговый холд Steam. Проверяйте поле tradable_at исходного листинга (из GET /v1/listings), чтобы узнать, когда именно удерживаемый предмет станет доступен для обмена в вашем инвентаре Steam.Авторизации
Send your key as a Bearer token on every request: Authorization: Bearer csb_pub_.... Generate keys in your CSBoard profile.
Заголовки
Optional. A retried request with the same key replays the original order instead of buying twice.
Тело
1–10 unique ids from /v1/listings. Some items can't be combined in a single order — if so the order is rejected and you can split it.
1 - 10 elementsTotal ceiling in USD. Strongly recommended — your overcharge protection, enforced atomically inside the locked debit.
Optional; or send the Idempotency-Key header. Replays the original order on retry.
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.