Кнопка «Відкрити в 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