Opening options and linking groups
All ways to open a coin with lootx://: selected panel, linking group, new panel, tab or window, all-exchanges, level with the coin — ready links and a comparison.
The same coin can open in the terminal in different ways: in the panel the user is looking at now, across their whole linking group, in a new tab or window, or immediately on all exchanges. This page lists every option — with ready links, an explanation of what will happen in the terminal, and a hint when to use each.
Basics and a sample button are in Button “Open in LootX”, the full list of parameters is in the lootx:// deep-links reference.
What composes an opening variant
The coin in the link is almost always specified the same way — t=EXCHANGE:SYMBOL, with .P for a perpetual futures contract. Three other parameters define the opening variant:
| Question | Parameter | Values |
|---|---|---|
| Where to open | target |
selected panel · only linking group · new tab · new window |
| Which group to link to | link |
1–100 — group, active — “To active window”, 0 — no group |
| Which panel to create if a new one is made | layout |
order book, chart, time and sales, liquidity map, combos, all-exchanges |
Without these parameters the link acts as the default variant — it changes the coin in the selected panel.
Choose a variant
Default behaviour: the user clicks and sees the coin where they are already looking.
In the selected panel and in the linking groupThe coin arrives in the current panel and in all panels of the user’s linking group.
Only in the linking groupThe group switches, while what the user is working with right now stays unchanged.
New panel, tab or windowAdd a chart or order book without touching the open panels.
On all exchangesOne coin — columns across all the user’s exchanges.
Level together with the coinOpen the coin and place a horizontal price level with a single link.
In the panel the user is looking at
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myapp- The coin opens in the selected panel — the panel the user last used.
- Its linking group and panels set to “To active window” switch along with it — the same behavior as when the user picks a coin from the terminal list.
- If the selected panel has no coin, for example “Positions”, the coin opens in the first suitable panel on that tab. If there are no suitable panels, a new order book appears on the tab.
Suitable when the user clicks in your service and immediately looks at the terminal: screener, signals table, news feed.
In the selected panel and in the linking group
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&src=myapp- The selected panel gets the coin — same as the default variant.
- At the same time all panels in group 3 across all terminal windows receive it, including background tabs.
- The selected panel does not join group 3: its own linking group remains unchanged.
Suitable when the user has a dedicated group “for your service” that should follow every click, and you also need to switch the current panel.
Only in the linking group
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&target=group&src=myapp- Only panels in group 3 across all windows receive the coin.
- The selected panel does not change: the user can trade one coin and simultaneously view your signals in a separate group.
- If the group has no panels, the terminal shows the message ‘Group 3 has no panels (request from “myapp”)’.
To have the terminal create a place instead of showing the message, add ifEmpty=create:
lootx://open/instrument?t=BINANCE:BTCUSDT.P&link=3&target=group&ifEmpty=create&src=myappIf the group is empty, a new panel — an order book or the type specified in layout — will appear on the active tab and immediately join group 3. Subsequent links will arrive in that panel.
Suitable for most screeners. This is the cleanest option: your service manages its own linking group and does not interfere with the rest of the user’s workspace. How to let the user pick a group — see Linking group in your service.
New panel next to the current ones
lootx://open/panel?layout=chart&t=BINANCE:BTCUSDT.P&src=myappopen/panel always creates a new panel — even if the same panel type is already open — and adds it to the active tab. Open panels are not changed. The panel type is set by layout:
layout |
Panel |
|---|---|
orderbook |
Order book — default |
chart |
Chart |
tape |
time and sales |
liqmap |
Liquidity map |
combo1 … combo4 |
Combo of chart and order books — variants in the reference |
With link=5 the new panel immediately joins group 5, and the other panels in that group switch along with it.
In a new tab
lootx://open/panel?layout=combo1&t=BINANCE:BTCUSDT.P&target=tab&link=5&src=myappThe terminal opens a new tab — or uses an existing empty one — names it after the coin and creates the layout panel inside. Without link the panel is not in any linking group.
In a new window
lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myappA new window with the layout panel is brought to the foreground. Since v0.6.53 it opens in the same state as the current one: if the terminal window is maximized, the new one will be maximized too. Useful for a second monitor.
The coin on all exchanges
lootx://open/all-exchanges?s=SOLUSDT&src=myappThe terminal lays out the coin in columns across all exchanges — according to the user’s “All exchanges” settings: the set and order of exchanges, spot and futures, chart position.
- Each column gets its own linking group automatically, so columns do not interfere with each other or with other panels.
- Without
targetthe layout opens where the user has configured it.target=tab— always a new tab,target=window— always a new window. - The exchange itself is irrelevant here; only the symbol is needed: even
t=HTX:BTCUSDTwill lay out BTCUSDT across LootX exchanges.
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myappSuitable for arbitrage and analytics services: the user immediately compares order books for the same coin across venues.
Open and immediately mark a level
lootx://open/instrument?t=BINANCE:BTCUSDT.P&level=64821.5&link=3&target=group&src=myappThe level parameter can be added to any opening variant: the terminal first opens the coin according to target and link, then places a horizontal level at price 64821.5. The level is attributed to your src, and can later be removed with the level/clear command without touching the user’s drawings. More — see Levels from your service.
Switch a group without opening anything
lootx://link/set?g=3&t=BINANCE:BTCUSDT.P&src=myappAll panels of group 3 across all windows switch to the coin. The command does not create panels, open windows, or show messages — even if the group is empty.
link/clear?g=3 clears the coin stored for the group — open panels are not changed.
Just raise the terminal
lootx://open/terminal?src=myappBrings the terminal window to the foreground — for example, for a “Go to terminal” button next to other actions.
Comparison of variants
| Link | Selected panel | Panels in group | What appears |
|---|---|---|---|
open/instrument |
Changes together with its group | — | Order book, if no suitable panel exists |
open/instrument + link=3 |
Changes | Group 3 changes | Order book, if no suitable panel exists |
open/instrument + link=3&target=group |
Does not change | Group 3 changes | Nothing; if the group is empty — a message |
… + ifEmpty=create |
Does not change | Group 3 changes | A panel in group 3 if the group was empty |
open/panel |
Does not change | With link — the group changes |
New panel on the tab |
open/panel + target=tab |
Does not change | With link — the group changes |
New tab |
open/panel + target=window |
Does not change | With link — the group changes |
New window |
open/all-exchanges |
Does not change | Each column has its own group | “All exchanges” tab or window |
link/set?g=3 |
Does not change | Group 3 changes | Nothing |
Linking group in your service
Terminal panels are grouped into linking groups: changing the coin in one panel switches the whole group. In the terminal UI groups are distinguished by color, in the link they are addressed by number only.
The best pattern for a screener is to let the user pick a group once in your service settings and then send every click to that group. The user does not pick a group on each transition, and the terminal group always shows what they selected in your UI.
To make the choice look familiar, color your groups the same way the terminal does:
| Group | Color in terminal | Color code |
|---|---|---|
1 |
Red | #EF5350 |
2 |
Blue | #42A5F5 |
3 |
Green | #66BB6A |
4 |
Orange | #FFA726 |
5 |
Purple | #AB47BC |
6 |
Teal | #26C6DA |
7 |
Yellow | #FFEE58 |
8 |
Pink | #EC407A |
// The group the user chose in your settings (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", // the first click creates the panel in the group
src: "myscreener",
});
location.href = `lootx://open/instrument?${query}`;
}What happens on the terminal side
| Situation | What will happen |
|---|---|
| Terminal is closed | Windows will launch LootX. The command waits for the terminal to load and then executes. |
| Terminal already open | The command goes to the running terminal — a second copy is not started. |
| Window is minimized or covered by other windows | On every command the window is restored and brought to the foreground. |
| Multiple windows are open | The command arrives to the active terminal window — the one the user worked in last. |
| The user clicks many times in a row | A new command to the same target replaces the pending one: the terminal will open the last selected coin, not cycle through them all. Level commands are not replaced and are executed in order. |
| The command failed to execute | The terminal shows a message with the name from src — list in the reference. |
Recipes
The user picks a group in the screener settings. A click on a row opens the coin in that group and marks the liquidity wall price:
lootx://open/instrument?t=BINANCE:SOLUSDT.P&link=3&target=group&ifEmpty=create&level=182.45&src=densityscreenerWhen the wall is eaten, the screener removes its mark — the user’s drawings remain:
lootx://level/clear?t=BINANCE:SOLUSDT.P&price=182.45&src=densityscreenerEach signal opens the coin next to the user’s current work — in a separate window with a combo chart, convenient to keep on a second monitor:
lootx://open/panel?layout=combo1&t=BYBIT:ETHUSDT.P&target=window&src=signalbotFor frequent signals it’s better to send the coin to one group rather than opening a window per signal:
lootx://open/instrument?t=BYBIT:ETHUSDT.P&link=5&target=group&ifEmpty=create&src=signalbotCompare a coin across all the user’s exchanges — in a new tab:
lootx://open/all-exchanges?s=ETHUSDT&target=tab&src=arbitrageOpen two markets of the same coin — spot and futures — in different groups:
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=arbitrageOne link executes one command: two links are two clicks or two navigations in a single click handler.