Перейти к содержимому
HTTP APIРыночные данные

Список инструментов

Собрать запрос

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

Команда
curl 'http://127.0.0.1:48180/v1/instruments?exchange=binance&market=futures&q=btc&limit=50' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
/instruments

Справочник инструментов одной биржи и рынка, страницами по порядку символов. Передайте либо connection_id, либо exchange и market вместе. Шаги и минимумы равны null, если биржа их не сообщила.

Авторизация

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

Токен Local API: spt_ и 64 шестнадцатеричных символа. Скопируйте его в Settings App → Общие → Local API. Он принимается только в заголовке Authorization. Имена, перечисленные у операции, — это права, которые ей нужны. У токена терминала есть все.

Право: market:read

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

connection_id?integer

Подключение, биржу и рынок которого нужно листать.

Форматint64
exchange?string

Название биржи. Используется вместе с market.

market?string

Тип рынка. Используется вместе с exchange.

q?string

Часть символа или базовой монеты. Регистр не важен.

limit?integer

Размер страницы. Значение вне диапазона приводится к его границе.

Диапазон1 <= value <= 2000
По умолчанию500
cursor?string

next_cursor предыдущей страницы.

Тело ответа

Одна страница справочника.

application/json
  1. response
exchange*string
market*string
data*array<>
next_cursor*|

Передаётся как cursor для следующей страницы. На последней странице — null.

Пример запроса
curl 'http://127.0.0.1:48180/v1/instruments?exchange=binance&market=futures&q=btc&limit=50' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Пример ответа
{  "exchange": "binance",  "market": "futures",  "data": [    {      "instrument": "binance:futures:BTCUSDT",      "exchange": "binance",      "market": "futures",      "symbol": "BTCUSDT",      "base": "BTC",      "quote": "USDT",      "status": "active",      "tick_size": "0.1",      "lot_size": "0.001",      "min_size": "0.001",      "contract_value": "1"    }  ],  "next_cursor": null}