TradingView para KuCoin: automatize alertas em futuros e spot da KuCoin

Com a AlgoVesta, um alerta do TradingView abre uma ordem na sua conta KuCoin em segundos. As posições da KuCoin Futures usam margem cruzada (cross) e recebem ordens stop de stop-loss e take-profit; as compras spot são enviadas pelo valor a gastar e depois protegidas por duas ordens stop. A chave de API precisa das permissões General e Trade e de uma passphrase.

Como funciona

KuCoin Futures na prática

A KuCoin Futures é um produto separado do spot da KuCoin, com tamanhos de contrato próprios. A AlgoVesta define a posição como margem cruzada (cross), converte sua margem e alavancagem em contratos e arredonda para o tamanho mais próximo que a KuCoin aceita, dentro da mesma tolerância de 20% usada em todas as exchanges. O stop-loss e o take-profit vêm em seguida como ordens stop reduce-only e são conferidos na KuCoin.

Se você opera a KuCoin Futures com várias strategies, cada bot mantém seu próprio registro do que abriu; um fechamento de uma strategy não fecha a quantidade aberta por outra.

Compras spot na KuCoin pelo valor

A compra a mercado da KuCoin no spot é confiável quando enviada como um valor a gastar, e não como uma quantidade de moedas; uma compra a mercado baseada em quantidade pode ser aceita e depois não executar nada. Por isso, a AlgoVesta envia as compras spot a mercado pelo valor (custo). O stop-loss e o take-profit passam a ser duas ordens stop sobre as moedas que você recebeu, uma abaixo e outra acima da entrada.

A passphrase

Assim como a OKX e a Bitget, a KuCoin adiciona uma passphrase a cada chave de API. Ela é escolhida na criação da chave e é necessária para assinar cada requisição, por isso a AlgoVesta a pede junto com a key e o secret e a armazena criptografada.

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 KuCoin

Crie a chave na KuCoin com estas permissões: General + 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 KuCoin 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 KuCoin, está na central de ajuda.

Como conectar a KuCoin à 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.