Посилання lootx://

Повний довідник схеми lootx://: команди, параметри, адресація інструмента та повідомлення термінала. Покрокове керівництво з прикладами кнопки — у розділі Кнопка «Відкрити в LootX».

Формат

TEXT

lootx://<команда>?<параметр>=<значення>&<параметр>=<значення>

Правило	Значення
Команда	З закритого списку нижче. Невідома команда підіймає вікно термінала й показує повідомлення.
Символи у значеннях	Латиниця, цифри, `_ . : -`. Значення не може починатися з `-` або `/`.
Кодування	Значення можна передавати у percent-encoding (`BYBIT%3ASOLUSDT.P`): термінал декодує їх один раз, потім перевіряє.
Довжина	Посилання — до 1500 символів, символ інструмента та `src` — до 32.
Порядок параметрів	Будь-який. Якщо параметр повторюється, діє перше входження.
Невідомі параметри	Пропускаються без помилки.

Неприпустиме значення термінал відкидає, ніби параметр не передали. Тому помилка в символі зазвичай перетворюється на повідомлення «прийшла без інструмента».

Команди

LINKlootx://open/instrument

Відкриває інструмент у вже відкритій панелі: у вибраній, а якщо вона не показує монету (наприклад, «Позиції») — у першій підхожій на активній вкладці. Підхожої панелі немає — створює нову. Куди саме відкривати, задає target.

Потрібен інструмент — t, id або v + s. Можна додати target, link, layout, level, src. З level термінал заодно ставить рівень ціни, а з layout=all-exchanges відкриває монету на всіх біржах.

TEXT

lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapp

LINKlootx://open/panel

Завжди створює нову панель типу layout і відкриває в ній інструмент — навіть якщо така панель уже є.

Потрібен інструмент. Можна додати layout (за замовчуванням — біржовий стакан), target, link, level, src.

TEXT

lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myapp

LINKlootx://open/all-exchanges

Розкладає монету по всіх біржах із налаштування користувача «Всі біржі».

Потрібен символ: s=SOLUSDT або інструмент у t / id, з якого візьметься символ. Біржа тут не важлива — навіть t=HTX:BTCUSDT розкладе BTCUSDT по біржах LootX. target=window відкриває розкладку в новому вікні, target=tab — у новій вкладці. Без target — як налаштовано в користувача.

TEXT

lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myapp

LINKlootx://open/terminal

Підіймає вікно термінала — і більше нічого не робить.

TEXT

lootx://open/terminal

LINKlootx://link/set

Призначає інструмент групі зв’язку g: усі панелі групи в усіх вікнах перемикаються на нього. Нових панелей не відкриває — якщо в групі поки порожньо, команда все одно виконується.

Потрібні g та інструмент.

TEXT

lootx://link/set?g=3&t=BINANCE:BTCUSDT.P&src=myapp

LINKlootx://link/clear

Скидає інструмент, закріплений за групою зв’язку g.

Потрібен g.

TEXT

lootx://link/clear?g=3&src=myapp

LINKlootx://level/set

Ставить горизонтальний рівень ціни. З інструментом термінал спочатку перемикається на нього, без інструмента — ставить рівень на монету, яка відкрита зараз. Рівень з’являється в біржовому стакані, а через дзеркало рівнів — і на графіку.

Потрібна price. Можна додати інструмент, link, src.

TEXT

lootx://level/set?t=BINANCE:BTCUSDT.P&price=64821.5&src=myapp

LINKlootx://level/clear

Знімає рівні, які поставив сервіс із тим самим src (0.6.53+). З price — рівень у рядку цієї ціни, без неї — усі ваші рівні на монеті, в усіх вікнах. Працює й тоді, коли біржовий стакан монети закритий, і не перемикає інструмент. Рівні, намальовані користувачем або поставлені іншими сервісами, залишаються.

Можна додати інструмент, price, link, src. Без інструмента монета береться з вибраної панелі або з групи link.

TEXT

lootx://level/clear?t=BINANCE:BTCUSDT.P&src=myapp

Параметри

Параметр	Значення	За замовчуванням	Призначення
`t`	`БІРЖА:СИМВОЛ` або `БІРЖА:СИМВОЛ.P`	—	Інструмент у форматі TradingView
`v`	код біржі	—	Біржа — разом із `s` і `m`
`m`	`spot`, `perp`	`spot`	Ринок; `futures` і `swap` читаються як `perp`
`s`	символ біржі, до 32 знаків	—	Наприклад, `BTCUSDT`
`id`	`біржа_ринок_база_котирування[_xМНОЖНИК]`	—	Канонічний ідентифікатор інструмента
`target`	`current`, `group`, `tab`, `window`, `pane`	`current`	Куди відкривати
`layout`	див. таблицю нижче	`orderbook`	Яку панель створити
`link`	`0`–`100`, `active`	—	Група зв’язку для відкриваного; `0` — без групи
`g`	`1`–`100`	—	Група для `link/set` і `link/clear`
`ifEmpty`	`create`	—	Створити панель, якщо при `target=group` у групі порожньо. Без параметра — не створювати
`pane`	ідентифікатор панелі	—	Адресат при `target=pane`
`price`, `level`	додатне число з крапкою: `64821.5`	—	Ціна рівня. Кома й експонента (`1e5`) не приймаються. `level` у `open/*` ставить рівень заодно з відкриттям
`src`	ім’я сервісу, до 32 знаків	`unknown`	Хто надіслав команду: показується в повідомленнях і позначає рівні

Передавайте src завжди: без нього користувач побачить у повідомленні unknown, а рівні від різних сервісів не можна буде зняти окремо.

Як указати інструмент

Три форми. Якщо в посиланні їх кілька, діє перша за порядком id → t → v + m + s, решта пропускаються.

TEXT

t=BINANCE:BTCUSDT.P    безстроковий ф'ючерс
t=BINANCE:BTCUSDT      спот

Найзручніша форма для скринерів: беріть той самий код, що й у посиланні на графік TradingView.

TEXT

v=bybit&m=perp&s=SOLUSDT
v=binance&s=ETHUSDT          без m — спот

TEXT

id=binance_perp_btc_usdt
id=binance_perp_pepe_usdt_x1000

Формат біржа_ринок_база_котирування, суфікс _xN — для контрактів із множником.

Символ термінал шукає у списку інструментів біржі: регістр і роздільники не важливі (btcusdt, BTC-USDT), а PEPEUSDT знайде ф’ючерс 1000PEPEUSDT. Якщо на біржі немає запитаного ринку — наприклад, ф’ючерсів на Upbit, — відкриється той, що є.

Біржі

Біржа	Код	Також приймається	Ринки
Binance	`BINANCE`	—	спот, ф’ючерси
Bybit	`BYBIT`	—	спот, ф’ючерси
OKX	`OKX`	`OKEX` ¹	спот, ф’ючерси
Bitget	`BITGET`	—	спот, ф’ючерси
Gate	`GATE`	`GATEIO` ¹	спот, ф’ючерси
MEXC	`MEXC`	—	спот, ф’ючерси
KuCoin	`KUCOIN`	—	спот, ф’ючерси
BingX	`BINGX`	—	спот, ф’ючерси
Hyperliquid	`HYPERLIQUID`	`HL` ¹	спот, ф’ючерси
Aster	`ASTER`	`ASTERDEX` ¹	спот, ф’ючерси
Binance Alpha	`BINANCEALPHA`	`ALPHA` ¹	спот
Upbit	`UPBIT`	—	спот

¹ З версії 0.6.53.

Код однаково працює в t і v, регістр не важливий: binance і BINANCE рівнозначні. Біржі, яких немає в LootX (наприклад, HTX, BitMart, Coinbase), термінал називає в повідомленні: «Біржа «HTX» у LootX не підтримується» (0.6.53+).

Куди відкривати

Значення	Що відбувається
`current`	Вибрана панель. Разом із `link` інструмент отримує й уся група.
`group`	Тільки панелі групи `link` в усіх вікнах, вибрана не змінюється. Якщо в групі порожньо — повідомлення або нова панель при `ifEmpty=create`.
`tab`	Нова вкладка.
`window`	Нове вікно. З 0.6.53 воно відкривається як поточне: у розгорнутого термінала — розгорнутим.
`pane`	Конкретна панель за `pane=<id>` у будь-якому вікні, включно з відкріпленими.

Що створити

Значення	Панель
`orderbook`	Біржовий стакан
`chart`	Графік
`tape`	Стрічка угод
`liqmap`	Карта ліквідності
`combo1`	Зв’язка: графік зверху, біржовий стакан знизу
`combo2`	Зв’язка: біржовий стакан зверху, графік знизу
`combo3`	Зв’язка: графік зверху, два біржові стакани знизу
`combo4`	Зв’язка: два біржові стакани зверху, графік знизу
`all-exchanges`	Монета на всіх біржах

Групи зв’язку

Панелі термінала об’єднуються в групи зв’язку: зміна монети в одній панелі перемикає всю групу — в усіх вікнах, включно з фоновими вкладками. В інтерфейсі групи розрізняються кольором, у посиланні — тільки номером.

Значення	Що означає
`1`–`100`	Група з цим номером
`active`	Режим «До активного вікна»: панель показує ту саму монету, що й вибрана панель (тільки в `link`)
`0`	Без групи: нова панель ні за чим не слідує (тільки в `link`)

Повідомлення термінала

Успішна команда виконується мовчки. Якщо виконати її не вдалося, термінал підіймає вікно й показує повідомлення з іменем із src:

Ситуація	Повідомлення
Невідома команда	Невідома команда від «myapp»
Немає інструмента	Команда від «myapp» прийшла без інструмента
Інструмент не знайдено	BTCUSDX — не знайдено (запит від «myapp»)
Біржа не підтримується ¹	Біржа «HTX» у LootX не підтримується (запит від «myapp»)
Біржу не вказано ¹	Команда від «myapp» не вказала біржу
У групі немає панелей	У групі 3 немає панелей (запит від «myapp»)
Панель не знайдено	Панель не знайдено (запит від «myapp»)
Немає ціни рівня	Команда від «myapp» прийшла без ціни рівня
Інший збій	Не вдалося виконати команду від «myapp»

¹ З версії 0.6.53.

Обмеження

Що	Значення
Частота	До 10 команд на секунду, зайві відкидаються без повідомлення.
Черга	До 32 команд. При переповненні першими йдуть найстаріші.
Повтори	Нова команда в ту саму ціль замінює ще не виконану. Команди рівнів не замінюються й виконуються по порядку.
Торгівля	Недоступна: посиланням не можна виставити, змінити чи скасувати ордер.
Відповідь	Відсутня: канал односторонній, термінал нічого не повідомляє сайту.