Перейти до вмісту
HTTP APIРинкові дані

Знімок ринку

Зібрати запит

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

Найсвіжіше, що термінал знає про пару. Поле дорівнює null, поки його дані не надійшли. best_bid і best_ask — це [price, size] зі стакана.

Авторизація

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
ts*integer
Форматint64
best_bid*array<string>|null
best_ask*array<string>|null
last_trade*|null
mark_price*string|null
ticker*|null
Приклад запиту
curl '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  }}