Botón «Abrir en LootX»
Cómo añadir a un sitio de screener, servicio de señales o analítica un botón que abre la moneda directamente en el terminal LootX: enlaces lootx://, ejemplos en HTML, React y JavaScript.
El botón «Abrir en LootX» lleva al usuario de su servicio directamente al terminal de trading: la moneda, el exchange y el mercado correctos, el panel correcto, con un solo clic. Técnicamente es un enlace normal con el esquema lootx://. No se necesitan claves API, registro ni una parte de servidor de su lado.
Cómo funciona
El usuario hace clic en el botón
En su página hay un enlace normal del tipo lootx://open/instrument?….
El navegador pide permiso
En la primera transición, el navegador preguntará si se puede abrir LootX. En Chrome y Edge se puede marcar «Permitir siempre»; entonces la pregunta no volverá a aparecer para su sitio.
El terminal ejecuta el comando
Si LootX ya está en ejecución, el comando llega a la ventana abierta; no se abrirá una segunda copia del terminal. Si está cerrado, Windows lo iniciará y el comando se ejecutará después del arranque.
Inicio rápido
Construya el enlace
Se necesitan el código del instrumento en formato TradingView — t, donde el sufijo .P significa futuros perpetuos — y el nombre de su servicio src: el usuario lo verá en el mensaje del terminal si el comando no se puede ejecutar.
lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myscreenerPonga el enlace en un botón
Sirve cualquier elemento en el que el usuario haga clic por sí mismo; ejemplos más abajo.
Pruébelo
Abra la página en un ordenador con LootX instalado y haga clic en el botón. El terminal levantará la ventana y abrirá BTCUSDT en el panel activo.
<a class="open-in-lootx"
href="lootx://open/instrument?t=BINANCE:BTCUSDT.P&src=myscreener">
Abrir en LootX
</a>type Props = { exchange: string; symbol: string; perp?: boolean };
export function OpenInLootX({ exchange, symbol, perp = true }: Props) {
const t = `${exchange}:${symbol}${perp ? ".P" : ""}`;
const query = new URLSearchParams({ t, src: "myscreener" });
return <a href={`lootx://open/instrument?${query}`}>Abrir en LootX</a>;
}// Una función para todos los comandos: los valores se codifican y src se añade siempre.
export function lootxLink(command, params = {}) {
const query = new URLSearchParams({ ...params, src: "myscreener" });
return `lootx://${command}?${query}`;
}
lootxLink("open/instrument", { t: "BYBIT:SOLUSDT.P" });
// → lootx://open/instrument?t=BYBIT%3ASOLUSDT.P&src=myscreenerPruébelo directamente desde aquí:
Funcionará si LootX para Windows está instalado en este ordenador.
Enlaces listos
- Abrir futuros en el panel activo
lootx://open/instrument?t=BYBIT:SOLUSDT.P&src=myapp - Abrir spot
lootx://open/instrument?t=BINANCE:ETHUSDT&src=myapp - Mostrar la moneda en todos los exchanges en una ventana nueva
lootx://open/all-exchanges?s=SOLUSDT&target=window&src=myapp - Abrir el gráfico en una ventana nueva
lootx://open/panel?layout=chart&t=OKX:ETHUSDT.P&target=window&src=myapp - Enviar la moneda al grupo de enlace 3
lootx://open/instrument?t=OKX:ETHUSDT.P&link=3&target=group&src=myapp - Abrir la moneda y marcar un nivel de inmediato
lootx://open/instrument?t=BINANCE:BTCUSDT.P&level=64821.5&src=myapp - Marcar un nivel
lootx://level/set?t=BINANCE:BTCUSDT.P&price=64821.5&src=myapp - Quitar sus niveles (0.6.53+)
lootx://level/clear?t=BINANCE:BTCUSDT.P&src=myapp
Todos los comandos y parámetros están en la referencia de enlaces lootx://.
Niveles de su servicio
Un screener de muros de liquidez o un servicio de señales puede marcar precios importantes en el terminal. level/set coloca un nivel horizontal en la moneda y level/clear lo quita.
Desde la versión 0.6.53, cada nivel se marca con su src: la cinta de operaciones etiqueta la línea con el nombre del servicio, y level/clear quita solo sus niveles; los dibujados por el usuario y los colocados por otros servicios permanecen. Así se puede actualizar la anotación de forma segura: primero quite sus niveles y luego coloque los nuevos.
Cómo llamar al enlace correctamente
- Desde la ventana principal de la página. Desde un iframe con el atributo
sandbox, el navegador no abrirá el enlace. Si su widget se integra en sitios ajenos, abra el enlace en la ventana superior. - Codifique los valores. Construya el enlace con
URLSearchParamsoencodeURIComponent. En los valores se permiten letras latinas, números y_ . : -; el enlace completo, hasta 1500 caracteres. - Muestre una alternativa de respaldo. No se puede saber con fiabilidad desde el navegador si el terminal está instalado. Abra el enlace de inmediato y, unos segundos después, ofrezca ayuda de forma discreta.
openButton.addEventListener("click", () => {
location.href = lootxLink("open/instrument", { t: "BINANCE:BTCUSDT.P" });
// No «el terminal no está instalado», sino una pista por si no ocurre nada.
setTimeout(() => {
hint.textContent = "¿No se abrió nada? Instale LootX para Windows.";
hint.hidden = false;
}, 3000);
});Seguridad y limitaciones
| Regla | Qué significa para la integración |
|---|---|
| Solo navegación | El enlace abre una moneda, un panel o una ventana y coloca niveles. No se puede colocar, modificar ni cancelar una orden mediante el enlace: no existen tales comandos en el esquema. |
| Sin canal de retorno | El terminal no responde nada al sitio ni informa nada sobre el usuario. Un comando exitoso se ejecuta en silencio. |
| Validación estricta | Los comandos provienen de una lista cerrada y los valores, de caracteres permitidos. Un valor no válido se descarta como si no se hubiera pasado. |
| Límite de frecuencia | Hasta 10 comandos por segundo; los excedentes se descartan. Un comando repetido hacia el mismo destino reemplaza al aún no ejecutado; los comandos de niveles se ejecutan todos y en orden. |
| Compatibilidad | El terminal ignora los parámetros desconocidos, de modo que los parámetros nuevos no rompen las versiones antiguas. |