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

История свечей

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

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

Команда
curl 'http://127.0.0.1:48180/v1/market/candles?instrument=binance:futures:BTCUSDT&interval=1m&limit=100' \
  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
GET
/market/candles

История свечей инструмента. Читается так же, как её читает график терминала. ts — время открытия бара.

Авторизация

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
interval*string

Код интервала из GET /market/intervals.

limit?integer

Число баров.

Диапазонvalue <= 2000
По умолчанию500
end?integer

Правая граница в миллисекундах UTC. По умолчанию — сейчас.

Форматint64

Тело ответа

Бары, от старых к новым.

application/json
  1. response
instrument*string
connection_id*integer

Подключение, через которое прочитана история.

Форматint64
interval*string
data*array<>
Пример запроса
curl 'http://127.0.0.1:48180/v1/market/candles?instrument=binance:futures:BTCUSDT&interval=1m&limit=100' \  -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Пример ответа
{  "instrument": "binance:futures:BTCUSDT",  "connection_id": 12,  "interval": "1m",  "data": [    {      "ts": 1730294400000,      "open": "67000.1",      "high": "67010.5",      "low": "66990.0",      "close": "67003.4",      "volume": "52.1",      "quote_volume": "3490000.5",      "closed": true    }  ]}