Инструменты и состояние
1Инструменты и состояние
Какие инструменты есть и в каких видах данных — реестр /v1/instruments; здоровы ли источники — /v1/status.
Группа тарифа — instruments. Начните с реестра: он показывает, как называется инструмент и в каких маршрутах по нему есть данные.
Реестр инструментов
/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 |
curl -s "https://market-api.lootx.trade/v1/instruments?venue=binance&market=perp&q=BTC" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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 минут и показывает то, что источники собирают прямо сейчас, а не все листинги бирж. Новая пара появится, когда её начнёт собирать источник; у части источников это происходит после порога суточного оборота.
Состояние источников
/v1/statusОтвечают ли источники данных за шлюзом и с какой задержкой. Удобно для своего мониторинга: если ok: false, ошибки 502/504 по маршрутам этого источника ожидаемы.
{
"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