Знімок ринку
Зібрати запит
Змінюйте значення — команда змінюється слідом. Токен тут не вводиться: команда бере його зі змінної оточення 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`, бо порожній стакан виглядав би як порожній ринок.