TradingView para OKX: execute alertas em swaps e spot da OKX

A AlgoVesta transforma cada alerta do TradingView em uma ordem na sua conta OKX por meio de uma chave de API somente para negociação, com passphrase. Os swaps perpétuos recebem ordens algo de stop-loss e take-profit; as ordens spot saem em modo cash, de modo que uma compra nunca toma empréstimo, e levam uma ordem OCO com os dois níveis. Os fundos permanecem na sua conta OKX.

Como funciona

Modo cash no spot da OKX e por que isso importa

As contas da OKX podem negociar spot em modo cash ou em modos de margem. Uma biblioteca genérica comum muda discretamente as ordens spot para margem cruzada (cross), o que pode deixar o trader com um saldo emprestado que ele nunca pediu. A AlgoVesta, em vez disso, envia as ordens spot da OKX pela própria API da OKX em modo cash, de modo que uma compra spot só gasta o que você tem.

A proteção no spot da OKX é uma única ordem algo OCO que guarda o stop-loss e o take-profit juntos; quando um dispara, o outro é retirado. Nos swaps perpétuos, os níveis são ordens condicionais reduce-only. Nos dois casos, a AlgoVesta as lê de volta na OKX, e a OKX informa essas ordens na sua lista de ordens algo, e não nas ordens abertas normais, que é onde a verificação procura.

O que a passphrase muda

A OKX é uma das três exchanges deste grupo, junto com KuCoin e Bitget, que adicionam uma passphrase a cada chave de API. Ela é definida por você quando a chave é criada e não pode ser recuperada depois, então, se for perdida, a chave precisa ser recriada. A AlgoVesta a armazena criptografada junto com o secret e a usa apenas para assinar requisições.

Dimensionamento em swaps

Nos swaps, a OKX negocia em contratos. A AlgoVesta converte a margem e a alavancagem do seu alerta em uma quantidade de contratos e escolhe o tamanho mais próximo que a OKX aceita; se ele ficar a mais de 20% do seu valor, nada é aberto e o cartão do bot mostra o que funcionaria.

A mensagem do alerta

Cole isto na caixa de mensagem do alerta. Os dois valores de plot vêm do seu indicador; a alavancagem é ignorada no spot.

{
  "symbol": "{{ticker}}",
  "action": "buy",
  "price": "{{close}}",
  "stop_loss": "{{plot_0}}",
  "take_profit": "{{plot_1}}",
  "leverage": 10
}

Para uma strategy em Pine, use o modelo de strategy para que saídas e reversões funcionem. Não envie apenas {{strategy.order.action}}: em uma saída ele vale "sell" e abriria uma posição vendida em vez de fechar. Os campos market_position informam à AlgoVesta quando a strategy está zerada.

{
  "symbol": "{{ticker}}",
  "action": "{{strategy.order.action}}",
  "market_position": "{{strategy.market_position}}",
  "prev_market_position": "{{strategy.prev_market_position}}",
  "position_size": "{{strategy.position_size}}",
  "price": "{{close}}"
}

O TradingView só mostra a caixa Webhook URL quando a autenticação de dois fatores está ativada na sua conta do TradingView. O TradingView não consegue enviar cabeçalhos personalizados, por isso a AlgoVesta verifica a origem pelos endereços de servidor do próprio TradingView e só executa automaticamente alertas que consegue verificar.

Conecte sua chave de API da OKX

Crie a chave na OKX com estas permissões: Trade. Saque e transferência permanecem desativados, porque a AlgoVesta nunca precisa deles: ela pode abrir e fechar ordens, mas não pode tirar fundos da sua conta. As chaves da OKX também têm uma passphrase que você escolhe ao criar a chave. Informe-a na AlgoVesta junto com a key e o secret; ela é criptografada da mesma forma.

Se você restringir a chave a endereços IP, o assistente de conexão da AlgoVesta mostra os dois endereços de servidor a adicionar. O guia completo, passo a passo, com a aparência de cada tela da OKX, está na central de ajuda.

Como conectar a OKX à AlgoVesta →

Regras que valem para toda ordem

• Um stop-loss em toda ordem: vindo do sinal ou do seu próprio percentual ou distância. Sem origem de stop-loss, sem ordem.
• Um limite de perda diária que pausa novas entradas até o próximo dia UTC.
• Máximo de posições abertas e máximo de operações por dia por bot.
• Um botão de pânico que fecha o que a AlgoVesta abriu e não mexe nas suas próprias posições.

Nas exchanges de cripto, uma ordem abre em cerca de 4,1 segundos em média, desde a chegada do sinal até uma ordem executada com a proteção anexada, medido nas execuções da própria AlgoVesta.