LootX

Інструменти та стан

Оновлено 7 листопада 2026 р. Ця сторінка у PDF

Які є інструменти та в яких видах даних — реєстр /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. Маршрут не входить до жодної групи тарифу і витрачає тільки загальні ліміти.