Варианты открытия и группы связи
Все способы открыть монету ссылкой lootx://: выбранная панель, группа связи, новая панель, вкладка или окно, все биржи, уровень вместе с монетой — с готовыми ссылками и сравнением.
Одна и та же монета может открыться в терминале по-разному: в панели, на которую пользователь смотрит прямо сейчас, во всей его связке панелей, в новой вкладке или окне, сразу на всех биржах. Здесь собраны все варианты — с готовой ссылкой, описанием того, что произойдёт в терминале, и подсказкой, когда какой выбирать.
Основы и пример кнопки — в Кнопка «Открыть в LootX», полный список параметров — в справочнике ссылок lootx://.
Из чего складывается вариант
Монета в ссылке задаётся почти всегда одинаково — t=БИРЖА:СИМВОЛ, с .P для бессрочного фьючерса. Вариант открытия определяют три других параметра:
| Вопрос | Параметр | Значения |
|---|---|---|
| Куда открыть | target |
выбранная панель · только группа связи · новая вкладка · новое окно |
| С какой группой связать | link |
1–100 — группа, active — «К активному окну», 0 — без группы |
| Какую панель создать, если создаётся новая | layout |
стакан, график, лента, карта ликвидности, связки, все биржи |
Без этих параметров ссылка работает как вариант по умолчанию — меняет монету в выбранной панели.
Выберите вариант
Вариант по умолчанию: пользователь кликнул — и видит монету там, куда смотрит.
В выбранной панели и в группеМонета приходит и в текущую панель, и во всю связку пользователя.
Только в группеСвязка переключается, а то, с чем пользователь работает сейчас, остаётся на месте.
Новая панель, вкладка или окноДобавить график или стакан, не трогая открытые панели.
На всех биржахОдна монета — колонки по всем биржам пользователя.
Уровень вместе с монетойОткрыть монету и положить на неё линию цены одной ссылкой.
В панели, на которую смотрит пользователь
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapp- Монета открывается в выбранной панели — той, с которой пользователь работал последней.
- Вместе с ней переключаются её группа связи и панели в режиме «К активному окну» — так же, как если бы пользователь выбрал монету в списке терминала.
- Если выбрана панель без монеты, например «Позиции», монета откроется в первой подходящей панели на этой вкладке. Подходящих нет — на вкладке появится новый стакан.
Подходит, когда пользователь кликает в вашем сервисе и сразу переводит взгляд на терминал: скринер, таблица сигналов, лента новостей.
В выбранной панели и в группе связи
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&src=myapp- Монету получает выбранная панель — как в варианте по умолчанию.
- Одновременно её получают все панели группы 3 во всех окнах терминала, включая фоновые вкладки.
- Выбранная панель при этом в группу 3 не вступает: её собственная связка не меняется.
Подходит, когда у пользователя есть отдельная связка «для вашего сервиса» и она должна следовать за каждым кликом, а текущую панель тоже нужно переключить.
Только в группе связи
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&target=group&src=myapp- Монету получают только панели группы 3 во всех окнах.
- Выбранная панель не меняется: пользователь может торговать одной монетой и параллельно просматривать ваши сигналы в другой связке.
- Если в группе нет ни одной панели, терминал покажет сообщение «В группе 3 нет панелей (запрос от «myapp»)».
Чтобы вместо сообщения терминал сам подготовил место, добавьте ifEmpty=create:
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&target=group&ifEmpty=create&src=myappЕсли группа пуста, на активной вкладке появится новая панель — стакан или тот тип, что указан в layout, — и сразу вступит в группу 3. Следующие ссылки придут уже в неё.
Подходит большинству скринеров. Это самый аккуратный вариант: ваш сервис управляет своей связкой панелей и не вмешивается в остальную работу пользователя. Как дать пользователю выбрать группу — в разделе Группа связи в вашем сервисе.
Новая панель рядом с текущими
lootx://open/panel?layout=chart&t=BINANCE:BTCUSDT.P&src=myappopen/panel всегда создаёт новую панель — даже если такая уже открыта — и добавляет её на активную вкладку. Открытые панели не меняются. Тип панели задаёт layout:
layout |
Панель |
|---|---|
orderbook |
Стакан — по умолчанию |
chart |
График |
tape |
Лента сделок |
liqmap |
Карта ликвидности |
combo1 … combo4 |
Связка графика и стаканов — варианты в справочнике |
С link=5 новая панель сразу вступает в группу 5, и остальные панели группы переключаются вместе с ней.
В новой вкладке
lootx://open/panel?layout=combo1&t=BINANCE:BTCUSDT.P&target=tab&link=5&src=myappТерминал открывает новую вкладку — или берёт пустую, если она уже есть, — называет её по монете и создаёт в ней панель layout. Без link панель не состоит ни в какой группе.
В новом окне
lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myappНовое окно с панелью layout сразу выходит на передний план. С версии 0.6.53 оно открывается так же, как текущее: если окно терминала развёрнуто, новое тоже будет развёрнутым. Удобно для второго монитора.
Монета на всех биржах
lootx://open/all-exchanges?s=SOLUSDT&src=myappТерминал раскладывает монету колонками по всем биржам — так, как это настроено у пользователя в разделе «Все биржи»: набор и порядок бирж, спот и фьючерсы, положение графика.
- Каждая колонка получает свою группу связи автоматически, поэтому колонки не мешают друг другу и остальным панелям.
- Без
targetраскладка открывается там, где выбрано в настройках пользователя.target=tab— всегда новая вкладка,target=window— всегда новое окно. - Биржа здесь не важна, нужен только символ: даже
t=HTX:BTCUSDTразложит BTCUSDT по биржам LootX.
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myappПодходит для арбитражных и аналитических сервисов: пользователь сразу сравнивает стаканы одной монеты на разных площадках.
Открыть и сразу отметить уровень
lootx://open/instrument?t=BINANCE:BTCUSDT.P&level=64821.5&link=3&target=group&src=myappПараметр level добавляется к любому варианту открытия: терминал сначала открывает монету так, как задают target и link, затем ставит горизонтальный уровень на цене 64821.5. Уровень помечается вашим src, и позже его можно снять командой level/clear, не задев разметку пользователя. Подробнее — в Уровни от вашего сервиса.
Переключить группу, ничего не открывая
lootx://link/set?g=3&t=BINANCE:BTCUSDT.P&src=myappВсе панели группы 3 во всех окнах переключаются на монету. Новых панелей команда не создаёт, окна не открывает и сообщений не показывает — даже если в группе пусто.
link/clear?g=3 сбрасывает монету, запомненную за группой, — открытые панели при этом не меняются.
Просто поднять терминал
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 |
// Группа, которую пользователь выбрал в ваших настройках (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 — список в справочнике. |
Рецепты
Пользователь выбирает группу в настройках скринера. Клик по строке открывает монету в этой группе и отмечает цену плотности:
lootx://open/instrument?t=BINANCE:SOLUSDT.P&link=3&target=group&ifEmpty=create&level=182.45&src=densityscreenerКогда плотность съели, скринер снимает свою отметку — пользовательская разметка остаётся:
lootx://level/clear?t=BINANCE:SOLUSDT.P&price=182.45&src=densityscreenerКаждый сигнал открывает монету рядом с текущей работой пользователя — в отдельном окне с графиком, которое удобно держать на втором мониторе:
lootx://open/panel?layout=combo1&t=BYBIT:ETHUSDT.P&target=window&src=signalbotДля частых сигналов лучше отправлять монету в одну группу, а не открывать окно на каждый сигнал:
lootx://open/instrument?t=BYBIT:ETHUSDT.P&link=5&target=group&ifEmpty=create&src=signalbotСравнить монету на всех биржах пользователя — в новой вкладке:
lootx://open/all-exchanges?s=ETHUSDT&target=tab&src=arbitrageОткрыть два рынка одной монеты — спот и фьючерс — в разных группах:
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Одна ссылка выполняет одну команду: две ссылки — это два клика или два перехода подряд из одного обработчика клика.