← К документации
LootX

Инструменты и состояние

Собрано: 2026-11-21 docs.lootx.trade
Справочник

1Инструменты и состояние

Какие инструменты есть и в каких видах данных — реестр /v1/instruments; здоровы ли источники — /v1/status.

Группа тарифа — instruments. Начните с реестра: он показывает, как называется инструмент и в каких маршрутах по нему есть данные.

Реестр инструментов

GET/v1/instruments

Все инструменты всех источников с одним каноническим именем. Колонка sources — где он есть: candles, footprint, densities, screener.

Параметр Что
venue биржа: binance, okx, …
market spot или perp. Датированных фьючерсов и опционов пока нет
source только инструменты с данными в этом виде: candles, footprint, densities, screener
q подстрока символа, без учёта регистра: q=btc
limit строк на страницу, 1–10 000, по умолчанию 1000
cursor курсор из next_cursor
Shell
curl -s "https://market-api.lootx.trade/v1/instruments?venue=binance&market=perp&q=BTC" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "columns": ["instrument", "venue", "market", "symbol", "sources"],
  "rows": [
    ["binance:perp:BTCUSDT", "binance", "perp", "BTCUSDT", ["candles", "footprint", "densities", "screener"]],
    ["binance:perp:BTCUSDC", "binance", "perp", "BTCUSDC", ["candles", "footprint", "densities"]]
  ],
  "next_cursor": null,
  "updated_at": 1793750400000
}

updated_at — когда шлюз в последний раз получил список хотя бы от одного источника, 0 — ещё ни разу. Реестр обновляется раз в 5 минут и показывает то, что источники собирают прямо сейчас, а не все листинги бирж. Новая пара появится, когда её начнёт собирать источник; у части источников это происходит после порога суточного оборота.

Состояние источников

GET/v1/status

Отвечают ли источники данных за шлюзом и с какой задержкой. Удобно для своего мониторинга: если ok: false, ошибки 502/504 по маршрутам этого источника ожидаемы.

JSON
{
  "ok": true,
  "ts": 1793750400000,
  "upstreams": [
    { "name": "data", "ok": true, "latency_ms": 12, "http_status": 200 },
    { "name": "clusters", "ok": true, "latency_ms": 18, "http_status": 200 }
  ]
}

У /v1/status нет таблицы, поэтому нет и CSV — только JSON и protobuf. Маршрут не входит ни в одну группу тарифа и расходует только общие лимиты.

https://docs.lootx.trade/ru/market-api/instruments