Кнопка «Открыть в 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/ru/api/open-in-lootx