Перейти до вмісту
Spectre Docs
ПосібникРозробникам
HTTP APIРинкові дані

Верх стакана

Зібрати запит

Змінюйте значення — команда змінюється слідом. Токен тут не вводиться: команда бере його зі змінної оточення SPECTRE_LOCAL_API_TOKEN. Запускайте її у своєму командному рядку.

Команда
curl 'http://127.0.0.1:48180/v1/market/orderbook?instrument=binance:futures:BTCUSDT&depth=20' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
/market/orderbook

Верхні рівні стакана. Рівень — це [price, size]. Якщо повний стакан не надійшов за 3 с, відповідь — 503 unavailable, бо порожній стакан виглядав би як порожній ринок.

Авторизація

bearerToken market:read
headerАвторизаціяBearer <token>

Токен Local API: spt_ і 64 шістнадцяткові символи. Скопіюйте його в Settings App → Загальні → Local API. Він приймається лише в заголовку Authorization. Назви, перелічені біля операції, — це права, яких вона потребує. Токен термінала має їх усі.

Право: market:read

Параметри запиту

instrument*string

Адреса інструмента, exchange:market:symbol.

connection_id?integer

Підключення, через яке читати. Без нього термінал бере ввімкнене торгове підключення біржі й ринку, а якщо його немає — підключення лише для читання.

Форматint64
depth?integer

Рівнів з кожного боку.

Діапазон1 <= value <= 200
За замовчуванням50

Тіло відповіді

Верх стакана.

application/json
  1. response
instrument*string
connection_id*integer
Форматint64
ts*integer
Форматint64
depth*integer

Запитана глибина.

bids*array<array<string>>

Від найкращої ціни вниз.

asks*array<array<string>>

Від найкращої ціни вгору.

Приклад запиту
curl 'http://127.0.0.1:48180/v1/market/orderbook?instrument=binance:futures:BTCUSDT&depth=20' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Приклад відповіді
{  "instrument": "binance:futures:BTCUSDT",  "connection_id": 12,  "ts": 1730294400123,  "depth": 20,  "bids": [    [      "67000.1",      "1.25"    ]  ],  "asks": [    [      "67000.2",      "0.40"    ]  ]}

Знімок ринку GET

Найсвіжіше, що термінал знає про пару. Поле дорівнює `null`, поки його дані не надійшли. `best_bid` і `best_ask` — це `[price, size]` зі стакана.

Кластери обсягу GET

До десяти останніх бакетів кластерів, від старих до нових. Інтервал — той, що вибрано для інструмента в терміналі, типово `5m`. Для інструмента, не відкритого в терміналі, перший виклик запускає обчислення й чекає історії до 3 с.