Especificações da mensagem de alerta do bot de sinais de trading 2.0
Í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".
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.
É 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
|
|
|
ação
|
Necessário
|
|
|
Posição no mercado
|
Necessário
|
|
|
Posição anterior no mercado
|
Necessário
|
|
|
instrumento
|
Necessário
|
|
|
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*
|
|
|
quantidade
|
Necessário
|
|
1. Especificação da mensagem de alerta - 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
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
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
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
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
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?
- Consulte a secção Detalhes do seu sinal
- Localize o seu Token de sinais na secção de mensagens de alerta recomendadas
7. 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.
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.
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
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 |
|
| instrumento | Necessário |
|
| 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 |
|
| 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 |
|
| quantidade | Opcional. O parâmetro é obrigatório se o Tipo de ordem = Limite |
|
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:
- Regra 1: Tanto o Bot como o Sinal definem o campo
|
Para Tipo de ordem
|
Ordem de mercado (Bot) ✅
|
Ordem com limite (Sinal) ❌
|
- 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.