Снимок рынка
Собрать запрос
Меняйте значения — команда меняется следом. Токен здесь не вводится: команда берёт его из переменной окружения SPECTRE_LOCAL_API_TOKEN. Запускайте её в своей командной строке.
curl 'http://127.0.0.1:48180/v1/market/snapshot?instrument=binance:futures:BTCUSDT' \ -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"
Последнее, что терминал знает о паре. Поле равно null, пока его данные не пришли. best_bid и best_ask — это [price, size] из стакана.
bearerToken market:readАвторизацияBearer <token>Токен Local API: spt_ и 64 шестнадцатеричных символа. Скопируйте его в Settings App → Общие → Local API. Он принимается только в заголовке Authorization. Имена, перечисленные у операции, — это права, которые ей нужны. У токена терминала есть все.
Право: market:read
instrument*stringАдрес инструмента, exchange:market:symbol.
connection_id?integerПодключение, через которое читать. Без него терминал берёт включённое торговое подключение биржи и рынка, а если такого нет — подключение только для чтения.
int64Снимок.
application/json- response
instrument*stringconnection_id*integerint64ts*integerint64best_bid*array<string>|nullbest_ask*array<string>|nulllast_trade*|nullmark_price*string|nullticker*|nullcurl 'http://127.0.0.1:48180/v1/market/snapshot?instrument=binance:futures:BTCUSDT' \ -H "Authorization: Bearer $SPECTRE_LOCAL_API_TOKEN"{ "instrument": "binance:futures:BTCUSDT", "connection_id": 12, "ts": 1730294400130, "best_bid": [ "67000.1", "1.25" ], "best_ask": [ "67000.2", "0.40" ], "last_trade": { "id": null, "price": "67000.1", "qty": "0.012", "side": "buy", "ts": 1730294400125, "exchange_ts": 1730294400119 }, "mark_price": "67001.0", "ticker": { "price": "67000.1", "change_24h_pct": "1.25", "volume_24h": "81234.5", "high_24h": null, "low_24h": null, "best_bid": null, "best_ask": null, "ts": 1730294400120 }}Последние сделки GET
Последние сделки пары, от старых к новым. Терминал хранит последние 1000 сделок пары. Если за 3 с не пришло ни одной сделки, ответ пустой.
Верхушка стакана GET
Верхние уровни стакана. Уровень — это `[price, size]`. Если полный стакан не пришёл за 3 с, ответ — `503 unavailable`, потому что пустой стакан выглядел бы как пустой рынок.