← К документации
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/ru/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/ru/api/open-variants