Como configurar um bot de Signal Trading da OKX com o TradingView
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.
Utilize o seguinte link para acessar o guia abrangente que detalha as especificações das mensagens de alerta: Especificações do Alert Message.
Caso encontre alguma dificuldade, consulte o guia com a lista das perguntas mais frequentes em FAQs. Este recurso foi desenvolvido para ajudá-lo a resolver qualquer problema enquanto utiliza o produto.
Índice
- Passo 1: acessar o Signal Bot
- Passo 2: criar o seu Sinal
- Passo 3: configurar os alertas do TradingView
- Passo 3.1: guia dos scripts de estratégia do TradingView
- Passo 3.2: guia dos indicadores/study do TradingView
- Passo 3.3: guia das análises do gráfico
- Passo 3.4: guia de programas de terceiros
- Passo 4: configurar o seu Signal Bot
- Passo 5: monitorar e gerenciar o Signal Bot
- Apêndice A: Script MACD com alertcondition( ) + configuração manual do alerta
- Apêndice B: Exemplo de solicitação de Webhook em Python
- Especificações do Alert Message
- FAQs
Passo 1: acessar 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: criar o seu Sinal
Você encontrará o botão para criar o seu sinal personalizado. Para começar, selecione “Adicionar sinal personalizado”.
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 a 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 do Pine Script™: “Estratégia” vs. “Indicadores”
Tipo do Pine Script™ | Descrição | |
---|---|---|
1. 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 trading para o emulador da corretora 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 utilizando os scripts de estratégia do TradingView com as funções strategy.*() **,prossiga para o Passo 3.1: Começar com as funções strategy.*() do TradingView. |
2. Indicadores do TradingView | Apesar dos indicadores do Pine Script™ também envolverem cálculos, eles não são destinados para os 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 está direcionada para casos de uso mais gerais, abrangendo os usuários que dependem dos indicadores do TradingView, alertas por meio dos gráficos e os fornecedores que utilizam os programas de terceiros. |
Passo 3: configurar os alertas do TradingView
Utilize o seguinte link para acessar o guia abrangente que detalha as especificações das mensagens de alerta: Especificações do Alert Message.
Para começar, abra o TradingView e escolha o par de trading que 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.*()
Passo 1: 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?
Na 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": "********", //enter the signalToken for your signal
"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}}". Principalmente no TradingView, o espaço reservado “{{strategy.order.contracts}}“ corresponde efetivamente ao valor na moeda-base. Essa escolha do “investmentType” como “base” facilita diretamente a compatibilidade. Seguir essas especificações garante que suas ordens na OKX espelhem perfeitamente a sua 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": "********", //enter the signalToken for your signal
"timestamp": "{{timenow}}",
"maxLag": "60",
"investmentType": "base",
"amount": "{{strategy.order.contracts}}"
}
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 simular por meio da configuração de “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.
{
"id": "{{strategy.order.id}}",
"action": "{{strategy.order.action}}",
"marketPosition": "{{strategy.market_position}}",
"prevMarketPosition": "{{strategy.prev_market_position}}",
"instrument": "{{ticker}}",
"signalToken": "********", //enter the signalToken for your signal
"timestamp": "{{timenow}}",
"maxLag": "60",
"investmentType": "base",
"amount": "{{strategy.order.contracts}}"
}
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 esse modelo na seção “Message” do seu alerta do TradingView, junto com o nome do alerta da sua escolha.
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* do URL do Webhook em “Notifications”. Cole o URL do Webhook copiado da OKX no TradingView e clique em “Create”.
*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 “Save” e “Add to chart”
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.
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 3: escolha o URL do Webhook em “Notifications”. Cole o URL do Webhook copiado da OKX no TradingView e clique em “Create”.
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 “Alert” na parte superior da barra de ferramentas e configure sua condição baseada no trading que você geralmente faz (por exemplo, RSI-14 acima de 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, escolha a mensagem apropriada dependendo da lógica do seu trading. **
Passo 2: escolha o URL do Webhook em “Notifications”. Cole o URL do Webhook copiado da OKX no TradingView e clique em “Create”.
Passo 3: Para visualizar o alerta criado, clique na guia “Alerts” e selecione o alerta correspondente.
Passo 3.4【Guia para programas de terceiros】 para provedores de sinal que transmitem mensagens de programas nativos
Para as configurações utilizando Python, como solicitação de exemplo, consulte o Apêndice B: exemplo de solicitação de Webhook em Python.
Esteja ciente de que caso você pretenda enviar uma solicitação de um endereço IP fixo de terceiros para a OKX, você deve entrar em contato com a equipe de atendimento ao cliente ou enviar um e-mail para tradingbot@okx.com informando os motivos relevantes. Isso garantirá que sua solicitação seja gerenciada adequadamente por nossa equipe de processamento dedicada. Sem seguir essas orientações, por padrão, todos os sinais externos serão considerados inválidos.
Passo 4: configurar o 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: monitoramento e gerenciamento do seu Signal Bot recém-criado
Parabéns! Você criou o seu Signal Bot com sucesso. 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.
Analise os dados de desempenho
Rastreie e gerencie as posições abertas
Rastreie o histórico das posições
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.
Rastreie o histórico de sinais
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.
Encontre o botão "Ajustar margem"
Adicionar/Remover a margem
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.
Encontre o botão "Ordem manual
Envie ordens manualmente em ambas as posições
3. Abra e feche as posições instantaneamente
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.
Contra cada registro de posição, existe um botão "Fechar tudo”
Confirme que você deseja fechar
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.
- Acesso aos detalhes do Bot
Acesse a página de detalhes do bot e selecione “Interromper”, no canto superior direto.
- 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 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 PineScript™ a seguir utiliza o indicador técnico MACD como exemplo.
//@versão=5
indicator('MACD Sample Script 1', overlay=true)
// Cálculo de MACD
[macdLine, signalLine, _] = ta.macd(close, 12, 26, 9)
// Define a condição golden cross
goldenCross = ta.crossover(macdLine, signalLine)
// Define a condição death cross
deathCross = ta.crossunder(macdLine, signalLine)
// Utiliza 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 2: exemplo de solicitação de Webhook em 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:%S.%fZ'),
"maxLag":"2000",
"orderType":"market",
"orderPriceOffset":"0.1",
"investmentType":"percentage_balance",
"amount":"100"
}
#enter short demo, using 100% available balance
signaldata_entershort = {
"action":"ENTER_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_balance",
"amount":"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'
# Make a POST request signak enter
response = requests.post(live_trading_url, data=json.dumps(signaldata_enterlong))
# Check the response status code
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.