lootx:// Links
1lootx:// Links
Reference for the lootx:// scheme: commands, parameters, instrument formats, exchanges, link groups, terminal messages, and limits.
Complete reference for the lootx:// scheme: commands, parameters, instrument addressing, and terminal messages. A step-by-step guide with button examples is in “Open in LootX” button.
Format
lootx://<command>?<parameter>=<value>&<parameter>=<value>| Rule | Value |
|---|---|
| Command | From the closed list below. An unknown command raises the terminal window and shows a message. |
| Characters in values | Latin letters, digits, _ . : -. A value cannot start with - or /. |
| Encoding | Values can be percent-encoded (BYBIT%3ASOLUSDT.P): the terminal decodes them once, then validates. |
| Length | Link — up to 1500 characters; instrument symbol and src — up to 32. |
| Parameter order | Any. If a parameter repeats, the first occurrence wins. |
| Unknown parameters | Skipped without error. |
An invalid value is discarded by the terminal as if the parameter had not been passed. Therefore a typo usually turns into the message “arrived without an instrument”.
Commands
lootx://open/instrumentOpens the instrument in an already open panel: in the selected one, or if it does not show the coin (for example, “Positions”), in the first suitable panel on the active tab. If no suitable panel exists, it creates a new one. Where exactly to open it is set by target.
Required instrument — t, id, or v + s. Optional target, link, layout, level, src. With level the terminal also places a price level, and with layout=all-exchanges it opens the coin on all exchanges.
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapplootx://open/panelAlways creates a new panel of type layout and opens the instrument in it — even if such a panel already exists.
Required instrument. Optional layout (default — order book), target, link, level, src.
lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myapplootx://open/all-exchangesSpreads the coin across all exchanges from the user’s “All exchanges” setting.
Required symbol: s=SOLUSDT or an instrument in t / id, from which the symbol is taken. The exchange does not matter here — even t=HTX:BTCUSDT will spread BTCUSDT across LootX exchanges. target=window opens the spread in a new window, target=tab in a new tab. Without target — as configured by the user.
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myapplootx://open/terminalRaises the terminal window — and does nothing else.
lootx://open/terminallootx://link/setAssigns an instrument to link group g: all panels in the group in all windows switch to it. It does not open new panels — if the group is empty, the command still executes.
Required g and an instrument.
lootx://link/set?g=3&t=BINANCE:BTCUSDT.P&src=myapplootx://link/clearResets the instrument assigned to link group g.
Required g.
lootx://link/clear?g=3&src=myapplootx://level/setPlaces a horizontal price level. With an instrument, the terminal first switches to it; without an instrument, it places the level on the coin currently open. The level appears in the order book, and via the level mirror also on the chart.
Required price. Optional instrument, link, src.
lootx://level/set?t=BINANCE:BTCUSDT.P&price=64821.5&src=myapplootx://level/clearRemoves levels placed by the service with the same src (0.6.53+). With price — the level at that price row, without it — all your levels on the coin, in all windows. Works even when the coin’s order book is closed, and does not switch the instrument. Levels drawn by the user or placed by other services remain.
Optional instrument, price, link, src. Without an instrument, the coin is taken from the selected panel or from group link.
lootx://level/clear?t=BINANCE:BTCUSDT.P&src=myappParameters
| Parameter | Values | Default | Purpose |
|---|---|---|---|
t |
EXCHANGE:SYMBOL or EXCHANGE:SYMBOL.P |
— | Instrument in TradingView format |
v |
exchange code | — | Exchange — together with s and m |
m |
spot, perp |
spot |
Market; futures and swap are read as perp |
s |
exchange symbol, up to 32 characters | — | For example, BTCUSDT |
id |
exchange_market_base_quote[_xMULTIPLIER] |
— | Canonical instrument identifier |
target |
current, group, tab, window, pane |
current |
Where to open |
layout |
see table below | orderbook |
Which panel to create |
link |
0–100, active |
— | Link group for the opened panel; 0 — no group |
g |
1–100 |
— | Group for link/set and link/clear |
ifEmpty |
create |
— | Create a panel if the group is empty when target=group. Without the parameter — do not create |
pane |
panel identifier | — | Destination for target=pane |
price, level |
positive number with a decimal point: 64821.5 |
— | Level price. Commas and exponents (1e5) are not accepted. level on open/* places a level together with opening |
src |
service name, up to 32 characters | unknown |
Who sent the command: shown in messages and tags levels |
Always pass src: without it the user will see unknown in messages, and levels from different services cannot be removed separately.
How to specify an instrument
Three forms. If a link contains several, the first in the order id → t → v + m + s wins; the rest are skipped.
t=BINANCE:BTCUSDT.P perpetual futures
t=BINANCE:BTCUSDT spotThe most convenient form for screeners: use the same code as in a TradingView chart link.
v=bybit&m=perp&s=SOLUSDT
v=binance&s=ETHUSDT without m — spotid=binance_perp_btc_usdt
id=binance_perp_pepe_usdt_x1000Format exchange_market_base_quote, suffix _xN — for contracts with a multiplier.
The terminal looks for the symbol in the exchange’s instrument list: case and separators do not matter (btcusdt, BTC-USDT), and PEPEUSDT will find the futures contract 1000PEPEUSDT. If the exchange does not have the requested market — for example, futures on Upbit — the available one opens.
Exchanges
| Exchange | Code | Also accepted | Markets |
|---|---|---|---|
| Binance | BINANCE |
— | spot, futures |
| Bybit | BYBIT |
— | spot, futures |
| OKX | OKX |
OKEX ¹ |
spot, futures |
| Bitget | BITGET |
— | spot, futures |
| Gate | GATE |
GATEIO ¹ |
spot, futures |
| MEXC | MEXC |
— | spot, futures |
| KuCoin | KUCOIN |
— | spot, futures |
| BingX | BINGX |
— | spot, futures |
| Hyperliquid | HYPERLIQUID |
HL ¹ |
spot, futures |
| Aster | ASTER |
ASTERDEX ¹ |
spot, futures |
| Binance Alpha | BINANCEALPHA |
ALPHA ¹ |
spot |
| Upbit | UPBIT |
— | spot |
¹ Since version 0.6.53.
The code works identically in t and v, case does not matter: binance and BINANCE are equivalent. Exchanges not available in LootX (for example, HTX, BitMart, Coinbase) are named by the terminal in the message: “Exchange “HTX” is not supported in LootX” (0.6.53+).
Where to open
| Value | What happens |
|---|---|
current |
The selected panel. Together with link, the instrument also goes to the whole group. |
group |
Only panels of group link in all windows; the selected panel does not change. If the group is empty — a message or a new panel with ifEmpty=create. |
tab |
A new tab. |
window |
A new window. Since 0.6.53 it opens as the current one: for a maximized terminal — maximized. |
pane |
A specific panel by pane=<id> in any window, including detached ones. |
What to create
| Value | Panel |
|---|---|
orderbook |
Order book |
chart |
Chart |
tape |
Time and sales |
liqmap |
Liquidity map |
combo1 |
Combo: chart on top, order book below |
combo2 |
Combo: order book on top, chart below |
combo3 |
Combo: chart on top, two order books below |
combo4 |
Combo: two order books on top, chart below |
all-exchanges |
Coin on all exchanges |
Link groups
Terminal panels are combined into link groups: changing the coin in one panel switches the whole group — in all windows, including background tabs. In the interface, groups are distinguished by color; in a link, only by number.
| Value | Meaning |
|---|---|
1–100 |
Group with this number |
active |
“To active window” mode: the panel shows the same coin as the selected panel (only in link) |
0 |
No group: a new panel does not follow anything (only in link) |
Terminal messages
A successful command runs silently. If it cannot be executed, the terminal raises the window and shows a message with the name from src:
| Situation | Message |
|---|---|
| Unknown command | Unknown command from “myapp” |
| No instrument | Command from “myapp” arrived without an instrument |
| Instrument not found | BTCUSDX — not found (request from “myapp”) |
| Exchange not supported ¹ | Exchange “HTX” is not supported in LootX (request from “myapp”) |
| Exchange not specified ¹ | Command from “myapp” did not specify an exchange |
| No panels in group | No panels in group 3 (request from “myapp”) |
| Panel not found | Panel not found (request from “myapp”) |
| No level price | Command from “myapp” arrived without a level price |
| Other failure | Could not execute command from “myapp” |
¹ Since version 0.6.53.
Limits
| What | Value |
|---|---|
| Rate | Up to 10 commands per second; excess is dropped without a message. |
| Queue | Up to 32 commands. On overflow, the oldest are dropped first. |
| Duplicates | A new command to the same target replaces a not-yet-executed one. Level commands are not replaced and run in order. |
| Trading | Unavailable: a link cannot place, modify, or cancel an order. |
| Response | None: the channel is one-way; the terminal does not report back to the site. |
https://docs.lootx.trade/en/api/deep-links