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

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

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

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

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

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

Авторизація

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

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

Найновіші бакети.

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

Інтервал, вибраний для інструмента в терміналі.

ts*integer
Форматint64
data*array<>
Приклад запиту
curl 'http://127.0.0.1:48180/v1/market/clusters?instrument=binance:futures:BTCUSDT' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Приклад відповіді
{  "instrument": "binance:futures:BTCUSDT",  "connection_id": 12,  "interval": "5m",  "ts": 1730294400123,  "data": [    {      "interval": "5m",      "ts": 1730294100000,      "end_ts": 1730294400000,      "volume": "12.5",      "buy_volume": "7.25",      "sell_volume": "5.25",      "trades": 120,      "vwap": "67000.1",      "min_price": "66990.0",      "max_price": "67010.5",      "completed": false,      "last_trade_ts": 1730294399870,      "levels": [        {          "price": "67000.1",          "volume": "1.25",          "buy_volume": "0.75",          "sell_volume": "0.5",          "buy_trades": 3,          "sell_trades": 2        }      ]    }  ]}