Como configurar um bot de Signal Trading da OKX com o TradingView

Publicado em 30 de ago. de 2023Atualizado em 28 de jan. de 2025Leitura de 28min

Com o lançamento dos Signal Bots, agora os usuários do TradingView e os fornecedores de sinais podem publicar e configurar um Signal Bot com os sinais do TradingView. Siga o guia passo a passo para começar a fazer trading com os sinais na OKX.

Consulte a seção Especificações de mensagens de alerta para acessar um guia abrangente detalhando as especificações para mensagens de alerta.

Caso encontre alguma dificuldade, consulte o guia com a lista das perguntas mais frequentes na seção Perguntas frequentes. Este recurso foi desenvolvido para ajudá-lo a resolver quaisquer problemas que possa encontrar ao usar o produto.

Passo 1: acesse o Signal Bot

Faça o login na sua conta da OKX, acesse Negociar -> Bots de trading -> Mercado.

Em seguida, clique na guia Signal Bot e selecione Criar.

Passo 2: crie um sinal

Você encontrará o botão para criar o seu sinal personalizado. Selecione "Adicionar sinal personalizado" para começar.

Simplificamos a experiência para ajudar os nossos usuários a configurar seus sinais do TradingView rapidamente. No passo 1, nomeie o seu sinal e insira uma descrição opcional (até 500 caracteres). Selecione “Criar sinal” para seguir para o próximo passo.

Depois de selecionar “Criar”, você visualizará a próxima página que irá solicitar o URL do Webhook e as Especificações do AlertMsg que são geradas automaticamente pela OKX. Em seguida, você irá configurar as notificações de sinais no TradingView. Considere os dois métodos diferentes para configurar os alertas:

"TradingView": Voltado para os usuários que utilizam os scripts de estratégia do TradingView, especialmente os que utilizam as funções strategy.*() para transmissão de sinal.
"Personalizado": Desenvolvido para atender a uma ampla gama de usuários, incluindo aqueles que utilizam os indicadores do TradingView, alertas por meio dos gráficos, bem como os fornecedores que utilizam programas de terceiros.

Uma visão geral expressa do Pine Script: "Estratégia" vs. "Indicador"

Estratégia do TradingView
As estratégias do Pine Script têm o propósito de realizar backtesting em dados históricos, bem como testes futuros em mercados em tempo real. Além de realizar cálculos de indicadores, as estratégias incluem chamadas para funções strategy.*() que transmitem ordens de negociação para o emulador de corretor do Pine Script. Esse emulador pode simular a execução dessas ordens. Os resultados dos backtests podem ser visualizados na guia “Strategy Tester” localizada na parte inferior do gráfico ao lado da guia “Pine Script Editor”.
Se você estiver usando scripts de estratégia do TradingView com as funções strategy.*() **, prossiga diretamente para o Passo 3.1: Funções strategy.*() do TradingView para começar.
Indicador TradingView
Por outro lado, os indicadores Pine Script também envolvem cálculos, mas não se destinam ao uso em cenários de backtesting. Devido a sua independência do emulador da corretora, os indicadores consomem menos recursos e executam com mais rapidez. Como alternativa, eles são conhecidos como scripts de study, e não como indicadores, no PineScript v4.
Para os usuários que estão utilizando os indicadores/scripts de study e programas de terceiros, podem pular para o Passo 3.2, Passo 3.3 e Passo 3.4 com base no seu caso de uso específico. Esta seção é adaptada para casos de uso mais gerais, abrangendo usuários que dependem de indicadores do TradingView, alertas por meio de moeda digital emitida por banco central e provedores que utilizam programas de terceiros.

Passo 3: configure alertas do TradingView

Consulte a seção Especificações de mensagens de alerta para acessar um guia abrangente detalhando as especificações para mensagens de alerta.

Para começar, abra o TradingView e escolha o par de trading com o qual deseja trabalhar. (Certifique-se de que você está selecionado o contrato de swap perpétuo apropriado.)

Você pode acessar a lista completa dos swaps perpétuos aceitos na OKX por meio da lista de seleção de pares disponível na página Negociar.

Passo 3.1【Guia dos scripts de estratégia do TradingView】：para os criadores de estratégia do Pinescript que utilizam as funções strategy.*() Funções

configure a sua estratégia no Pine Editor e clique em “Save” e “Add to chart”. Como alternativa, você pode adicionar uma estratégia existente ao seu gráfico.

Passo 2: selecione o ícone de engrenagem associado à estratégia que você adicionou ao seu gráfico. Ajuste as propriedades da estratégia, como o tamanho da ordem, de acordo com suas preferências. Clique em “Ok” para finalizar as configurações.

Como faço para alinhar as configurações da minha ordem de estratégia do TradingView com a OKX?

Em sua estratégia do TradingView, você tem três opções para configurar os parâmetros da ordem: Você pode definir o “tamanho da ordem” em termos de USDT, número de contratos ou como porcentagem do patrimônio baseado no seu capital inicial. Embora todas essas abordagens possam ser adaptadas para uso na OKX, é essencial entender como cada método funciona no TradingView e como são espelhados na plataforma da OKX. Confira esse resumo geral dos diferentes cenários para guiá-lo por esse processo.

1. Tamanho da ordem: USDT

Essa abordagem é direta e fácil de usar. Você informa diretamente o tamanho da ordem em termos absolutos utilizando sua moeda de cotação, o USDT. Ao realizar o backtesting do TradingView, esse valor servirá como base para todos os envios de ordem.

Para garantir a compatibilidade com a OKX, lembre-se de definir o seu “investmentType” para “base” e configurar o “amount” como "{{strategy.order.contracts}}". Ao seguir essas especificações, sua ordem na OKX será alinhada de forma precisa com a estratégia pretendida do TradingView.

{ "id": "{{strategy.order.id}}", "action": "{{strategy.order.action}}", "marketPosition": "{{strategy.market_position}}", "prevMarketPosition": "{{strategy.prev_market_position}}", "instrument": "{{ticker}}", "signalToken": "********", //insira o signalToken para o seu sinal "timestamp": "{{timenow}}", "maxLag": "60", "investmentType": "base", "amount": "{{strategy.order.contracts}}" }

2. Tamanho da ordem: Contratos

Uma distinção fundamental para ser reconhecida é que o conceito de "contracts" é definido de forma diferente no TradingView e na OKX. No TradingView, um contrato representa uma única unidade de swap perpétuo no preço vigente (equivalente a uma unidade da moeda-base, ou seja, um contrato perpétuo de BTCUSDT equivale à compra de 1 BTC). Já na OKX, os “tamanhos do contrato” são exclusivos para cada contrato de swap perpétuo (por exemplo, um contrato perpétuo de BTCUSDT equivale à compra de 0,01 BTC). Informações detalhadas sobre os tamanhos de contrato da OKX estão disponíveis aqui: https://www.okx.com/trade-market/info/swap.

Para garantir a compatibilidade com a OKX, é importante definir o seu “investmentType” como “base” e configurar o “amount” para "{{strategy.order.contracts}}". Notavelmente, no TradingView, o espaço reservado "{{strategy.order.contracts}}" corresponde efetivamente ao valor na moeda-base. Esta escolha de " tipoDeInvestimento" como " base" facilita a compatibilidade direta. Aderir a essas especificações garante que suas ordens na OKX espelhem perfeitamente sua estratégia pretendida do TradingView.

3. Tamanho da ordem: % do patrimônio

Ao utilizar a % do patrimônio, é importante compreender que o seu patrimônio começa com o valor que você especificou como sendo o seu capital inicial. Em seguida, o seu patrimônio é definido e analisado por meio do backtesting do TradingView.

Embora seja possível emular isso configurando "investmentType" como "base" e "amount" como "{{strategy.order.contracts}}" (conforme ilustrado abaixo), é essencial ter em mente que os valores derivados deste método são influenciados fortemente pelos cálculos de backtesting. Em um cenário do mundo real, podem ocorrer discrepâncias entre o backtesting e o trading em tempo real, uma vez que o backtesting foi desenvolvido para estimativas aproximadas em vez da execução precisa da ordem. Portanto, é aconselhável definir as configurações do tamanho da ordem em USDT ou nos termos do contrato no TradingView.

Passo 3: clique em “Alert” na parte superior da barra de ferramentas e altere “Condition” para o script que foi adicionado ao gráfico com “Order fills only”. Por conveniência, a validade também pode ser selecionada como “Open-ended alert”.

Passo 4: recupere o modelo de mensagem de alerta da guia do TradingView dentro das Especificações do Alert Message da OKX no seu Signal da OKX. Em seguida, cole este modelo no " Mensagem" do seu alerta do TradingView, juntamente com um nome de alerta correspondente do seu preço chase.

Fique à vontade caso deseje fazer alguma modificação no modelo recomendado para a sua mensagem de alerta, garanta que as alterações estejam de acordo com as nossas Especificações do Alert Message fornecidas aqui.

Passo 5: escolha a seção URL do webhook* em "Notificações". Cole o URL do webhook copiado da OKX para o TradingView e clique em "Criar".
*Você precisará de uma assinatura paga do TradingView para acessar esse recurso

Passo 3.2【Guia de Indicadores/Study do TradingView】 para criadores de indicadores/script de study do Pinescript

Passo 1: configure o script no Pine Editor e clique em "Salvar" e "Adicionar ao gráfico".

Passo 2: clique em “Alert” na parte superior da barra de ferramentas e altere “Condition” para o script que foi adicionado ao gráfico com o AlertCondition correspondente. Nesse caso, o MACD Golden Cross é utilizado junto com o modelo de mensagem ENTER_LONG. Por conveniência, a validade também pode ser selecionada como “Open-ended alert”.

Por último, recupere o modelo de mensagem de alerta da guia Personalizado dentro das Especificações do Alert Message da OKX no seu Signal da OKX. Em seguida, cole esse modelo na seção “Message” do seu alerta do TradingView, junto com o nome do alerta da sua escolha.

*IMPORTANTE: a OKX forneceu 4 conteúdos de mensagens diferentes com ações diferentes (ou seja, ENTER_LONG, EXIT_LONG, ENTER_SHORT, EXIT_SHORT). Ao configurar o alerta, escolha o preço apropriado dependendo da sua lógica de trading.

Passo 3: escolha a URL do webhook* em "Notificações". Cole o URL do webhook copiado da OKX para o TradingView e clique em "Criar".

Passo 3.3【Guia de análises do gráfico】 para usuários que utilizam a análise do gráfico e/ou linhas de indicadores básicos

Passo 1: clique no botão "Alerta" na barra de ferramentas superior e defina sua condição com base no que você normalmente negocia (por exemplo, RSI-14 cruzando 30)

Em seguida, cole as Especificações do AlertMsg da OKX em “Message”. Saiba mais sobre as Especificações do AlertMsg da OKX aqui.

*IMPORTANTE: aceitamos quatro tipos de mensagens diferentes com ações distintas (ou seja, ENTER_LONG, EXIT_LONG, ENTER_SHORT, EXIT_SHORT). Ao configurar o alerta, por favor preço persiga o apropriado, dependendo da lógica de negociação seu/sua.

Passo 2: escolha a URL do webhook* em "Notificações". Cole o URL do webhook copiado da OKX para o TradingView e clique em "Criar".

Passo 3: para visualizar o alerta criado, clique na aba "Alertas" e selecione o alerta correspondente.

Passo 3.4【Guia para programas de terceiros】 para provedores de sinal que transmitem mensagens de programas nativos

Para configuração usando Python como uma solicitação de exemplo, consulte o Apêndice B: Exemplo de solicitação de webhook do Python.

Esteja ciente de que, se você pretende enviar uma solicitação de um endereço IP fixo de terceiros para a OKX, entre em contato com nossa equipe de atendimento ao cliente com o motivo relevante. Isso garantirá que sua solicitação seja gerenciada adequadamente por nossa equipe de processamento dedicada. Sem seguir este canal, todos os sinais externos serão considerados inválidos por padrão.

Passo 4: configure seu Signal Bot

Agora que você publicou o seu sinal na OKX com sucesso, está na hora de conectá-lo ao Signal Bot! Para começar, clique em “Criar Bot”, você será direcionado para a página de criação do Signal Bot.

Para começar, você precisará fornecer as configurações mínimas necessárias para o seu bot. Essas configurações incluem os pares de trading, proporção de alavancagem e o valor dos fundos (margem) que deseja investir.

Escolher os pares de trading certos é essencial para que o seu bot identifique as oportunidades adequadas: basta especificar os pares de trading que se alinham com sua estratégia de negociação. Em seguida, determine a proporção de alavancagem que você gostaria de aplicar aos seus trades. A utilização da alavancagem pode ampliar seus rendimentos potenciais, mas apresenta riscos maiores. Certifique-se de escolher uma proporção que se alinha com sua tolerância ao risco e seus objetivos de trading. Depois de definir seus pares de trading e a proporção de alavancagem, é hora de decidir o valor dos fundos que você está disposto a investir no bot.

Além das configurações básicas, o bot oferece opções avançadas de personalização para ajustar ainda mais suas preferências de trading.

Por exemplo, você pode escolher entre tipos de ordem diferentes, como ordens a mercado ou limitada. As ordens a mercado são executadas imediatamente ao preço de mercado atual, enquanto as ordens limitadas permitem que você defina níveis de preços específicos nos quais suas ordens devem ser executadas.

Além disso, as configurações de entrada permitem que você defina o valor do investimento por ordem, o que determina a parcela dos seus fundos alocada para cada trade. A parcela dos fundos alocada para cada trade pode ser personalizada e escolhida em termos absolutos (por exemplo, 1000 USDT) ou em termos percentuais (por exemplo, 10% do saldo disponível), proporcionando flexibilidade para determinar o tamanho das suas posições. Ajustar esta configuração permite que você gerencie o risco e controle o tamanho das posições de acordo com sua estratégia de trading.

Além disso, você pode definir os níveis de Take-Profit (TP) e Stop-Loss (SL) como parte das configurações de saída. O Take-Profit estabelece o nível de preço no qual seu bot fechará, automaticamente, um trade para garantir os lucros, enquanto o Stop-Loss define o nível de preço no qual seu bot sairá de um trade para limitar perdas potenciais.

Para cada uma dessas configurações avançadas (exceto TP e SL), você tem a flexibilidade de defini-las diretamente no nível do bot ou depender das mensagens de alerta do TradingView para receber esses parâmetros. Essa capacidade de adaptação permite que você escolha o melhor método para o seu estilo de trading e fluxo de trabalho.

Depois de preencher os parâmetros do bot, selecione “Confirmar” para finalizar a criação do seu Signal Bot.

Passo 5: monitore e gerencie o seu Signal Bot recém-criado

Parabéns! Você criou com sucesso seu Signal Bot. Agora, essa ferramenta poderosa receberá os sinais da fonte selecionada e executará seus trades instantaneamente em tempo real, levando a sua experiência de trading para o próximo nível.

Você tem controle e visibilidade total sobre o seu Signal Bot. Você pode monitorar seu desempenho e acessar informações detalhadas a qualquer momento, basta visualizar seus ‘Detalhes’ ao clicar no ícone conforme mostrado abaixo.

Essa visualização abrangente permite que você acompanhe o histórico de desempenho, revise a lista de posições em andamento, monitore as ordens abertas, explore suas posições, histórico de sinais e muito mais.

Você também pode revisar os registros do seu histórico de sinais e ações de processamento correspondentes. Esse recurso valioso permite analisar sucessos e fracassos, permitindo que você aprimore sua abordagem e tome decisões conscientes para futuros trades.

Além disso, você tem flexibilidade para intervir manualmente sempre que necessário. Por exemplo, você pode ajustar a margem alocada no bot, enviar ordens manuais por motivos específicos, controlar suas posições em andamento e fechar ou reduzir manualmente suas posições abertas. Esse nível de controle permite que você ajuste sua estratégia de trading com base nas condições de mercado em tempo real e em sua própria análise.

1. Ajustar (Adicionar/Remover) a margem do bot

Na seção Detalhes do bot, você pode adicionar ou remover a margem do seu bot facilmente, conforme necessário. Isso permite que você insira fundos adicionais no bot quando desejar ou reserve uma parte dos fundos após obter um retorno sobre o investimento (ROI) significativo.

2. Enviar ordens manualmente

Você tem a liberdade de enviar ordens manualmente no seu bot, independentemente dos sinais recebidos. Esse recurso permite que você adicione ordens manualmente para qualquer par de trading de acordo com seus requisitos específicos. A janela pop-up intuitiva permite que você defina as configurações da sua ordem, incluindo o tipo da ordem, o valor e a direção. Você pode utilizar essa função para iniciar uma nova posição, aumentar uma posição existente ou até mesmo reduzir ou fechar totalmente uma posição aberta. Isso lhe concede controle amplo sobre o gerenciamento das posições ativas, permitindo que você faça ajustes sempre que necessário.

3. Fechar instantaneamente as posições abertas

Além disso, você tem a conveniência de visualizar suas posições abertas e de fechar diretamente qualquer posição aberta existente em um par de trading específico com um simples clique de um botão. Ao fazer isso, você pode fechar totalmente suas posições nesse par no preço de mercado vigente. Ao clicar no botão Fechar, uma confirmação aparecerá garantindo a exatidão da informação antes de finalizar a ação. É tão fácil quanto parece - clique para confirmar e pronto.

4. Interromper o seu Signal Bot

Quando você interrompe esse bot, o sistema fechará todas as posições abertas e cancelará todas as ordens pendentes nesse bot. Quaisquer ativos restantes destas ordens serão devolvidos a sua conta de trading. Existem dois métodos que você pode utilizar para encerrar o seu Signal Bot.

1. Acesso aos detalhes do Bot

Acesse a página de detalhes do bot e selecione “Interromper”, no canto superior direto.

2. Acesso à guia das ordens do Bot

Acesse a guia ordens do bot na página Negociação, localizada na parte inferior da página.

Parabéns por configurar seu Signal Bot com os sinais do TradingView com sucesso! Essa conquista representa um marco importante na otimização das suas estratégias de trading e tem o potencial de aumentar sua rentabilidade. Aproveite essa oportunidade para navegar no mercado de criptomoedas com confiança e explorar todo o seu potencial de trading. Desejamos que você tenha muito sucesso na sua jornada de trading. Gostaria de aprender sobre o Signal Trading? Clique aqui para saber mais.

Apêndice

A. Caso de exemplo 1: Script MACD com alertcondition( ) + Configuração manual do alerta

Para criar um alerta, você precisa definir a condição que irá acioná-lo. Essa condição pode ser baseada em vários fatores, como preço, indicadores ou lógica personalizada. O seguinte PineScript usa o indicador técnico MACD como exemplo.
//@version=5 indicator('MACD Sample Script 1', overlay=true)

Calcular MACD [macdLine, signalLine, _] = ta.macd(close, 12, 26, 9)

// Definir a condição da cruz dourada goldenCross = ta.crossover(macdLine, signalLine)

// Definir a condição da cruz da morte deathCross = ta.crossunder(macdLine, signalLine)

// Usar a função alertcondition para gerar alertas alertcondition(condition=goldenCross, title="MACD Golden Cross", message="") alertcondition(condition=deathCross, title="MACD Death Cross", message="")

Neste exemplo, primeiro calculamos o MACD usando a função `macd`, que utiliza as séries de entrada (neste caso, os preços de fechamento) e os parâmetros de MACD (12, 26, 9). Definimos então as condições para o golden cross e death cross usando as funções `crossover` e `crossunder`, respectivamente. O golden cross ocorre quando a linha MACD cruza acima da linha do sinal, enquanto o death cross ocorre quando a linha MACD cruza abaixo da linha do sinal.

Em relação à configuração manual dos alertas, este processo é elaborado mais detalhadamente na seção 3 (Método B). No entanto, para uma visão geral rápida, você deve iniciar a configuração clicando no botão “Alert” no TradingView. A partir daí, você selecionará seu indicador junto com a condição relevante. A próxima etapa envolve copiar e colar a mensagem de alerta apropriada e o URL do Webhook do seu sinal na OKX.

B. Caso de exemplo 2: exemplo de solicitação de Webhook em Python

``` python

import datetime import time import requests import datetime import json import log

symbol = 'BTC-USDT-SWAP'

# enter long demo, using 100% available balance signaldata_enterlong = { "action":"ENTER_LONG", "instrument":symbol, "signalToken":"your signaltoken", "timestamp":datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:% " maxLag":" 2000", " orderType":" mercado", " orderPriceOffset":" 0,1", " tipoDeInvestimento":" percentage_balance", " altcoin":" 100" } # APR aumentado posição vendida demo, using 100% disponível signaldata_entershort = { " ação":" APR aumentado", " usuário pessoa jurídica":símbolo, " signalToken":" seu/sua signaltoken", " timestamp":d atetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%fZ'), " maxLag":" 2000", " orderType":" mercado", " orderPriceOffset":" 0,1", " tipoDeInvestimento":" percentage_balance", " altcoin":" 100" }

# exit short demo, closing 100% open position signaldata_exitshort = { "action":"EXIT_SHORT", "instrument":symbol, "signalToken":"your signaltoken", "timestamp":datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%S.%fZ'), "maxLag":"2000", "orderType":"market", "orderPriceOffset":"0.1", "investmentType":"percentage_position", "amount":"100" } # exit long demo, closing 100% open postion signaldata_exitlong = { "action":"EXIT_LONG", "instrument":symbol, "signalToken":"your signaltoken", "timestamp":datetime.datetime.utcnow().strftime('%Y-%m-%dT%H:%M:%S.%fZ'), "maxLag":"2000", "orderType":"market", "orderPriceOffset":"0.1", "investmentType":"percentage_position", "amount":"100" }

demo_trading_url = 'https://www.okx.com/pap/algo/signal/trigger' live_trading_url = 'https://www.okx.com/algo/signal/trigger'

# Faça um sinal de solicitação POST enter response = requests.post(live_trading_url, data=json.dumps(signaldata_enterlong))

# Verifique o código de status da resposta if response.status_code == 200: log.info('trigger signal successful') else: log.info('trigger sitgnal failed') ```

C. Exemplo de scripts do TradingView na OKX

[Script de estratégia do TradingView para iniciantes] estratégia RSI: https://www.tradingview.com/script/3Is1tjRU-OKX-Signal-Bot-Beginner-s-Guide-RSI-Strategy/
[Script de indicadores do TradingView avançado] regras do Turtle Trading: https://www.tradingview.com/script/UUKKgHCB-OKX-Signal-Bot-Turtle-Trading-Rules/

Especificações do Alert Message

Para saber mais sobre as Especificações do Alert Message da OKX, confira este artigo.

Perguntas frequentes

Caso tenha dúvidas sobre as estratégias de sinais, confira as perguntas mais frequentes dos nossos usuários neste artigo.