Ссылки lootx://

Полный справочник схемы lootx://: команды, параметры, адресация инструмента и сообщения терминала. Пошаговое руководство с примерами кнопки — в разделе Кнопка «Открыть в LootX».

Формат

TEXT

lootx://<команда>?<параметр>=<значение>&<параметр>=<значение>

Правило	Значение
Команда	Из закрытого списка ниже. Неизвестная команда поднимает окно терминала и показывает сообщение.
Символы в значениях	Латиница, цифры, `_ . : -`. Значение не может начинаться с `-` или `/`.
Кодирование	Значения можно передавать в percent-encoding (`BYBIT%3ASOLUSDT.P`): терминал декодирует их один раз, затем проверяет.
Длина	Ссылка — до 1500 символов, символ инструмента и `src` — до 32.
Порядок параметров	Любой. Если параметр повторяется, действует первое вхождение.
Неизвестные параметры	Пропускаются без ошибки.

Недопустимое значение терминал отбрасывает, как если бы параметр не передали. Поэтому ошибка в символе обычно превращается в сообщение «пришла без инструмента».

Команды

LINKlootx://open/instrument

Открывает инструмент в уже открытой панели: в выбранной, а если она не показывает монету (например, «Позиции») — в первой подходящей на активной вкладке. Подходящей панели нет — создаёт новую. Куда именно открывать, задаёт target.

Нужен инструмент — t, id или v + s. Можно добавить target, link, layout, level, src. С level терминал заодно ставит уровень цены, а с layout=all-exchanges открывает монету на всех биржах.

TEXT

lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapp

LINKlootx://open/panel

Всегда создаёт новую панель типа layout и открывает в ней инструмент — даже если такая панель уже есть.

Нужен инструмент. Можно добавить layout (по умолчанию — стакан), target, link, level, src.

TEXT

lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myapp

LINKlootx://open/all-exchanges

Раскладывает монету по всем биржам из настройки пользователя «Все биржи».

Нужен символ: s=SOLUSDT или инструмент в t / id, из которого возьмётся символ. Биржа здесь не важна — даже t=HTX:BTCUSDT разложит BTCUSDT по биржам LootX. target=window открывает раскладку в новом окне, target=tab — в новой вкладке. Без target — как настроено у пользователя.

TEXT

lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myapp

LINKlootx://open/terminal

Поднимает окно терминала — и больше ничего не делает.

TEXT

lootx://open/terminal

LINKlootx://link/set

Назначает инструмент группе связи g: все панели группы во всех окнах переключаются на него. Новых панелей не открывает — если в группе пока пусто, команда всё равно выполняется.

Нужны g и инструмент.

TEXT

lootx://link/set?g=3&t=BINANCE:BTCUSDT.P&src=myapp

LINKlootx://link/clear

Сбрасывает инструмент, закреплённый за группой связи g.

Нужен g.

TEXT

lootx://link/clear?g=3&src=myapp

LINKlootx://level/set

Ставит горизонтальный уровень цены. С инструментом терминал сначала переключается на него, без инструмента — ставит уровень на монету, которая открыта сейчас. Уровень появляется в стакане, а через зеркало уровней — и на графике.

Нужна price. Можно добавить инструмент, link, src.

TEXT

lootx://level/set?t=BINANCE:BTCUSDT.P&price=64821.5&src=myapp

LINKlootx://level/clear

Снимает уровни, которые поставил сервис с тем же src (0.6.53+). С price — уровень в строке этой цены, без неё — все ваши уровни на монете, во всех окнах. Работает и тогда, когда стакан монеты закрыт, и не переключает инструмент. Уровни, нарисованные пользователем или поставленные другими сервисами, остаются.

Можно добавить инструмент, price, link, src. Без инструмента монета берётся из выбранной панели или из группы link.

TEXT

lootx://level/clear?t=BINANCE:BTCUSDT.P&src=myapp

Параметры

Параметр	Значения	По умолчанию	Назначение
`t`	`БИРЖА:СИМВОЛ` или `БИРЖА:СИМВОЛ.P`	—	Инструмент в формате TradingView
`v`	код биржи	—	Биржа — вместе с `s` и `m`
`m`	`spot`, `perp`	`spot`	Рынок; `futures` и `swap` читаются как `perp`
`s`	символ биржи, до 32 знаков	—	Например, `BTCUSDT`
`id`	`биржа_рынок_база_котировка[_xМНОЖИТЕЛЬ]`	—	Канонический идентификатор инструмента
`target`	`current`, `group`, `tab`, `window`, `pane`	`current`	Куда открывать
`layout`	см. таблицу ниже	`orderbook`	Какую панель создать
`link`	`0`–`100`, `active`	—	Группа связи для открываемого; `0` — без группы
`g`	`1`–`100`	—	Группа для `link/set` и `link/clear`
`ifEmpty`	`create`	—	Создать панель, если при `target=group` в группе пусто. Без параметра — не создавать
`pane`	идентификатор панели	—	Адресат при `target=pane`
`price`, `level`	положительное число с точкой: `64821.5`	—	Цена уровня. Запятая и экспонента (`1e5`) не принимаются. `level` у `open/*` ставит уровень заодно с открытием
`src`	имя сервиса, до 32 знаков	`unknown`	Кто отправил команду: показывается в сообщениях и помечает уровни

Передавайте src всегда: без него пользователь увидит в сообщении unknown, а уровни от разных сервисов нельзя будет снять по отдельности.

Как указать инструмент

Три формы. Если в ссылке их несколько, действует первая по порядку id → t → v + m + s, остальные пропускаются.

TEXT

t=BINANCE:BTCUSDT.P    бессрочный фьючерс
t=BINANCE:BTCUSDT      спот

Самая удобная форма для скринеров: берите тот же код, что в ссылке на график TradingView.

TEXT

v=bybit&m=perp&s=SOLUSDT
v=binance&s=ETHUSDT          без m — спот

TEXT

id=binance_perp_btc_usdt
id=binance_perp_pepe_usdt_x1000

Формат биржа_рынок_база_котировка, суффикс _xN — для контрактов с множителем.

Символ терминал ищет в списке инструментов биржи: регистр и разделители не важны (btcusdt, BTC-USDT), а PEPEUSDT найдёт фьючерс 1000PEPEUSDT. Если на бирже нет запрошенного рынка — например, фьючерсов на Upbit, — откроется тот, что есть.

Биржи

Биржа	Код	Также принимается	Рынки
Binance	`BINANCE`	—	спот, фьючерсы
Bybit	`BYBIT`	—	спот, фьючерсы
OKX	`OKX`	`OKEX` ¹	спот, фьючерсы
Bitget	`BITGET`	—	спот, фьючерсы
Gate	`GATE`	`GATEIO` ¹	спот, фьючерсы
MEXC	`MEXC`	—	спот, фьючерсы
KuCoin	`KUCOIN`	—	спот, фьючерсы
BingX	`BINGX`	—	спот, фьючерсы
Hyperliquid	`HYPERLIQUID`	`HL` ¹	спот, фьючерсы
Aster	`ASTER`	`ASTERDEX` ¹	спот, фьючерсы
Binance Alpha	`BINANCEALPHA`	`ALPHA` ¹	спот
Upbit	`UPBIT`	—	спот

¹ С версии 0.6.53.

Код одинаково работает в t и v, регистр не важен: binance и BINANCE равнозначны. Биржи, которых нет в LootX (например, HTX, BitMart, Coinbase), терминал называет в сообщении: «Биржа «HTX» в LootX не поддерживается» (0.6.53+).

Куда открывать

Значение	Что происходит
`current`	Выбранная панель. Вместе с `link` инструмент получает и вся группа.
`group`	Только панели группы `link` во всех окнах, выбранная не меняется. Если в группе пусто — сообщение или новая панель при `ifEmpty=create`.
`tab`	Новая вкладка.
`window`	Новое окно. С 0.6.53 оно открывается как текущее: у развёрнутого терминала — развёрнутым.
`pane`	Конкретная панель по `pane=<id>` в любом окне, включая откреплённые.

Что создать

Значение	Панель
`orderbook`	Стакан
`chart`	График
`tape`	Лента сделок
`liqmap`	Карта ликвидности
`combo1`	Связка: график сверху, стакан снизу
`combo2`	Связка: стакан сверху, график снизу
`combo3`	Связка: график сверху, два стакана снизу
`combo4`	Связка: два стакана сверху, график снизу
`all-exchanges`	Монета на всех биржах

Группы связи

Панели терминала объединяются в группы связи: смена монеты в одной панели переключает всю группу — во всех окнах, включая фоновые вкладки. В интерфейсе группы различаются цветом, в ссылке — только номером.

Значение	Что означает
`1`–`100`	Группа с этим номером
`active`	Режим «К активному окну»: панель показывает ту же монету, что выбранная панель (только в `link`)
`0`	Без группы: новая панель ни за чем не следует (только в `link`)

Сообщения терминала

Успешная команда выполняется молча. Если выполнить её не удалось, терминал поднимает окно и показывает сообщение с именем из src:

Ситуация	Сообщение
Неизвестная команда	Неизвестная команда от «myapp»
Нет инструмента	Команда от «myapp» пришла без инструмента
Инструмент не найден	BTCUSDX — не найден (запрос от «myapp»)
Биржа не поддерживается ¹	Биржа «HTX» в LootX не поддерживается (запрос от «myapp»)
Биржа не указана ¹	Команда от «myapp» не указала биржу
В группе нет панелей	В группе 3 нет панелей (запрос от «myapp»)
Панель не найдена	Панель не найдена (запрос от «myapp»)
Нет цены уровня	Команда от «myapp» пришла без цены уровня
Прочий сбой	Не удалось выполнить команду от «myapp»

¹ С версии 0.6.53.

Ограничения

Что	Значение
Частота	До 10 команд в секунду, лишние отбрасываются без сообщения.
Очередь	До 32 команд. При переполнении первыми уходят самые старые.
Повторы	Новая команда в ту же цель заменяет ещё не выполненную. Команды уровней не заменяются и выполняются по порядку.
Торговля	Недоступна: ссылкой нельзя выставить, изменить или отменить ордер.
Ответ	Отсутствует: канал односторонний, терминал ничего не сообщает сайту.