POST /v1/market/buy — покупка и доставка на Steam trade URL
Покупайте до 100 предметов и доставляйте их прямо на любой указанный вами Steam trade URL, оплачивая из подтверждённого баланса. Создано для оптовых покупок и автоматической доставки.
curl --request POST \
--url https://csboard.com/v1/market/buy \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"item_ids": [
"itm_8841201",
"itm_8841340"
],
"partner": "447383001",
"token": "Ab3xZ9Qp",
"max_price_usd": 30,
"custom_id": "batch-2026-06-29-01",
"skip_unavailable": false
}
'import requests
url = "https://csboard.com/v1/market/buy"
payload = {
"item_ids": ["itm_8841201", "itm_8841340"],
"partner": "447383001",
"token": "Ab3xZ9Qp",
"max_price_usd": 30,
"custom_id": "batch-2026-06-29-01",
"skip_unavailable": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
item_ids: ['itm_8841201', 'itm_8841340'],
partner: '447383001',
token: 'Ab3xZ9Qp',
max_price_usd: 30,
custom_id: 'batch-2026-06-29-01',
skip_unavailable: false
})
};
fetch('https://csboard.com/v1/market/buy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://csboard.com/v1/market/buy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'item_ids' => [
'itm_8841201',
'itm_8841340'
],
'partner' => '447383001',
'token' => 'Ab3xZ9Qp',
'max_price_usd' => 30,
'custom_id' => 'batch-2026-06-29-01',
'skip_unavailable' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://csboard.com/v1/market/buy"
payload := strings.NewReader("{\n \"item_ids\": [\n \"itm_8841201\",\n \"itm_8841340\"\n ],\n \"partner\": \"447383001\",\n \"token\": \"Ab3xZ9Qp\",\n \"max_price_usd\": 30,\n \"custom_id\": \"batch-2026-06-29-01\",\n \"skip_unavailable\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://csboard.com/v1/market/buy")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"item_ids\": [\n \"itm_8841201\",\n \"itm_8841340\"\n ],\n \"partner\": \"447383001\",\n \"token\": \"Ab3xZ9Qp\",\n \"max_price_usd\": 30,\n \"custom_id\": \"batch-2026-06-29-01\",\n \"skip_unavailable\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://csboard.com/v1/market/buy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"item_ids\": [\n \"itm_8841201\",\n \"itm_8841340\"\n ],\n \"partner\": \"447383001\",\n \"token\": \"Ab3xZ9Qp\",\n \"max_price_usd\": 30,\n \"custom_id\": \"batch-2026-06-29-01\",\n \"skip_unavailable\": false\n}"
response = http.request(request)
puts response.read_body{
"data": {
"purchase_id": "pur_01J9Z3K8Q2",
"steam_id": "76561198000000000",
"created_at": "2026-06-29T17:12:04Z",
"custom_id": "batch-2026-06-29-01",
"skins": [
{
"name": "AK-47 | Redline (Minimal Wear)",
"price": 14.37,
"status": "delivering",
"return_reason": null,
"steam_trade_offer_id": "5512345678"
}
]
}
}partner и token. Покупки финансируются только из вашего подтверждённого (защищённого от реверса) баланса, что делает эндпоинт пригодным для оптовых объёмов и потоков автоматической доставки.
Эндпоинт идемпотентен через поле тела custom_id: повтор с тем же custom_id воспроизводит исходную покупку, а не делает покупку дважды, и воспроизведённый ответ содержит заголовок Idempotent-Replayed: true.
403 external_buy_disabled.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, пропускать предметы, которые больше недоступны, вместо того чтобы отклонить весь запрос.item_ids: 730 CS2 (по умолчанию), 570 Dota 2, 252490 Rust. Передавайте тот же appId, с которым читали id из GET /v1/listings. В заказе Dota 2 и Rust до 10 id; такие заказы ставятся в очередь, поэтому каждый скин сначала отвечает pending.Поля ответа
Пример запроса
curl -X POST https://csboard.com/v1/market/buy \
-H "Authorization: Bearer csb_pub_..." \
-H "Content-Type: application/json" \
-d '{
"item_ids": ["itm_8841201", "itm_8841340"],
"partner": "447383001",
"token": "Ab3xZ9Qp",
"max_price_usd": 30.00,
"custom_id": "batch-2026-06-29-01",
"skip_unavailable": false
}'
Пример ответа
{
"data": {
"purchase_id": "pur_01J9Z3K8Q2",
"steam_id": "76561198000000000",
"created_at": "2026-06-29T17:12:04Z",
"custom_id": "batch-2026-06-29-01",
"skins": [
{
"name": "AK-47 | Redline (Minimal Wear)",
"price": 14.37,
"status": "delivering",
"return_reason": null,
"steam_trade_offer_id": "5512345678"
}
]
}
}
Коды ошибок
| HTTP-статус | Код | Значение |
|---|---|---|
| 400 | invalid_request | Некорректное тело (например, item_ids пуст или содержит более 100 элементов). |
| 400 | unsupported_item | Один или несколько предметов нельзя доставить через этот эндпоинт (например, id ss_live_*). |
| 400 | invalid_trade_url | partner + token не образуют валидный Steam trade URL. |
| 400 | unsupported_game | appId недоступен вашему ключу. Содержит supported_app_ids. |
| 400 | too_many_items | Больше 10 id Dota 2 или Rust в одном заказе. Содержит max_items. |
| 401 | invalid_api_key | Отсутствует или некорректный API-ключ. |
| 402 | insufficient_settled_balance | Подтверждённый баланс ниже суммы заказа. Включает required_usd и settled_usd. |
| 402 | insufficient_balance | Баланс ниже суммы заказа. |
| 403 | external_buy_disabled | Kill-switch выключен; эндпоинт сейчас недоступен. |
| 403 | trading_not_enabled | Покупки не включены для этого ключа. |
| 403 | account_restricted | Эндпоинт требует аккаунт без истории реверсов. |
| 409 | item_unavailable | Один или несколько предметов больше недоступны. Включает unavailable_ids[]. |
| 409 | price_moved | Живой итог превысил верхнюю границу. Включает quoted_max_usd, current_total_usd и items[]. |
| 409 | idempotency_in_progress | Запрос с этим custom_id ещё обрабатывается. |
| 409 | price_updating | Цены обновляются; повторите через короткое время. |
| 429 | rate_limit_exceeded | Слишком много запросов. Подождите время, указанное в заголовке Retry-After. |
| 500 | order_failed | Покупку не удалось завершить. |
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.
Game the item_ids belong to: 730 = CS2 (the default), 570 = Dota 2, 252490 = Rust. Send the same appId you read the ids with from GET /listings. Dota 2 and Rust take up to 10 ids per order. A game this key may not buy in answers 400 unsupported_game — tradable in GET /games tells you in advance.
730, 570, 252490 Ответ
Purchase accepted and debited from settled balance.
Show child attributes
Show child attributes
curl --request POST \
--url https://csboard.com/v1/market/buy \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"item_ids": [
"itm_8841201",
"itm_8841340"
],
"partner": "447383001",
"token": "Ab3xZ9Qp",
"max_price_usd": 30,
"custom_id": "batch-2026-06-29-01",
"skip_unavailable": false
}
'import requests
url = "https://csboard.com/v1/market/buy"
payload = {
"item_ids": ["itm_8841201", "itm_8841340"],
"partner": "447383001",
"token": "Ab3xZ9Qp",
"max_price_usd": 30,
"custom_id": "batch-2026-06-29-01",
"skip_unavailable": False
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
item_ids: ['itm_8841201', 'itm_8841340'],
partner: '447383001',
token: 'Ab3xZ9Qp',
max_price_usd: 30,
custom_id: 'batch-2026-06-29-01',
skip_unavailable: false
})
};
fetch('https://csboard.com/v1/market/buy', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://csboard.com/v1/market/buy",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'item_ids' => [
'itm_8841201',
'itm_8841340'
],
'partner' => '447383001',
'token' => 'Ab3xZ9Qp',
'max_price_usd' => 30,
'custom_id' => 'batch-2026-06-29-01',
'skip_unavailable' => false
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://csboard.com/v1/market/buy"
payload := strings.NewReader("{\n \"item_ids\": [\n \"itm_8841201\",\n \"itm_8841340\"\n ],\n \"partner\": \"447383001\",\n \"token\": \"Ab3xZ9Qp\",\n \"max_price_usd\": 30,\n \"custom_id\": \"batch-2026-06-29-01\",\n \"skip_unavailable\": false\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://csboard.com/v1/market/buy")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"item_ids\": [\n \"itm_8841201\",\n \"itm_8841340\"\n ],\n \"partner\": \"447383001\",\n \"token\": \"Ab3xZ9Qp\",\n \"max_price_usd\": 30,\n \"custom_id\": \"batch-2026-06-29-01\",\n \"skip_unavailable\": false\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://csboard.com/v1/market/buy")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"item_ids\": [\n \"itm_8841201\",\n \"itm_8841340\"\n ],\n \"partner\": \"447383001\",\n \"token\": \"Ab3xZ9Qp\",\n \"max_price_usd\": 30,\n \"custom_id\": \"batch-2026-06-29-01\",\n \"skip_unavailable\": false\n}"
response = http.request(request)
puts response.read_body{
"data": {
"purchase_id": "pur_01J9Z3K8Q2",
"steam_id": "76561198000000000",
"created_at": "2026-06-29T17:12:04Z",
"custom_id": "batch-2026-06-29-01",
"skins": [
{
"name": "AK-47 | Redline (Minimal Wear)",
"price": 14.37,
"status": "delivering",
"return_reason": null,
"steam_trade_offer_id": "5512345678"
}
]
}
}