Especificações da mensagem de alerta do bot de sinais de trading 2.0

Publicado a 30/08/2023Atualizado a 3/07/2024Leitura de 20 minutos

Índice

Introdução

Com o lançamento dos Bots de Sinais, os utilizadores do TradingView podem agora publicar os seus sinais e criar um Bot de Sinais no OKX. Neste guia, iremos percorrer as várias especificações de mensagens de alerta que o OKX suporta para os utilizadores.

Para aqueles que são experientes em PineScript™ e dependem exclusivamente de scripts de estratégia para enviar sinais, concebemos meticulosamente um formato de especificações exclusivo. Este formato integra perfeitamente os marcadores de estratégia do PineScript™, permitindo-lhe transmitir sinais de trading com uma facilidade notável. Se é um utilizador nativo da estratégia PineScript™, este formato é o seu companheiro ideal, fornecendo uma abordagem simplificada para fundir os seus scripts de estratégia com os marcadores de posição da estratégia do TradingView. Se é um escritor de estratégias e usa as funções strategy.*() para construir os seus sinais de trading, por favor consulte a Secção A - para utilizadores de estratégias PineScript™ abaixo.

Por outro lado, compreendemos que nem toda a gente confia apenas nos scripts de estratégia PineScript™. Na Secção B - Universalmente compatível deste guia, fornecemos um conjunto versátil de especificações que vão além dos métodos de scripting. Estas especificações funcionam para todas as abordagens de geração de sinais. Quer utilize indicadores personalizados, várias técnicas de elaboração de gráficos ou até prefira alertas manuais, esta estrutura de especificação de "tamanho único" tem tudo o que precisa.

Uma breve visão geral do Pine Script™: "Estratégia" vs "Indicador"

As estratégias Pine Script™ têm como objetivo realizar backtesting em dados históricos, bem como forward testing em mercados reais. Além de efetuar cálculos de indicadores, as estratégias incluem chamadas para funções strategy.*() que transmitem ordens de transação para o emulador de corretor da Pine Script™. Este emulador pode então simular a execução destas ordens. Os resultados dos backtests são visualizados no separador "Strategy Tester" localizado na parte inferior do gráfico, adjacente ao separador "Pine Script™ Editor".

Sec A - breve visão geral 1

Por outro lado, os indicadores Pine Script™ também envolvem cálculos, mas não se destinam a ser utilizados em cenários de backtesting. Devido à sua independência do emulador de corretor, os indicadores consomem menos recursos e são executados mais rapidamente.

Sec A - breve visão geral 2

É importante notar que tem a flexibilidade de utilizar o formato da Secção A ou o da Secção B - ambos são totalmente compatíveis. Com base nas mensagens que transmite, o sistema deteta de forma inteligente o formato utilizado e analisa as suas mensagens em conformidade. Este processamento inteligente garante uma experiência sem falhas, independentemente da abordagem escolhida.

Secção A (Utilizadores da estratégia PineScript™)

As especificações que se seguem foram especificamente concebidas para os utilizadores que compõem os seus algoritmos utilizando estratégias PineScript™ e principalmente a função strategy.*. Este formato é dedicado a acomodar valores de marcadores de posição de estratégia, garantindo uma adaptabilidade perfeita. Para uma compreensão mais profunda dos scripts de estratégia e do processo de envio de alertas utilizando variáveis de marcadores de posição de estratégia, pode encontrar informações adicionais nesta ligação.

Se este conceito não lhe é familiar, a Secção B fornece uma abordagem alternativa para a construção dos seus alertas, aplicável a uma gama mais vasta de cenários.

Visão geral das especificações das mensagens de alerta

Parâmetro
Necessário
Valores
id
Necessário
  • {{strategy.order.id}} a partir do TradingView

ação
Necessário
  • {{strategy.order.action}} a partir do TradingView

Posição no mercado
Necessário
  • {{strategy.market_position}} a partir do TradingView

Posição anterior no mercado
Necessário
  • {{strategy.prev_market_position}} a partir do TradingView

instrumento
Necessário
  • {{ticker}} a partir do TradingView

  • Formato Instld da OKX

Token de sinais
Necessário
Fornecido pela OKX aquando da criação do sinal
carimbo de data e hora
Necessário
{{timenow}} a partir do TradingView
Atraso máx.
Opcional
Valor inteiro não negativo entre [1, 3600]. A predefinição é 60.
Tipo de investimento
Opcional*


  • base (PARA SINAIS DE ENTRADA E SAÍDA) Montante na moeda base

  • margem (SÓ PARA SINAIS DE ENTRADA) Margem investida na moeda cotada

  • contrato (SÓ PARA SINAIS DE ENTRADA) Número fixo de contratos

  • saldo_percentual (SÓ PARA SINAIS DE ENTRADA) Com base na % do saldo disponível (ou seja, a margem disponível para abrir novas ordens)

  • investimento_percentual (SÓ PARA SINAIS DE ENTRADA) Com base no % de Investimento Ativo no seu bot. O Investimento Ativo será tipicamente a sua margem inicial investida no momento da criação do bot e permanecerá fixo até que adicione mais margem e escolha aumentar esse valor.

  • posição_percentual (SÓ PARA SINAIS DE SAÍDA) Com base na % da posição aberta

quantidade
Necessário
  • base (número flutuante positivo)

  • margem (número flutuante positivo)

  • contrato (número inteiro positivo)

  • saldo_percentual (valor flutuante entre [0,01, 100] em %)

  • investimento_percentual (valor flutuante entre [0,01, 100] em %)

  • posição_percentual (valor flutuante entre [0,01, 100] em %)

* O Tipo de investimento será predefinido como "percentage_investment" se o sinal for considerado um sinal de entrada e "percentage_position" se o sinal for considerado um sinal de saída. No entanto, recomenda-se vivamente que este valor seja definido como "base" e que a quantidade seja definida como "{{strategy.order.contracts}}" para uma compatibilidade máxima com a sua estratégia TradingView.

1. Especificação da mensagem de alerta - id

Sec A - id

id - O identificador da ordem

{{strategy.order.id}} - devolve o ID da ordem executada (a cadeia utilizada como primeiro parâmetro numa das chamadas de função que geram ordens: strategy.entry, strategy.exit ou strategy.order).

2. Especificação da mensagem de alerta - ação

Sec A - ação

ação - Comprar ou vender?

{{strategy.order.action}} - devolve a cadeia de caracteres "comprar" ou "vender" para a ordem executada.

3. Especificação de mensagens de alerta - Posição de mercado

Sec A - Posição de mercado

Posição de mercado - Estado da posição pretendida (aquando da execução da ordem)

{{strategy.market_position}} - devolve a posição atual da estratégia sob a forma de uma cadeia de caracteres: "longa", "plana" ou "curta".

4. Especificação de mensagem de alerta - Posição de mercado anterior

Sec A - Posição de mercado anterior

Posição de mercado - Estado da posição anterior (antes da execução da ordem)

{{strategy.prev_market_position}} - devolve a posição anterior da estratégia sob a forma de uma cadeia de caracteres: "longa", "plana" ou "curta".

5. Especificação de mensagem de alerta - instrumento

Sec A - instrumento

Formato 1: ticker - valores do marcador de posição do TradingView

Um "marcador de posição padrão"* é um texto literal rodeado por parênteses duplos e incluído numa mensagem de alerta.

"{{ticker}}" devolverá o Ticker do instrumento em que o alerta foi gerado.

Por exemplo: "BTCUSDT.P", "ETHUSDT.P".

* Marcador de posição padrão para aceder a variáveis no PineScript™. Saiba mais aqui.

Formato 2: Formato de instrumento OKX

ID do instrumento, ou "instId" na API da OKX. Pode encontrar mais detalhes na seguinte ligação

Por exemplo: "BTC-USDT-SWAP", "ETH-USDT-SWAP"

6. Especificação de mensagem de alerta - Token de sinais

Sec A - Token de sinais

Token de sinais -- Autenticação para o sinal

O token é uma medida de segurança para garantir que os pedidos recebidos são legítimos e autorizados. Este Token de sinais será gerado automaticamente quando o utilizador criar com sucesso um novo sinal na nossa plataforma, e precisa de ser copiado para a mensagem de alerta do TradingView.

Como localizar o Token de sinais para um sinal já ativo?

  1. Consulte a secção Detalhes do seu sinal

Sec A - localizar o Token de sinais 1

  1. Localize o seu Token de sinais na secção de mensagens de alerta recomendadas

Sec A - localizar o Token de sinais 2

7. Especificação de mensagem de alerta - carimbo de data e hora

Sec A - carimbo de data e hora

hora atual - valores do marcador de posição do TradingView

Um "marcador de posição padrão"* é um texto literal rodeado por parênteses duplos e incluído numa mensagem de alerta.

"{{timenow}}" devolverá a hora atual e exata da geração do alerta, em UTC e no formato aaaa-MM-ddTHH: mm: ssZ.

Por exemplo: "2023-06-01T17:38:10Z"

* Marcador de posição padrão para aceder a variáveis no PineScript. Saiba mais aqui.

8. Especificação de mensagem de alerta - Atraso máx.

Sec A - Atraso máx.

Atraso máx.- Atraso máximo aceitável

O termo "Atraso máx." refere-se ao atraso ou latência máxima permitida, medida em segundos, antes de um sinal de trading ser considerado nulo. Este cálculo do Atraso máx. consiste em determinar a diferença de tempo entre o momento em que o sinal foi enviado pelo TradingView (utilizando o campo "carimbo de data e hora" na mensagem de alerta) e o momento em que foi recebido no OKX para efeitos de execução de uma ordem.

Por predefinição, está configurado para 60 segundos. A definição de um valor de Atraso máx. ajuda a garantir que o Bot de sinais opera de forma atempada, evitando agir sobre sinais desatualizados ou potencialmente imprecisos que podem já não refletir as condições atuais do mercado.

9. Especificação de mensagem de alerta - Tipo de investimento e quantidade

Sec A - tipo de investimento e quantidade

Nota importante: Para garantir uma compatibilidade ideal com a sua estratégia TradingView, recomendamos vivamente que configure o Tipo de investimento como "base" e defina a quantidade como "{{strategy.order.contracts}}". Seguindo esta abordagem, as quantidades de ordens no OKX serão alinhadas com as quantidades de ordens especificadas na sua estratégia TradingView.

Tipo de investimento e quantidade

(SÓ PARA SINAIS DE ENTRADA)
  • base: Quantidade na moeda-base (escolha recomendada)

  • margem: Margem investida na moeda cotada

  • contrato: Um número fixo de contratos

  • saldo_percentual: Com base na % do Saldo Disponível (ou seja, a margem disponível para a abertura de novas ordens)

  • investimento_percentual: Com base no % de Investimento Ativo no seu bot. O Investimento Ativo será tipicamente a sua margem inicial investida no momento da criação do bot e permanecerá fixo até que adicione mais margem e escolha aumentar esse valor. Por exemplo, se criar um bot com uma margem inicial investida de 1000 USDT, o seu Investimento Ativo será definido como 1000 USDT. Para quaisquer sinais recebidos, este é o valor que será utilizado para os cálculos do tamanho da sua ordem. Digamos que, após alguns dias de execução do seu bot, decida que ele está a ter um bom desempenho e reinveste mais 1000 USDT de margem, adicionando-o ao seu Investimento Ativo. Posteriormente, o seu Investimento Ativo aumentará para 2000 USDT e este será o novo valor utilizado para os cálculos do tamanho da sua ordem. Se não tiver a certeza qual é o valor atual do Investimento Ativo do seu bot, pode sempre verificar isso na secção Detalhes do Bot.

(SÓ PARA SINAIS DE SAÍDA)
  • base: Quantidade na moeda-base (escolha recomendada)
  • posição_percentual: Com base na % de posições abertas

Secção B (Universalmente compatível)

As especificações fornecidas abaixo são versáteis e podem ser adaptadas a qualquer cenário. Quer esteja a utilizar o PineScript™ para criar scripts de estratégia ou de indicador (estudo), quer esteja a introduzir manualmente alertas na interface de utilizador Alerta do TradingView, estas especificações permanecem adaptáveis e personalizáveis.

Descrição geral das especificações de mensagem de alerta

Parâmetro Necessário Valores
ação Necessário
  • ENTRADA_LONGA

  • ENTRADA_CURTA

  • SAÍDA_LONGA

  • SAÍDA_CURTA

instrumento Necessário
  • {{ticker}} a partir do TradingView

  • Formato Instld da OKX

Token de sinais Necessário Fornecido pela OKX aquando da criação do sinal
carimbo de data e hora Necessário {{timenow}} a partir do TradingView
Atraso máx. Opcional Valor inteiro não negativo entre [1, 3600]. A predefinição é 60.
Tipo de ordem Opcional. O parâmetro é obrigatório se o Tipo de ordem = Limite
  • mercado

  • limite

Compensação de preço de ordem Opcional. O parâmetro é necessário se não houver definições configuradas aquando da criação do Bot de sinais do OKX Valor flutuante entre [0, 100] em %
Tipo de investimento Opcional. O parâmetro é obrigatório se o Tipo de ordem = Limite
  • margem (SÓ PARA SINAIS DE ENTRADA) Margem investida na moeda cotada

  • contrato (SÓ PARA SINAIS DE ENTRADA) Número fixo de contratos

  • saldo_percentual (SÓ PARA SINAIS DE ENTRADA) Com base na % do saldo disponível (ou seja, a margem disponível para abrir novas ordens)

  • investimento_percentual (SÓ PARA SINAIS DE ENTRADA) Com base no % de Investimento Ativo no seu bot. O Investimento Ativo será tipicamente a sua margem inicial investida no momento da criação do bot e permanecerá fixo até que adicione mais margem e escolha aumentar esse valor.

  • posição_percentual (SÓ PARA SINAIS DE SAÍDA) Com base na % da posição aberta

quantidade Opcional. O parâmetro é obrigatório se o Tipo de ordem = Limite
  • margem (número flutuante positivo)

  • contrato (número inteiro positivo)

  • saldo_percentual (valor flutuante entre [0,01, 100] em %)

  • investimento_percentual (valor flutuante entre [0,01, 100] em %)

  • posição_percentual (valor flutuante entre [0,01, 100] em %)

1. Especificação da mensagem de alerta - ação

Modo de posição:

O Bot de sinais opera em modo unidirecional (i.e., Compra/Venda), o que significa que o bot apenas manterá posições numa direção para um determinado instrumento.

Ordens abertas
  • ENTRADA_LONGA: Abrir uma posição longa com a expetativa de que o seu preço suba.
  • ENTRADA_CURTA: Abrir uma posição curta com a expetativa de que o seu preço diminua.
Fechar ordens
  • SAÍDA_LONGA: Fechar uma posição longa parcial ou totalmente através da venda das posições detidas.
  • SAÍDA_CURTA: Fechar uma posição curta parcial ou totalmente através da compra dos contratos.

2. Especificação de mensagem de alerta - instrumento

Formato 1: ticker - valores do marcador de posição do TradingView

Um "marcador de posição padrão"* é um texto literal rodeado por parênteses duplos e incluído numa mensagem de alerta.

"{{ticker}}" devolverá o Ticker do instrumento em que o alerta foi gerado.

Por exemplo: "BTCUSDT.P", "ETHUSDT.P".

* Marcador de posição padrão para aceder a variáveis no PineScript. Saiba mais aqui.

Formato 2: Formato de instrumento OKX

ID do instrumento, ou "instId" na API da OKX. Pode encontrar mais detalhes na seguinte ligação

Por exemplo: "BTC-USDT-SWAP", "ETH-USDT-SWAP"

3. Especificação de mensagem de alerta - Token de sinais

Token de sinais- Autenticação para Sinal

O token é uma medida de segurança para garantir que os pedidos recebidos são legítimos e autorizados. Este Token de sinais será gerado automaticamente quando o utilizador criar com sucesso um novo sinal na nossa plataforma, e precisa de ser copiado para a mensagem de alerta do TradingView.

4. Especificação de mensagem de alerta - carimbo de data e hora

hora atual - valores do marcador de posição do TradingView

Um "marcador de posição padrão"* é um texto literal rodeado por parênteses duplos e incluído numa mensagem de alerta.

"{{timenow}}" devolverá a hora atual e exata da geração do alerta, em UTC e no formato aaaa-MM-ddTHH: mm: ssZ.

Formatação possível (hora UTC, formato ISO 8061)

  • Formato yyyy-MM-ddTHH:mm:ssZ, por exemplo: "2023-06-01T17:38:10Z"
  • Formato yyyy-MM-ddTHH:mm:ss.SSSZ, por exemplo: "2023-06-01T17:38:10.836Z"
  • Formato yyyy-MM-ddTHH:mm:ss+0000, por exemplo: "2023-06-01T17:38:10+0000"

Por exemplo: "2023-06-01T17:38:10Z"

* Marcador de posição padrão para aceder a variáveis no PineScript. Saiba mais aqui.

5. Especificação de mensagem de alerta - Atraso máx.

Atraso máx.- Atraso máximo aceitável

O termo "Atraso máx." refere-se ao atraso ou latência máxima permitida, medida em segundos, antes de um sinal de trading ser considerado nulo. Este cálculo do Atraso máx. consiste em determinar a diferença de tempo entre o momento em que o sinal foi enviado pelo TradingView (utilizando o campo "carimbo de data e hora" na mensagem de alerta) e o momento em que foi recebido no OKX para efeitos de execução de uma ordem.

Por predefinição, está configurado para 60 segundos. A definição de um valor de Atraso máx. ajuda a garantir que o Bot de sinais opera de forma atempada, evitando agir sobre sinais desatualizados ou potencialmente imprecisos que podem já não refletir as condições atuais do mercado.

6. Especificação de mensagem de alerta - ordem

Tipo de ordem

  • Mercado: Colocar uma ordem de mercado para Abrir (se a ação =ENTRADA_XX) ou Fechar (se a ação = SAÍDA_XX) uma posição. Não é necessário fornecer a Compensação de preço da ordem
  • Limite: Colocar uma ordem com limite para Abrir (se a ação =ENTRADA_XX) ou Fechar (se a ação = SAÍDA_XX) uma posição.

Compensação de preço da ordem (SÓ aplicável com ordem com LIMITE)

  • ENTRADA_LONGA: [1-(Compensação de preço da ordem/100)] * Compra-1
  • ENTRADA_CURTA: [1+(Compensação de preço da ordem/100)] * Venda-1
  • SAÍDA_LONGA: [1+(Compensação de preço da ordem/100)] * Venda-1
  • SAÍDA_CURTA: [1-(Compensação de preço da ordem/100)] * Compra-1

7. Especificação de mensagem de alerta - Tipo de investimento e quantidade

Tipo de investimento e quantidade

(SÓ PARA SINAIS DE ENTRADA)
  • Margem: Margem investida na moeda cotada

  • Contrato: Um número fixo de contratos

  • Saldo_percentual: Com base na % do Saldo Disponível (ou seja, a margem disponível para a abertura de novas ordens)

  • Investimento_percentual: Com base no % de Investimento Ativo no seu bot. O Investimento Ativo será tipicamente a sua margem inicial investida no momento da criação do bot e permanecerá fixo até que adicione mais margem e escolha aumentar esse valor. Por exemplo, se criar um bot com uma margem inicial investida de 1000 USDT, o seu Investimento Ativo será definido como 1000 USDT. Para quaisquer sinais recebidos, este é o valor que será utilizado para os cálculos do tamanho da sua ordem. Digamos que, após alguns dias de execução do seu bot, decida que ele está a ter um bom desempenho e reinveste mais 1000 USDT de margem, adicionando-o ao seu Investimento Ativo. Posteriormente, o seu Investimento Ativo aumentará para 2000 USDT e este será o novo valor utilizado para os cálculos do tamanho da sua ordem. Se não tiver a certeza qual é o valor atual do Investimento Ativo do seu bot, pode sempre verificar isso na secção Detalhes do Bot.

(SÓ PARA SINAIS DE SAÍDA)
  • Posição_percentual: Com base na % de posições abertas

Secção B Exemplos de trabalho

Exemplo 1: Entrada longa -> Saída longa (fecho total) sem entrada múltipla

Exemplo 2: Entrada longa -> Entrada curta (inversão de uma etapa) sem entrada múltipla

Exemplo 3: Entrada longa -> Saída longa (Parcialmente) -> Saída longa (Fecho total)

Exemplo 4: Utilização de entradas múltiplas

Entradas múltiplas é uma funcionalidade do Bot de sinais que permite a execução de múltiplos pontos de entrada para um determinado instrumento. Os traders podem otimizar a sua abordagem de trading diversificando os pontos de entrada (ou seja, investimento pelo preço médio), aumentando potencialmente as hipóteses de capturar transações lucrativas num ambiente de mercado dinâmico.

Exemplo 5: Utilizando apenas o sinal desencadeador (sem campos relacionados com a ordem)

Para os fornecedores de sinais, podem excluir certos parâmetros opcionais, dado que o utilizador já os configurou no bot, o que é particularmente útil para os fornecedores que se concentram em oferecer APENAS sinais desencadeadores de compra/venda, cabendo a cada subscritor decidir quanto investir.

Exemplo 6: Utilizando apenas o sinal desencadeador (sem campos relacionados com a ordem)

Se tanto a configuração do sinal como a do bot não especificarem os detalhes da encomenda, serão utilizados os valores predefinidos.

  • Para os sinais de ENTRADA, por defeito, abrirá X%* do investimento utilizando a ordem de mercado.
  • Para os sinais de SAÍDA, por defeito, fechará 100% das posições abertas ao receber o sinal.

*** X = 100 para um par único. X = 50 para um par múltiplo

Exemplo 7: Precedência da ordem de campo

Os parâmetros do bot têm precedência sobre os parâmetros do sinal. Há duas regras a ter em conta:

  1. Regra 1: Tanto o Bot como o Sinal definem o campo
Para Tipo de ordem
Ordem de mercado (Bot) ✅
Ordem com limite (Sinal) ❌
  1. Regra 2: Um dos Bot/Sinal define o campo
Para Tipo de investimento e quantidade
N/A (Bot) ❌
100% de saldo disponível (Sinal) ✅

Perguntas frequentes

Se tiver alguma questão relacionada com o Bot de sinais, pode rever algumas das perguntas mais frequentes feitas pelos nossos utilizadores neste artigo.