Ссылки lootx://
Справочник схемы lootx://: команды, параметры, форматы инструмента, биржи, группы связи, сообщения терминала и ограничения.
Полный справочник схемы lootx://: команды, параметры, адресация инструмента и сообщения терминала. Пошаговое руководство с примерами кнопки — в разделе Кнопка «Открыть в LootX».
Формат
lootx://<команда>?<параметр>=<значение>&<параметр>=<значение>| Правило | Значение |
|---|---|
| Команда | Из закрытого списка ниже. Неизвестная команда поднимает окно терминала и показывает сообщение. |
| Символы в значениях | Латиница, цифры, _ . : -. Значение не может начинаться с - или /. |
| Кодирование | Значения можно передавать в percent-encoding (BYBIT%3ASOLUSDT.P): терминал декодирует их один раз, затем проверяет. |
| Длина | Ссылка — до 1500 символов, символ инструмента и src — до 32. |
| Порядок параметров | Любой. Если параметр повторяется, действует первое вхождение. |
| Неизвестные параметры | Пропускаются без ошибки. |
Недопустимое значение терминал отбрасывает, как если бы параметр не передали. Поэтому ошибка в символе обычно превращается в сообщение «пришла без инструмента».
Команды
lootx://open/instrumentОткрывает инструмент в уже открытой панели: в выбранной, а если она не показывает монету (например, «Позиции») — в первой подходящей на активной вкладке. Подходящей панели нет — создаёт новую. Куда именно открывать, задаёт target.
Нужен инструмент — t, id или v + s. Можно добавить target, link, layout, level, src. С level терминал заодно ставит уровень цены, а с layout=all-exchanges открывает монету на всех биржах.
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapplootx://open/panelВсегда создаёт новую панель типа layout и открывает в ней инструмент — даже если такая панель уже есть.
Нужен инструмент. Можно добавить layout (по умолчанию — стакан), target, link, level, src.
lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myapplootx://open/all-exchangesРаскладывает монету по всем биржам из настройки пользователя «Все биржи».
Нужен символ: s=SOLUSDT или инструмент в t / id, из которого возьмётся символ. Биржа здесь не важна — даже t=HTX:BTCUSDT разложит BTCUSDT по биржам LootX. target=window открывает раскладку в новом окне, target=tab — в новой вкладке. Без target — как настроено у пользователя.
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myapplootx://open/terminalПоднимает окно терминала — и больше ничего не делает.
lootx://open/terminallootx://link/setНазначает инструмент группе связи g: все панели группы во всех окнах переключаются на него. Новых панелей не открывает — если в группе пока пусто, команда всё равно выполняется.
Нужны g и инструмент.
lootx://link/set?g=3&t=BINANCE:BTCUSDT.P&src=myapplootx://link/clearСбрасывает инструмент, закреплённый за группой связи g.
Нужен g.
lootx://link/clear?g=3&src=myapplootx://level/setСтавит горизонтальный уровень цены. С инструментом терминал сначала переключается на него, без инструмента — ставит уровень на монету, которая открыта сейчас. Уровень появляется в стакане, а через зеркало уровней — и на графике.
Нужна price. Можно добавить инструмент, link, src.
lootx://level/set?t=BINANCE:BTCUSDT.P&price=64821.5&src=myapplootx://level/clearСнимает уровни, которые поставил сервис с тем же src (0.6.53+). С price — уровень в строке этой цены, без неё — все ваши уровни на монете, во всех окнах. Работает и тогда, когда стакан монеты закрыт, и не переключает инструмент. Уровни, нарисованные пользователем или поставленные другими сервисами, остаются.
Можно добавить инструмент, price, link, src. Без инструмента монета берётся из выбранной панели или из группы link.
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, остальные пропускаются.
t=BINANCE:BTCUSDT.P бессрочный фьючерс
t=BINANCE:BTCUSDT спотСамая удобная форма для скринеров: берите тот же код, что в ссылке на график TradingView.
v=bybit&m=perp&s=SOLUSDT
v=binance&s=ETHUSDT без m — спот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 команд. При переполнении первыми уходят самые старые. |
| Повторы | Новая команда в ту же цель заменяет ещё не выполненную. Команды уровней не заменяются и выполняются по порядку. |
| Торговля | Недоступна: ссылкой нельзя выставить, изменить или отменить ордер. |
| Ответ | Отсутствует: канал односторонний, терминал ничего не сообщает сайту. |