Перейти к содержимому
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        }      ]    }  ]}