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