Скринер
1Скринер
Метрики по сотням инструментов одним запросом — цена, изменение, объём, фандинг, OI и их изменения за окна; справочник всех метрик.
Снимок скринера
/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 |
curl -s "https://market-api.lootx.trade/v1/screener?venue=binance&market=perp&top_n=2" \
-H "Authorization: Bearer $LOOTX_API_KEY"{
"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.
Справочник метрик
/v1/screener/metricsКакие колонки бывают у скринера: короткий ключ, длинное имя, единица, окно, группа и описание. Статичен — можно закэшировать у себя. Та же группа screener.
{
"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