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

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

Зібрано: 2026-09-29 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