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

Скринер

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

1Скринер

Метрики по сотням инструментов одним запросом — цена, изменение, объём, фандинг, OI и их изменения за окна; справочник всех метрик.

Снимок скринера

GET/v1/screener

Таблица «инструмент × метрика» по рынку: последняя цена, изменение за сутки, объём, фандинг, OI и десятки других. Группа тарифа — screener.

Параметр Что
venue биржи через запятую, регистр не важен, тот же набор, что у рыночной подписки: Upbit у скринера нет. По умолчанию — все. Неизвестная биржа — 400 bad_request с param: "venue", а не «все биржи»
market spot, perp через запятую, регистр не важен. Другое значение — 400 bad_request
instruments точный набор инструментов через запятую, правила ниже. С ним venue и market не читаются. top_n действует и здесь: для набора больше 100 инструментов передайте top_n не меньше его размера, иначе ответ тихо обрежется
top_n первые N по суточному объёму, 1–2000, по умолчанию 100. 0 и значения больше 2000 прижимаются к границе
names имена колонок: long (по умолчанию: volume_24h_usd, oi_change_usd_5m, …) или short — короткие ключи (v24, odu5, …). Другое значение — 400 bad_request
Shell
curl -s "https://market-api.lootx.trade/v1/screener?venue=binance&market=perp&top_n=2" \
  -H "Authorization: Bearer $LOOTX_API_KEY"
JSON
{
  "ts": 1793750400000,
  "columns": ["instrument", "ts", "last_price", "change_24h_pct", "volume_24h_usd", "funding_rate", "open_interest"],
  "rows": [
    ["binance:perp:BTCUSDT", 1793750399870, 104250.5, 1.84, 18234455120.4, 0.0001, 8423311987.2],
    ["binance:perp:ETHUSDT", 1793750399912, 3712.44, -0.62, 9122870411.7, 0.000085, 4120098211.6]
  ],
  "next_cursor": null
}

Пример сокращён: настоящий ответ несёт все метрики, которые источник знает по инструменту. Метрики, которых у инструмента нет, приходят null.

Набор инструментов

  • Символ с реестром не сравнивается. Имя прошло проверки ниже, а инструмента у скринера нет, в том числе из-за опечатки, — строки по нему нет, ответ 200. Ни одного не нашлось — 200 с пустыми rows: сверяйтесь с /v1/instruments.
  • Неверная форма имени — 400 bad_instrument, весь запрос.
  • 400 unsupported_instrument с param: "instrument", весь запрос: рынок не spot и не perp; котировку символа не разобрать, как у okx:perp:BTC-USDT-SWAP; перп с котировкой не из USDT, USDC и USD, как у binance:perp:ETHBTC. Перпов Hyperliquid две последние проверки не касаются.
  • Биржа в имени не сверяется: неизвестная биржа даёт не отказ, а отсутствие строки.
  • У скринера дека нет: строка одна на все деки монеты, и в ответе она называется без дека. hyperliquid:perp:AAPLUSDC.XYZ и hyperliquid:perp:AAPLUSDC — одна строка hyperliquid:perp:AAPLUSDC.
  • Пустое значение instruments= — то же, что без параметра: весь рынок с учётом venue и market.

Справочник метрик

GET/v1/screener/metrics

Какие колонки бывают у скринера: короткий ключ, длинное имя, единица, окно, группа и описание. Статичен — можно закэшировать у себя. Та же группа screener.

JSON
{
  "columns": ["key", "name", "unit", "window", "group", "description"],
  "rows": [
    ["odu5", "oi_change_usd_5m", "usd", "5m", "oi", "Изменение открытого интереса за 5 минут в долларах: OI сейчас − OI 5 минут назад (опора ищется по времени)."]
  ]
}

Если источник завёл новую метрику раньше, чем она попала в справочник, она приходит под коротким ключом как есть — колонки с незнакомым именем не отбрасывайте молча.

Для живого скринера используйте канал screener в WebSocket: обновления приходят только по изменившимся метрикам. За всем рынком сразу следит подписка на весь рынок с фильтрами по биржам, рынкам и метрикам.

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