Introducción
Una Visión Rápida de Pine Script: "Estrategia" vs "Indicador"
Con el lanzamiento de Signal Bots, los usuarios de TradingView ahora pueden publicar sus señales y crear un Signal Bot en BloFin. En esta guía, repasaremos las diversas especificaciones de mensajes de alerta que BloFin admite para los usuarios.
Para aquellos que están familiarizados con PineScript y confían exclusivamente en scripts de estrategia para enviar señales, hemos diseñado meticulosamente un formato exclusivo de especificaciones. Este formato integra sin problemas los marcadores de posición de estrategia de PineScript, lo que le permite transmitir señales de trading con notable facilidad. Si eres un usuario nativo de PineScript, este formato es tu compañero ideal, proporcionando un enfoque simplificado para fusionar tus scripts de estrategia con los marcadores de posición de estrategia de TradingView.
Las estrategias de Pine Script sirven para realizar backtesting en datos históricos, así como pruebas hacia adelante en mercados en vivo. Además de realizar cálculos de indicadores, las estrategias incluyen llamadas a funciones strategy.*() que transmiten órdenes de trading al emulador de broker de Pine Script. Este emulador puede simular la ejecución de estas órdenes. Los resultados de las pruebas se visualizan en la pestaña "Strategy Tester" ubicada en la parte inferior del gráfico, junto a la pestaña "Pine Script Editor".
Por otro lado, los indicadores de Pine Script también implican cálculos, pero no están destinados a ser utilizados en escenarios de backtesting. Debido a su independencia del emulador de broker, los indicadores consumen menos recursos y se ejecutan más rápidamente.
Es importante tener en cuenta que tienes la flexibilidad de utilizar cualquiera de los formatos. Según los mensajes que transmitas, el sistema discernirá inteligentemente el formato utilizado y analizará tus mensajes en consecuencia. Este procesamiento inteligente garantiza una experiencia fluida independientemente del enfoque elegido.
Usuarios de PineScript Strategy
Las siguientes especificaciones están diseñadas específicamente para usuarios que componen sus algoritmos utilizando estrategias de PineScript y principalmente con la función strategy.*. Este formato está dedicado a acomodar los valores de marcadores de posición de la estrategia, asegurando una adaptabilidad perfecta. Para comprender mejor los scripts de estrategia y el proceso de envío de alertas utilizando variables de marcadores de posición de la estrategia, puedes encontrar información adicional en este enlace en TradingView.
Overview of AlertMsg Specifications
|
Parámetro
|
Requerido
|
Valores
|
| id |
Requerido
|
{{strategy.order.id}} de TradingView
|
| action |
Requerido
|
{{strategy.order.action}} de TradingView
|
| marketPosition |
Requerido
|
{{strategy.market_position}} de TradingView
|
| prevMarketPosition |
Requerido
|
{{strategy.prev_market_position}} de TradingView
|
|
instrument
|
Requerido |
|
|
signalToken
|
Requerido
|
Proporcionado por BloFin al crear la señal
|
|
timestamp
|
Requerido
|
{{timenow}} de TradingView
|
|
maxLag
|
Opcional
|
Valor entero no negativo entre [1, 3600]. Por defecto, 60.
|
|
investmentType
|
Opcional*
|
|
|
amount
|
Requerido
|
|
InvestmentType se establecerá de forma predeterminada en "percentage_investment" si la señal se considera una señal de entrada y "percentage_position" si la señal se considera una señal de salida. Sin embargo, se recomienda encarecidamente que este valor se configure como "base" y que la cantidad se establezca en "{{strategy.order.contracts}}" para una compatibilidad máxima con tu estrategia de TradingView.
- Especificación de AlertMsg - id
id - Identificador de la orden
{{strategy.order.id}} - devuelve el ID de la orden ejecutada (la cadena utilizada como primer parámetro en una de las llamadas de función que generan órdenes: strategy.entry, strategy.exit o strategy.order).
- Especificación de AlertMsg - action
action - ¿Comprar o vender?
{{strategy.order.action}} - devuelve la cadena "buy" o "sell" para la orden ejecutada.
- Especificación de AlertMsg - marketPosition
marketPosition - Estado previsto de la posición (tras la ejecución de la orden)
{{strategy.market_position}} devuelve la posición actual de la estrategia en forma de cadena: "long", "flat", o "short".
{{strategy.market_position}} devuelve la posición actual de la estrategia en forma de cadena: "long", "flat", o "short".
- Especificación de AlertMsg - prevMarketPosition
prevMarketPosition - Estado previo de la posición (antes de la ejecución de la orden)
{{strategy.prev_market_position}} devuelve la posición anterior de la estrategia en forma de cadena: "long", "flat", o "short".
{{strategy.prev_market_position}} devuelve la posición anterior de la estrategia en forma de cadena: "long", "flat", o "short".
- Especificación de AlertMsg - instrumento
Formato 1: ticker - Valores de marcador de posición de TradingView
Un 'marcador de posición estándar'* es un fragmento literal de texto rodeado por dobles llaves e incluido dentro de un mensaje de alerta.
"{{ticker}}" devolverá el Ticker del instrumento en el que se generó la alerta.
Por ejemplo: "BTCUSDT.P", "ETHUSDT.P".
Marcador de posición estándar para acceder a variables en PineScript. Obtén más información aquí.
"{{ticker}}" devolverá el Ticker del instrumento en el que se generó la alerta.
Por ejemplo: "BTCUSDT.P", "ETHUSDT.P".
Marcador de posición estándar para acceder a variables en PineScript. Obtén más información aquí.
Formato 2: Formato de instrumento de BloFin
ID del instrumento o "instId" en la API de BloFin.
Por ejemplo: "BTC-USDT", "ETH-USDT".
Por ejemplo: "BTC-USDT", "ETH-USDT".
- Especificación de AlertMsg - signalToken
El token es una medida de seguridad para asegurar que las solicitudes entrantes sean legítimas y autorizadas. Este signalToken se generará automáticamente cuando el usuario cree con éxito una nueva señal en nuestra plataforma, y debe copiarse en el Mensaje de Alerta de TradingView.
¿Cómo localizar su signalToken para una señal ya activa?
- Consulta la sección Detalles de tu señal
- Localiza tu signalToken en la sección de mensajes de alerta recomendados.
- Especificación de AlertMsg - timestamp
timenow - Valores de marcador de posición de TradingView
Un 'marcador de posición estándar'* es un fragmento literal de texto rodeado por dobles llaves e incluido dentro de un mensaje de alerta.
"{{timenow}}" devolverá la hora actual y exacta de cuando se generó la alerta, en UTC y en el formato yyyy-MM-ddTHH: mm: ssZ.
Por ejemplo: "2023-06-01T17:38:10Z".
Marcador de posición estándar para acceder a variables en PineScript. Obtén más información aquí.
Marcador de posición estándar para acceder a variables en PineScript. Obtén más información aquí.
- Especificación de AlertMsg - maxLag
maxLag - Retraso máximo aceptable
El término "maxLag" se refiere al retraso o latencia máximo permitido, medido en segundos, antes de que una señal de trading se considere nula. Este cálculo de maxLag implica determinar la diferencia de tiempo entre el momento en que se envió la señal desde TradingView (usando el campo "timestamp" dentro del mensaje de alerta) y el momento en que se recibió en BloFin con el fin de ejecutar una orden.
De forma predeterminada, se establece en 60 segundos. Establecer un valor maxLag ayuda a garantizar que el Signal Bot funcione de manera oportuna, evitando actuar sobre señales desactualizadas o potencialmente inexactas que ya no reflejan las condiciones actuales del mercado.
- Especificación de AlertMsg - investmentType & amount
Nota importante: Para garantizar una compatibilidad óptima con tu estrategia de TradingView, recomendamos encarecidamente configurar investmentType como "base" y establecer la cantidad en "{{strategy.order.contracts}}". Siguiendo este enfoque, las cantidades de las órdenes en BloFin se alinearán con las cantidades de las órdenes especificadas en tu estrategia de TradingView.
investmentType y Amount
(SOLO PARA SEÑALES DE ENTRADA)
- base: Cantidad en moneda base (Opción recomendada)
- margin: Margen invertido en moneda de cotización
- contract: Número fijo de contratos
- percentage_balance: Basado en el % del Saldo Disponible (es decir, el margen disponible para abrir nuevas órdenes)
- percentage_investment: Basado en el % del Margen Invertido Inicial al crear el bot. El margen adicional añadido posteriormente no se contará
(SOLO PARA SEÑALES DE SALIDA)
- base: Cantidad en moneda base (Opción recomendada)
- percentage_position: Basado en el % de la posición abierta