GET /v1/orders — история ваших покупок

GET

orders

List purchase history

curl --request GET \
  --url https://csboard.com/v1/orders \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/orders', 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/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://csboard.com/v1/orders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "order_id": "ord_01J9Z3K8Q2",
      "steam_id": "76561198000000000",
      "status": "completed",
      "custom_id": "batch-2026-06-29-01",
      "currency": "USD",
      "charged_total_usd": 26.47,
      "item_count": 2,
      "hold_until": null,
      "created_at": "2026-06-29T17:12:04Z",
      "updated_at": "2026-06-29T17:15:40Z",
      "items": [
        {
          "market_hash_name": "AK-47 | Redline (Minimal Wear)",
          "price_usd": 14.37,
          "status": "delivered",
          "tradable_at": "2026-07-06T12:00:00Z",
          "return_reason": null,
          "steam_trade_offer_id": "5512345678",
          "steam_trade_offer_finished_at": "2026-06-29T17:15:40Z"
        }
      ]
    }
  ],
  "meta": {
    "next_cursor": "eyJpZCI6Im9yZF8wMUo5WjNLOFEyIn0=",
    "per_page": 50
  }
}

{
  "code": "unauthorized",
  "message": "Missing or invalid API key."
}

{
  "code": "invalid_request",
  "detail": "limit must be between 1 and 100."
}

{
  "code": "rate_limit_exceeded",
  "message": "Too many requests."
}

Эндпоинт orders возвращает историю ваших покупок, сначала самые новые, с keyset-пагинацией. Фильтруйте по временному окну и по статусу, затем переходите к более старым страницам, передавая meta.next_cursor обратно как cursor. Каждый заказ содержит разбивку по предметам со статусом доставки. Требуется аутентификация. Отправьте ключ как Authorization: Bearer csb_pub_....

Query-параметры

integer

по умолчанию:"50"

Результатов на странице. Минимум 1, максимум 100.

integer

Возвращать только заказы, созданные не раньше этого Unix-таймстампа (в секундах).

integer

Возвращать только заказы, созданные не позже этого Unix-таймстампа (в секундах).

string

Фильтр по статусу заказа. Одно из: completed, hold, delivering, pending, cancelled, failed.

string

Keyset-курсор из meta.next_cursor предыдущего ответа. Передайте его, чтобы получить следующую страницу.

Поля ответа

Order[]

обязательно

Массив заказов для этой страницы.

Показать Order object

string

обязательно

CSBoard order id.

string | null

Steam ID, на который были доставлены предметы, если известен.

string

обязательно

Одно из: completed, hold, delivering, pending, cancelled, failed.

string | null

Ваш собственный id, если вы задали его при покупке.

string

обязательно

Всегда "USD".

number

обязательно

Итоговая сумма списания по заказу в USD.

integer

обязательно

Количество предметов в заказе.

datetime | null

Когда удерживаемые предметы заказа будут освобождены, либо null.

datetime

обязательно

Временная метка создания в ISO 8601.

datetime | null

Временная метка последнего обновления в ISO 8601, либо null.

OrderItem[]

обязательно

Разбивка по предметам.

Показать OrderItem object

string | null

number | null

string

обязательно

Одно из: hold, delivering, delivered, returned.

datetime | null

Когда предмет выйдет из торгового холда Steam, либо null.

string | null

Причина возврата предмета, если status равен returned. Одно из: trade_timeout, declined, expired, rolled_back, unavailable.

string | null

datetime | null

object

обязательно

Показать meta object

string | null

обязательно

Передайте обратно как cursor, чтобы получить следующую страницу. null на последней странице.

integer

обязательно

Размер страницы, использованный для этого ответа.

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

curl "https://csboard.com/v1/orders?status=completed&limit=50" \
  -H "Authorization: Bearer csb_pub_..."

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

{
  "data": [
    {
      "order_id": "ord_01J9Z3K8Q2",
      "steam_id": "76561198000000000",
      "status": "completed",
      "custom_id": "batch-2026-06-29-01",
      "currency": "USD",
      "charged_total_usd": 26.47,
      "item_count": 2,
      "hold_until": null,
      "created_at": "2026-06-29T17:12:04Z",
      "updated_at": "2026-06-29T17:15:40Z",
      "items": [
        {
          "market_hash_name": "AK-47 | Redline (Minimal Wear)",
          "price_usd": 14.37,
          "status": "delivered",
          "tradable_at": "2026-07-06T12:00:00Z",
          "return_reason": null,
          "steam_trade_offer_id": "5512345678",
          "steam_trade_offer_finished_at": "2026-06-29T17:15:40Z"
        }
      ]
    }
  ],
  "meta": { "next_cursor": "eyJpZCI6Im9yZF8wMUo5WjNLOFEyIn0=", "per_page": 50 }
}

Коды ошибок

HTTP-статус	Код	Значение
401	`missing_api_key` / `invalid_api_key`	Отсутствует или некорректный API-ключ.
422	`invalid_request`	Некорректные query-параметры (например, `limit` вне допустимого диапазона).
429	`rate_limit_exceeded`	Слишком много запросов. Подождите время, указанное в заголовке `Retry-After`.

Авторизации

Authorization

string

header

обязательно

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

Параметры запроса

limit

integer

по умолчанию:50

Results per page. 1–100. Default 50.

Требуемый диапазон: 1 <= x <= 100

start_unix_time

integer

Only orders created at or after this Unix timestamp (seconds).

end_unix_time

integer

Only orders created at or before this Unix timestamp (seconds).

status

enum<string>

Filter by order status.

Доступные опции:

completed,

hold,

delivering,

pending,

cancelled,

failed

cursor

string

Keyset cursor from a previous response's meta.next_cursor.

Ответ

A page of orders.

data

object[]

обязательно

Show child attributes

meta

object

обязательно

Show child attributes

List purchase history

curl --request GET \
  --url https://csboard.com/v1/orders \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://csboard.com/v1/orders', 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/orders",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://csboard.com/v1/orders"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://csboard.com/v1/orders")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "data": [
    {
      "order_id": "ord_01J9Z3K8Q2",
      "steam_id": "76561198000000000",
      "status": "completed",
      "custom_id": "batch-2026-06-29-01",
      "currency": "USD",
      "charged_total_usd": 26.47,
      "item_count": 2,
      "hold_until": null,
      "created_at": "2026-06-29T17:12:04Z",
      "updated_at": "2026-06-29T17:15:40Z",
      "items": [
        {
          "market_hash_name": "AK-47 | Redline (Minimal Wear)",
          "price_usd": 14.37,
          "status": "delivered",
          "tradable_at": "2026-07-06T12:00:00Z",
          "return_reason": null,
          "steam_trade_offer_id": "5512345678",
          "steam_trade_offer_finished_at": "2026-06-29T17:15:40Z"
        }
      ]
    }
  ],
  "meta": {
    "next_cursor": "eyJpZCI6Im9yZF8wMUo5WjNLOFEyIn0=",
    "per_page": 50
  }
}

{
  "code": "unauthorized",
  "message": "Missing or invalid API key."
}

{
  "code": "invalid_request",
  "detail": "limit must be between 1 and 100."
}

{
  "code": "rate_limit_exceeded",
  "message": "Too many requests."
}

Рыночные данные

Торговля

Аккаунт

Статус

GET /v1/orders — история ваших покупок

Query-параметры

Поля ответа

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

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

Коды ошибок

Авторизации

Параметры запроса

Ответ

​Query-параметры

​Поля ответа

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

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

​Коды ошибок

Авторизации

Параметры запроса

Ответ

Query-параметры

Поля ответа

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

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

Коды ошибок