API
Посилання lootx:// — відкрити монету в терміналі з вашого сайту, бота або скринера
1Кнопка «Відкрити в LootX»
Як додати на сайт скринера, сигнального сервісу або аналітики кнопку, що відкриває монету прямо в терміналі LootX: посилання lootx://, приклади на HTML, React та JavaScript.
Кнопка «Відкрити в LootX» переносить користувача з вашого сервісу прямо в торговий термінал: потрібна монета, біржа й ринок, потрібна панель — одним кліком. Технічно це звичайне посилання зі схемою lootx://. API-ключі, реєстрація та серверна частина на вашому боці не потрібні.
Як це працює
Користувач натискає кнопку
На вашій сторінці — звичайне посилання виду lootx://open/instrument?….
Браузер запитує дозвіл
Під час першого переходу браузер запитає, чи можна відкрити LootX. У Chrome та Edge можна позначити «Завжди дозволяти» — тоді питання для вашого сайту більше не з’явиться.
Термінал виконує команду
Якщо LootX уже запущено, команда надходить у відкрите вікно — друга копія термінала не відкриється. Якщо закрито, Windows запустить його, і команда виконається після старту.
Швидкий старт
Зберіть посилання
Потрібні код інструмента у форматі TradingView — t, де суфікс .P означає безстроковий ф’ючерс, — та ім’я вашого сервісу src: його користувач побачить у повідомленні термінала, якщо команду не вдасться виконати.
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myscreenerПоставте посилання на кнопку
Підійде будь-який елемент, по якому користувач клікає сам, — приклади нижче.
Перевірте
Відкрийте сторінку на комп’ютері зі встановленим LootX і натисніть кнопку. Термінал підніме вікно й відкриє BTCUSDT в активній панелі.
<a class="open-in-lootx"
href="lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myscreener">
Відкрити в LootX
</a>type Props = { exchange: string; symbol: string; perp?: boolean };
export function OpenInLootX({ exchange, symbol, perp = true }: Props) {
const t = `${exchange}:${symbol}${perp ? ".P" : ""}`;
const query = new URLSearchParams({ t, src: "myscreener" });
return <a href={`lootx://open/instrument?${query}`}>Відкрити в LootX</a>;
}// Одна функція на всі команди: значення кодуються, src підставляється завжди.
export function lootxLink(command, params = {}) {
const query = new URLSearchParams({ ...params, src: "myscreener" });
return `lootx://${command}?${query}`;
}
lootxLink("open/instrument", { t: "BYBIT:SOLUSDT.P" });
// → lootx://open/instrument?t=BYBIT%3ASOLUSDT.P&src=myscreenerСпробуйте прямо звідси:
Спрацює, якщо на цьому комп’ютері встановлено LootX для Windows.
Готові посилання
- Відкрити ф’ючерс в активній панелі
lootx://open/instrument?t=BYBIT:SOLUSDT.P&src=myapp - Відкрити спот
lootx://open/instrument?t=BINANCE:ETHUSDT&src=myapp - Показати монету на всіх біржах у новому вікні
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myapp - Відкрити графік у новому вікні
lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myapp - Надіслати монету в групу зв’язку 3
lootx://open/instrument?t=OKX:ETHUSDT.P&link=3&target=group&src=myapp - Відкрити монету й одразу позначити рівень
lootx://open/instrument?t=BINANCE:BTCUSDT.P&level=64821.5&src=myapp - Позначити рівень
lootx://level/set?t=BINANCE:BTCUSDT.P&price=64821.5&src=myapp - Зняти свої рівні (0.6.53+)
lootx://level/clear?t=BINANCE:BTCUSDT.P&src=myapp
Усі команди та параметри — у довіднику посилань lootx://.
Рівні від вашого сервісу
Скринер щільностей або сервіс сигналів може позначати в терміналі важливі ціни. level/set ставить горизонтальний рівень на монеті, а level/clear знімає його.
З версії 0.6.53 кожен рівень позначається вашим src: стрічка угод підписує лінію іменем сервісу, а level/clear знімає тільки ваші рівні — намальовані користувачем і поставлені іншими сервісами залишаються на місці. Так можна безпечно оновлювати розмітку: спочатку зняти свої рівні, потім поставити нові.
Як викликати посилання правильно
- З основного вікна сторінки. З iframe з атрибутом
sandboxбраузер посилання не відкриє. Якщо ваш віджет вбудовують на чужі сайти, відкривайте посилання у верхньому вікні. - Кодуйте значення. Збирайте посилання через
URLSearchParamsабоencodeURIComponent. У значеннях допустимі латиниця, цифри та_ . : -, усе посилання — до 1500 символів. - Показуйте запасний варіант. Надійно дізнатися з браузера, чи встановлено термінал, не можна. Відкрийте посилання одразу, а через кілька секунд ненав’язливо запропонуйте допомогу.
openButton.addEventListener("click", () => {
location.href = lootxLink("open/instrument", { t: "BINANCE:BTCUSDT.P" });
// Не «термінал не встановлено», а підказка на випадок, якщо нічого не сталося.
setTimeout(() => {
hint.textContent = "Нічого не відкрилося? Встановіть LootX для Windows.";
hint.hidden = false;
}, 3000);
});Безпека та обмеження
| Правило | Що це означає для інтеграції |
|---|---|
| Тільки навігація | Посилання відкриває монету, панель або вікно і ставить рівні. Виставити, змінити або скасувати ордер посиланням не можна — таких команд у схемі немає. |
| Без зворотного каналу | Термінал нічого не відповідає сайту й нічого не повідомляє про користувача. Успішна команда виконується мовчки. |
| Сувора перевірка | Команди — із закритого списку, значення — з дозволених символів. Неприпустиме значення термінал відкидає, ніби його не передали. |
| Обмеження частоти | До 10 команд на секунду, зайві відкидаються. Повторна команда в ту саму ціль замінює ще не виконану; команди рівнів виконуються всі й по порядку. |
| Сумісність | Невідомі параметри термінал пропускає, тому нові параметри не ламають старі версії. |
Далі
https://docs.lootx.trade/uk/api/open-in-lootx
2Посилання lootx://
Довідник схеми lootx://: команди, параметри, формати інструмента, біржі, групи зв'язку, повідомлення термінала та обмеження.
Повний довідник схеми lootx://: команди, параметри, адресація інструмента та повідомлення термінала. Покрокове керівництво з прикладами кнопки — у розділі Кнопка «Відкрити в LootX».
Формат
lootx://<команда>?<параметр>=<значення>&<параметр>=<значення>| Правило | Значення |
|---|---|
| Команда | З закритого списку нижче. Невідома команда підіймає вікно термінала й показує повідомлення. |
| Символи у значеннях | Латиниця, цифри, _ . : -. Значення не може починатися з - або /. |
| Кодування | Значення можна передавати у percent-encoding (BYBIT%3ASOLUSDT.P): термінал декодує їх один раз, потім перевіряє. |
| Довжина | Посилання — до 1500 символів, символ інструмента та src — до 32. |
| Порядок параметрів | Будь-який. Якщо параметр повторюється, діє перше входження. |
| Невідомі параметри | Пропускаються без помилки. |
Неприпустиме значення термінал відкидає, ніби параметр не передали. Тому помилка в символі зазвичай перетворюється на повідомлення «прийшла без інструмента».
Команди
lootx://open/instrumentВідкриває інструмент у вже відкритій панелі: у вибраній, а якщо вона не показує монету (наприклад, «Позиції») — у першій підхожій на активній вкладці. Підхожої панелі немає — створює нову. Куди саме відкривати, задає target.
Потрібен інструмент — t, id або v + s. Можна додати target, link, layout, level, src. З level термінал заодно ставить рівень ціни, а з layout=all-exchanges відкриває монету на всіх біржах.
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapplootx://open/panelЗавжди створює нову панель типу layout і відкриває в ній інструмент — навіть якщо така панель уже є.
Потрібен інструмент. Можна додати layout (за замовчуванням — біржовий стакан), target, link, level, src.
lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myapplootx://open/all-exchangesРозкладає монету по всіх біржах із налаштування користувача «Всі біржі».
Потрібен символ: s=SOLUSDT або інструмент у t / id, з якого візьметься символ. Біржа тут не важлива — навіть t=HTX:BTCUSDT розкладе BTCUSDT по біржах LootX. target=window відкриває розкладку в новому вікні, target=tab — у новій вкладці. Без target — як налаштовано в користувача.
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myapplootx://open/terminalПідіймає вікно термінала — і більше нічого не робить.
lootx://open/terminallootx://link/setПризначає інструмент групі зв’язку g: усі панелі групи в усіх вікнах перемикаються на нього. Нових панелей не відкриває — якщо в групі поки порожньо, команда все одно виконується.
Потрібні g та інструмент.
lootx://link/set?g=3&t=BINANCE:BTCUSDT.P&src=myapplootx://link/clearСкидає інструмент, закріплений за групою зв’язку g.
Потрібен g.
lootx://link/clear?g=3&src=myapplootx://level/setСтавить горизонтальний рівень ціни. З інструментом термінал спочатку перемикається на нього, без інструмента — ставить рівень на монету, яка відкрита зараз. Рівень з’являється в біржовому стакані, а через дзеркало рівнів — і на графіку.
Потрібна price. Можна додати інструмент, link, src.
lootx://level/set?t=BINANCE:BTCUSDT.P&price=64821.5&src=myapplootx://level/clearЗнімає рівні, які поставив сервіс із тим самим src (0.6.53+). З price — рівень у рядку цієї ціни, без неї — усі ваші рівні на монеті, в усіх вікнах. Працює й тоді, коли біржовий стакан монети закритий, і не перемикає інструмент. Рівні, намальовані користувачем або поставлені іншими сервісами, залишаються.
Можна додати інструмент, price, link, src. Без інструмента монета береться з вибраної панелі або з групи link.
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, решта пропускаються.
t=BINANCE:BTCUSDT.P безстроковий ф'ючерс
t=BINANCE:BTCUSDT спотНайзручніша форма для скринерів: беріть той самий код, що й у посиланні на графік TradingView.
v=bybit&m=perp&s=SOLUSDT
v=binance&s=ETHUSDT без m — спот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 команд. При переповненні першими йдуть найстаріші. |
| Повтори | Нова команда в ту саму ціль замінює ще не виконану. Команди рівнів не замінюються й виконуються по порядку. |
| Торгівля | Недоступна: посиланням не можна виставити, змінити чи скасувати ордер. |
| Відповідь | Відсутня: канал односторонній, термінал нічого не повідомляє сайту. |
https://docs.lootx.trade/uk/api/deep-links
3Варіанти відкриття та групи зв'язку
Усі способи відкрити монету посиланням lootx://: вибрана панель, група зв'язку, нова панель, вкладка або вікно, всі майданчики, рівень разом із монетою — з готовими посиланнями та порівнянням.
Одна й та сама монета може відкритися в терміналі по‑різному: у панелі, на яку користувач дивиться прямо зараз, у всій її зв’язці панелей, у новій вкладці або вікні, одразу на всіх майданчиках. Тут зібрані всі варіанти — з готовим посиланням, описом того, що станеться в терміналі, і підказкою, коли який обрати.
Основи і приклад кнопки — в Кнопка «Открыть в LootX", повний список параметрів — в довіднику посилань lootx://.
З чого складається варіант
Монета в ссылке задаётся почти всегда одинаково — t=БИРЖА:СИМВОЛ, с .P для бессрочного фьючерса. Вариант открытия определяют три других параметра:
| Питання | Параметр | Значення |
|---|---|---|
| Куди відкрити | target |
вибрана панель · тільки група зв’язку · нова вкладка · нове вікно |
| З якою групою зв’язати | link |
1–100 — група, active — «К активному окну», 0 — без групи |
| Яку панель створити, якщо створюється нова | layout |
біржовий стакан, графік, стрічка угод, карта ліквідності, зв’язки, усі біржі |
Без цих параметрів посилання працює як варіант за замовчуванням — змінює монету в вибраній панелі.
Оберіть варіант
Варіант за замовчуванням: користувач клікнув — і бачить монету там, куди дивиться.
У вибраній панелі і в групіМонета приходить і в поточну панель, і в усю зв’язку користувача.
Тільки в групіЗв’язка переключається, а те, з чим користувач працює зараз, залишається на місці.
Нова панель, вкладка або вікноДодати графік або стакан, не чіпаючи відкриті панелі.
На всіх майданчикахОдна монета — колонки по всіх майданчиках користувача.
Рівень разом із монетоюВідкрити монету і поставити на неї лінію ціни однією ссылкою.
У панелі, на яку дивиться користувач
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapp- Монета відкривається в вибраній панелі — тій, з якою користувач працював останньою.
- Разом із нею переключаються її група зв’язку і панелі в режимі «К активному окну» — так само, як якби користувач обрав монету в списку терміналу.
- Якщо вибрана панель без монети, наприклад «Позиции», монета відкриється в першій підходящій панелі на цій вкладці. Підходящих немає — на вкладці з’явиться новий біржовий стакан.
Підходить, коли користувач клікає у вашому сервісі й одразу переводить погляд на термінал: скринер, таблиця сигналів, стрічка новин.
У вибраній панелі і в групі зв’язку
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&src=myapp- Монету отримує вибрана панель — як у варіанті за замовчуванням.
- Одночасно її отримують усі панелі групи 3 у всіх вікнах терміналу, включно з фоновими вкладками.
- Вибрана панель при цьому до групи 3 не приєднується: її власна зв’язка не змінюється.
Підходить, коли у користувача є окрема зв’язка «для вашого сервісу» і вона має слідувати за кожним кліком, а поточну панель теж потрібно переключити.
Тільки в групі зв’язку
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&target=group&src=myapp- Монету отримують тільки панелі групи 3 у всіх вікнах.
- Вибрана панель не змінюється: користувач може торгувати однією монетою й паралельно переглядати ваші сигнали в іншій зв’язці.
- Якщо в групі немає жодної панелі, термінал покаже повідомлення «В группе 3 нет панелей (запрос от «myapp»)».
Щоб замість повідомлення термінал сам підготував місце, додайте ifEmpty=create:
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&target=group&ifEmpty=create&src=myappЯкщо група пуста, на активній вкладці з’явиться нова панель — біржовий стакан або той тип, що вказано в layout, — і одразу вступить у групу 3. Наступні посилання прийдуть вже в неї.
Підходить більшості скринерів. Це найакуратніший варіант: ваш сервіс керує своєю зв’язкою панелей і не втручається в іншу роботу користувача. Як дати користувачу вибрати групу — у розділі Група зв’язку у вашому сервісі.
Нова панель поруч із поточними
lootx://open/panel?layout=chart&t=BINANCE:BTCUSDT.P&src=myappopen/panel завжди створює нову панель — навіть якщо така вже відкрита — і додає її на активну вкладку. Відкриті панелі не змінюються. Тип панелі задає layout:
layout |
Панель |
|---|---|
orderbook |
Біржовий стакан — за замовчуванням |
chart |
Графік |
tape |
Стрічка угод |
liqmap |
Карта ліквідності |
combo1 … combo4 |
Зв’язка графіка і стаканів — варіанти в довіднику |
З link=5 нова панель одразу вступає в групу 5, і решта панелей групи переключаються разом з нею.
У новій вкладці
lootx://open/panel?layout=combo1&t=BINANCE:BTCUSDT.P&target=tab&link=5&src=myappТермінал відкриває нову вкладку — або бере порожню, якщо вона вже є, — називає її за монетою і створює в ній панель layout. Без link панель не належить жодній групі.
У новому вікні
lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myappНове вікно з панеллю layout одразу виходить на передній план. З версії 0.6.53 воно відкривається так само, як поточне: якщо вікно терміналу розгорнуте, нове теж буде розгорнутим. Зручно для другого монітора.
Монета на всіх майданчиках
lootx://open/all-exchanges?s=SOLUSDT&src=myappТермінал розкладає монету колонками по всіх майданчиках — так, як це налаштовано у користувача в розділі «Усі біржі»: набір і порядок майданчиків, спот і ф’ючерси, положення графіка.
- Кожна колонка отримує свою групу зв’язку автоматично, тому колонки не заважають одна одній і іншим панелям.
- Без
targetрозкладка відкривається там, де вибрано в налаштуваннях користувача.target=tab— завжди нова вкладка,target=window— завжди нове вікно. - Майданчик тут не важливий, потрібен лише символ: навіть
t=HTX:BTCUSDTрозкладе BTCUSDT по майданчиках LootX.
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myappПідходить для арбітражних і аналітичних сервісів: користувач одразу порівнює стакани однієї монети на різних майданчиках.
Відкрити й одразу відзначити рівень
lootx://open/instrument?t=BINANCE:BTCUSDT.P&level=64821.5&link=3&target=group&src=myappПараметр level додається до будь‑якого варіанту відкриття: термінал спочатку відкриває монету так, як задають target і link, потім ставить горизонтальний рівень за ціною 64821.5. Рівень позначається вашим src, і пізніше його можна зняти командою level/clear, не зачепивши розмітку користувача. Деталі — в Уровни от вашего сервиса.
Переключити групу, нічого не відкриваючи
lootx://link/set?g=3&t=BINANCE:BTCUSDT.P&src=myappУсі панелі групи 3 у всіх вікнах переключаються на монету. Нових панелей команда не створює, вікна не відкриває і повідомлень не показує — навіть якщо в групі порожньо.
link/clear?g=3 скидає монету, запам’ятовану за групою, — відкриті панелі при цьому не змінюються.
Просто підняти термінал
lootx://open/terminal?src=myappРозгортає вікно терміналу і виводить його на передній план — наприклад, для кнопки «Перейти в термінал» поруч з іншими діями.
Порівняння варіантів
| Посилання | Вибрана панель | Панелі групи | Що з’являється |
|---|---|---|---|
open/instrument |
Змінюється разом зі своєю групою | — | Біржовий стакан, якщо підходящої панелі немає |
open/instrument + link=3 |
Змінюється | Група 3 змінюється | Біржовий стакан, якщо підходящої панелі немає |
open/instrument + link=3&target=group |
Не змінюється | Група 3 змінюється | Нічого; якщо група пуста — повідомлення |
… + ifEmpty=create |
Не змінюється | Група 3 змінюється | Панель у групі 3, якщо група пуста |
open/panel |
Не змінюється | З link — група змінюється |
Нова панель на вкладці |
open/panel + target=tab |
Не змінюється | З link — група змінюється |
Нова вкладка |
open/panel + target=window |
Не змінюється | З link — група змінюється |
Нове вікно |
open/all-exchanges |
Не змінюється | У кожної колонки своя група | Вкладка або вікно «Усі біржі» |
link/set?g=3 |
Не змінюється | Група 3 змінюється | Нічого |
Група зв’язку у вашому сервісі
Панелі терміналу об’єднуються в групи зв’язку: зміна монети в одній панелі переключає всю групу. В інтерфейсі терміналу групи відрізняються кольором, у посиланні — тільки номером.
Найкращий сценарій для скринера — дати користувачу один раз вибрати групу в налаштуваннях вашого сервісу й далі відправляти в неї кожен клік. Користувач не вибирає групу при кожному переході, а зв’язка терміналу завжди показує те, що він вибрав у вас.
Щоб вибір виглядав знайомо, пофарбуйте групи так само, як термінал:
| Група | Колір у терміналі | Код кольору |
|---|---|---|
1 |
Червоний | #EF5350 |
2 |
Синій | #42A5F5 |
3 |
Зелений | #66BB6A |
4 |
Оранжевий | #FFA726 |
5 |
Фіолетовий | #AB47BC |
6 |
Бірюзовий | #26C6DA |
7 |
Жовтий | #FFEE58 |
8 |
Рожевий | #EC407A |
// Группа, которую пользователь выбрал в ваших настройках (1–8).
const group = settings.lootxGroup ?? 3;
export function openInLootx(tvSymbol) {
const query = new URLSearchParams({
t: tvSymbol, // "BINANCE:BTCUSDT.P"
link: String(group),
target: "group",
ifEmpty: "create", // первый клик сам создаст панель в группе
src: "myscreener",
});
location.href = `lootx://open/instrument?${query}`;
}Що відбувається на боці терміналу
| Ситуація | Що буде |
|---|---|
| Термінал закритий | Windows запустить LootX. Команда чекатиме, поки термінал завантажиться, і виконається. |
| Термінал уже відкритий | Команда надходить у запущений термінал — друга копія не відкривається. |
| Вікно згорнуте або закрите іншими вікнами | При кожній команді вікно розгортається і виходить на передній план. |
| Відкрито кілька вікон | Команда приходить у активне вікно терміналу — те, де користувач працював останнім. |
| Користувач клікає багато разів підряд | Нова команда в ту ж ціль замінює ще не виконану: термінал відкриє останню вибрану монету, а не пролистає всі. Команди рівнів не замінюються і виконуються по черзі. |
| Команду не вдалось виконати | Термінал показує повідомлення з ім’ям із src — список у довіднику. |
Рецепти
Користувач вибирає групу в налаштуваннях скринера. Клік по рядку відкриває монету в цій групі і відзначає ціну щільності:
lootx://open/instrument?t=BINANCE:SOLUSDT.P&link=3&target=group&ifEmpty=create&level=182.45&src=densityscreenerКоли щільність з’їли, скринер знімає свою позначку — користувацька розмітка лишається:
lootx://level/clear?t=BINANCE:SOLUSDT.P&price=182.45&src=densityscreenerКожен сигнал відкриває монету поруч із поточною роботою користувача — в окремому вікні з графіком, яке зручно тримати на другому моніторі:
lootx://open/panel?layout=combo1&t=BYBIT:ETHUSDT.P&target=window&src=signalbotДля частих сигналів краще відправляти монету в одну групу, а не відкривати вікно на кожен сигнал:
lootx://open/instrument?t=BYBIT:ETHUSDT.P&link=5&target=group&ifEmpty=create&src=signalbotПорівняти монету на всіх майданчиках користувача — у новій вкладці:
lootx://open/all-exchanges?s=ETHUSDT&target=tab&src=arbitrageВідкрити два ринки однієї монети — спот і ф’ючерс — в різних групах:
lootx://open/instrument?t=BINANCE:ETHUSDT&link=1&target=group&ifEmpty=create&src=arbitrage
lootx://open/instrument?t=BINANCE:ETHUSDT.P&link=2&target=group&ifEmpty=create&src=arbitrageОдна посилання виконує одну команду: два посилання — це два кліки або два переходи підряд з одного обробника кліка.
Далі
https://docs.lootx.trade/uk/api/open-variants