Перейти до вмісту
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}