LootX

Скринер

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

Метрики по сотнях інструментів одним запитом — ціна, зміна, обсяг, ставка фінансування, 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: оновлення приходять лише за зміненими метриками. За всім ринком одразу стежить підписка на весь ринок з фільтрами за біржами, ринками та метриками.