← До документації
LootX

API

Посилання lootx:// — відкрити монету в терміналі з вашого сайту, бота або скринера

Зібрано: 2026-11-21 docs.lootx.trade
Интеграции

1Кнопка «Відкрити в LootX»

Як додати на сайт скринера, сигнального сервісу або аналітики кнопку, що відкриває монету прямо в терміналі LootX: посилання lootx://, приклади на HTML, React та JavaScript.

Кнопка «Відкрити в LootX» переносить користувача з вашого сервісу прямо в торговий термінал: потрібна монета, біржа й ринок, потрібна панель — одним кліком. Технічно це звичайне посилання зі схемою lootx://. API-ключі, реєстрація та серверна частина на вашому боці не потрібні.

Як це працює

Користувач натискає кнопку

На вашій сторінці — звичайне посилання виду lootx://open/instrument?….

Браузер запитує дозвіл

Під час першого переходу браузер запитає, чи можна відкрити LootX. У Chrome та Edge можна позначити «Завжди дозволяти» — тоді питання для вашого сайту більше не з’явиться.

Термінал виконує команду

Якщо LootX уже запущено, команда надходить у відкрите вікно — друга копія термінала не відкриється. Якщо закрито, Windows запустить його, і команда виконається після старту.

Швидкий старт

Зберіть посилання

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

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

Поставте посилання на кнопку

Підійде будь-який елемент, по якому користувач клікає сам, — приклади нижче.

Перевірте

Відкрийте сторінку на комп’ютері зі встановленим LootX і натисніть кнопку. Термінал підніме вікно й відкриє BTCUSDT в активній панелі.

XML
<a class="open-in-lootx"
   href="lootx://open/instrument?t=BINANCE:BTCUSDT.P&amp;src=myscreener">
  Відкрити в LootX
</a>
TSX
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>;
}
JavaScript
// Одна функція на всі команди: значення кодуються, 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

Спробуйте прямо звідси:

Відкрити BTCUSDT в LootX

Спрацює, якщо на цьому комп’ютері встановлено 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 символів.
  • Показуйте запасний варіант. Надійно дізнатися з браузера, чи встановлено термінал, не можна. Відкрийте посилання одразу, а через кілька секунд ненав’язливо запропонуйте допомогу.
JavaScript
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

Интеграции

3Варіанти відкриття та групи зв'язку

Усі способи відкрити монету посиланням lootx://: вибрана панель, група зв'язку, нова панель, вкладка або вікно, всі майданчики, рівень разом із монетою — з готовими посиланнями та порівнянням.

Одна й та сама монета може відкритися в терміналі по‑різному: у панелі, на яку користувач дивиться прямо зараз, у всій її зв’язці панелей, у новій вкладці або вікні, одразу на всіх майданчиках. Тут зібрані всі варіанти — з готовим посиланням, описом того, що станеться в терміналі, і підказкою, коли який обрати.

Основи і приклад кнопки — в Кнопка «Открыть в LootX", повний список параметрів — в довіднику посилань lootx://.

З чого складається варіант

Монета в ссылке задаётся почти всегда одинаково — t=БИРЖА:СИМВОЛ, с .P для бессрочного фьючерса. Вариант открытия определяют три других параметра:

Питання Параметр Значення
Куди відкрити target вибрана панель · тільки група зв’язку · нова вкладка · нове вікно
З якою групою зв’язати link 1–100 — група, active — «К активному окну», 0 — без групи
Яку панель створити, якщо створюється нова layout біржовий стакан, графік, стрічка угод, карта ліквідності, зв’язки, усі біржі

Без цих параметрів посилання працює як варіант за замовчуванням — змінює монету в вибраній панелі.

Оберіть варіант

У панелі, на яку дивиться користувач

TEXT
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapp
  • Монета відкривається в вибраній панелі — тій, з якою користувач працював останньою.
  • Разом із нею переключаються її група зв’язку і панелі в режимі «К активному окну» — так само, як якби користувач обрав монету в списку терміналу.
  • Якщо вибрана панель без монети, наприклад «Позиции», монета відкриється в першій підходящій панелі на цій вкладці. Підходящих немає — на вкладці з’явиться новий біржовий стакан.

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

У вибраній панелі і в групі зв’язку

TEXT
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&src=myapp
  • Монету отримує вибрана панель — як у варіанті за замовчуванням.
  • Одночасно її отримують усі панелі групи 3 у всіх вікнах терміналу, включно з фоновими вкладками.
  • Вибрана панель при цьому до групи 3 не приєднується: її власна зв’язка не змінюється.

Підходить, коли у користувача є окрема зв’язка «для вашого сервісу» і вона має слідувати за кожним кліком, а поточну панель теж потрібно переключити.

Тільки в групі зв’язку

TEXT
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&target=group&src=myapp
  • Монету отримують тільки панелі групи 3 у всіх вікнах.
  • Вибрана панель не змінюється: користувач може торгувати однією монетою й паралельно переглядати ваші сигнали в іншій зв’язці.
  • Якщо в групі немає жодної панелі, термінал покаже повідомлення «В группе 3 нет панелей (запрос от «myapp»)».

Щоб замість повідомлення термінал сам підготував місце, додайте ifEmpty=create:

TEXT
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&target=group&ifEmpty=create&src=myapp

Якщо група пуста, на активній вкладці з’явиться нова панель — біржовий стакан або той тип, що вказано в layout, — і одразу вступить у групу 3. Наступні посилання прийдуть вже в неї.

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

Нова панель поруч із поточними

TEXT
lootx://open/panel?layout=chart&t=BINANCE:BTCUSDT.P&src=myapp

open/panel завжди створює нову панель — навіть якщо така вже відкрита — і додає її на активну вкладку. Відкриті панелі не змінюються. Тип панелі задає layout:

layout Панель
orderbook Біржовий стакан — за замовчуванням
chart Графік
tape Стрічка угод
liqmap Карта ліквідності
combo1 … combo4 Зв’язка графіка і стаканів — варіанти в довіднику

З link=5 нова панель одразу вступає в групу 5, і решта панелей групи переключаються разом з нею.

У новій вкладці

TEXT
lootx://open/panel?layout=combo1&t=BINANCE:BTCUSDT.P&target=tab&link=5&src=myapp

Термінал відкриває нову вкладку — або бере порожню, якщо вона вже є, — називає її за монетою і створює в ній панель layout. Без link панель не належить жодній групі.

У новому вікні

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

Нове вікно з панеллю layout одразу виходить на передній план. З версії 0.6.53 воно відкривається так само, як поточне: якщо вікно терміналу розгорнуте, нове теж буде розгорнутим. Зручно для другого монітора.

Монета на всіх майданчиках

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

Термінал розкладає монету колонками по всіх майданчиках — так, як це налаштовано у користувача в розділі «Усі біржі»: набір і порядок майданчиків, спот і ф’ючерси, положення графіка.

  • Кожна колонка отримує свою групу зв’язку автоматично, тому колонки не заважають одна одній і іншим панелям.
  • Без target розкладка відкривається там, де вибрано в налаштуваннях користувача. target=tab — завжди нова вкладка, target=window — завжди нове вікно.
  • Майданчик тут не важливий, потрібен лише символ: навіть t=HTX:BTCUSDT розкладе BTCUSDT по майданчиках LootX.
TEXT
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myapp

Підходить для арбітражних і аналітичних сервісів: користувач одразу порівнює стакани однієї монети на різних майданчиках.

Відкрити й одразу відзначити рівень

TEXT
lootx://open/instrument?t=BINANCE:BTCUSDT.P&level=64821.5&link=3&target=group&src=myapp

Параметр level додається до будь‑якого варіанту відкриття: термінал спочатку відкриває монету так, як задають target і link, потім ставить горизонтальний рівень за ціною 64821.5. Рівень позначається вашим src, і пізніше його можна зняти командою level/clear, не зачепивши розмітку користувача. Деталі — в Уровни от вашего сервиса.

Переключити групу, нічого не відкриваючи

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

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

link/clear?g=3 скидає монету, запам’ятовану за групою, — відкриті панелі при цьому не змінюються.

Просто підняти термінал

TEXT
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
JavaScript
// Группа, которую пользователь выбрал в ваших настройках (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 — список у довіднику.

Рецепти

Користувач вибирає групу в налаштуваннях скринера. Клік по рядку відкриває монету в цій групі і відзначає ціну щільності:

TEXT
lootx://open/instrument?t=BINANCE:SOLUSDT.P&link=3&target=group&ifEmpty=create&level=182.45&src=densityscreener

Коли щільність з’їли, скринер знімає свою позначку — користувацька розмітка лишається:

TEXT
lootx://level/clear?t=BINANCE:SOLUSDT.P&price=182.45&src=densityscreener

Кожен сигнал відкриває монету поруч із поточною роботою користувача — в окремому вікні з графіком, яке зручно тримати на другому моніторі:

TEXT
lootx://open/panel?layout=combo1&t=BYBIT:ETHUSDT.P&target=window&src=signalbot

Для частих сигналів краще відправляти монету в одну групу, а не відкривати вікно на кожен сигнал:

TEXT
lootx://open/instrument?t=BYBIT:ETHUSDT.P&link=5&target=group&ifEmpty=create&src=signalbot

Порівняти монету на всіх майданчиках користувача — у новій вкладці:

TEXT
lootx://open/all-exchanges?s=ETHUSDT&target=tab&src=arbitrage

Відкрити два ринки однієї монети — спот і ф’ючерс — в різних групах:

TEXT
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