Como Criar um Bot de Sinal na Freya Finance

#Como Criar um Bot de Sinal na Freya Finance

Um bot de sinal executa operações quando recebe um sinal externo — mais comumente de um alerta do TradingView enviado a um webhook. Em vez de construir a lógica de entrada dentro da Freya (como faz um bot DCA), você traz seus próprios sinais de outra plataforma, e o bot de sinal os transforma em operações reais na sua exchange.

Se você já tem uma estratégia ou configuração de indicador em que confia em outro lugar, um bot de sinal é como você a automatiza na Freya. (Se preferir construir a lógica dentro da Freya, comece pelo Como Criar Seu Primeiro Bot DCA.)

---

#O Que É um Bot de Sinal

Com um bot DCA, você configura as condições de entrada dentro da Freya. Um bot de sinal é o oposto: a decisão de quando entrar ou sair vem de fora — sua plataforma de gráficos, seu próprio script ou qualquer ferramenta capaz de enviar um webhook. Quando esse sinal chega, o bot de sinal coloca a operação. É a ponte entre sua estratégia externa e a execução ao vivo na sua exchange.

#Uma Visão Geral Rápida dos Passos

1. Crie um bot e escolha o tipo Bot de Sinal, depois selecione seu par de trading e direção.
2. Escolha um modo de sinal — Sinal Personalizado, ou Risk Ratio (em que o webhook carrega seu take-profit e stop-loss).
3. Copie sua(s) URL(s) de webhook — o Sinal Personalizado fornece uma URL de abertura e uma de fechamento; o Risk Ratio fornece uma única URL.
4. Conecte sua fonte de sinais — cole essas URLs no seu alerta do TradingView (ou outra ferramenta).
5. Defina suas configurações de ordem e inicie. A partir daí, seus sinais comandam o bot.

#Passo 1: Escolha o Tipo Bot de Sinal

No fluxo de Criar Bot, selecione Bot de Sinal ("Execute operações baseadas em sinais de webhook"), depois escolha seu par de trading e direção como em qualquer outro bot.

#Passo 2: Escolha um Modo de Sinal

O Modo de Sinal controla como seu bot interpreta os sinais que recebe. Há dois modos, e você escolhe um — eles não podem ser combinados:

• Sinal Personalizado — seu bot age sobre os sinais de abertura e fechamento que você envia via webhook (por exemplo, de um alerta do TradingView), e você configura as ordens na Freya: o valor a operar e seu take-profit e stop-loss.
• Risk Ratio — o payload do webhook carrega os preços de take-profit e stop-loss; a entrada é feita ao preço de mercado quando o sinal dispara. Em vez de escolher um valor de operação, você define um valor de risco fixo por operação, e a Freya calcula automaticamente o tamanho da posição a partir da distância entre a entrada e o stop-loss. O resultado: se o stop-loss for atingido, você perde aproximadamente o valor exato de risco que escolheu. O take-profit é colocado como uma ordem limit no preço do webhook (assim ela é executada sem slippage); o stop-loss é executado como uma ordem a mercado quando acionado, então — como qualquer stop — pode sofrer slippage em um movimento rápido.

Escolha o modo que combina com a forma como seus sinais são construídos.

#Por Que o Modo Risk Ratio É Poderoso

O modo Risk Ratio vira o dimensionamento de posição de cabeça para baixo. Normalmente você escolhe um tamanho de posição e aceita qualquer perda que o stop-loss implique. No modo Risk Ratio você escolhe a perda que está disposto a assumir, e o tamanho da posição é dimensionado para ela automaticamente. Isso torna seu risco por operação consistente, independentemente de quão distante esteja o stop-loss — uma abordagem disciplinada que profissionais usam. Você define o tipo de risco e o valor fixo na etapa de estratégia; o valor da operação então aparece como dinâmico, porque é calculado quando o webhook chega.

#Passo 3: Obtenha Suas URLs de Webhook

Quais URLs você recebe depende do seu modo:

• No modo Sinal Personalizado, seu bot recebe uma URL de Webhook de Abertura (acioná-la abre uma posição) e uma URL de Webhook de Fechamento separada (acioná-la fecha a posição).
• No modo Risk Ratio, você recebe uma única URL de webhook para o sinal de entrada. A posição é então fechada automaticamente pelo take-profit e stop-loss carregados no webhook, então não há URL de fechamento separada. O sinal é enviado como uma pequena mensagem JSON que inclui os valores de take-profit e stop-loss.

Você pode copiar uma URL e regenerá-la sempre que quiser. Regenerar cria uma URL nova e invalida imediatamente a antiga — útil caso uma URL tenha sido exposta.

#Passo 4: Conecte Sua Fonte de Sinais

Cole sua(s) URL(s) de webhook na sua fonte de sinais. No TradingView, por exemplo, você cria um alerta e define a URL de webhook dele como a URL do seu bot. No modo Sinal Personalizado você usa a URL de abertura para entradas e a URL de fechamento para saídas; no modo Risk Ratio você usa o único webhook e inclui seu take-profit e stop-loss na mensagem do alerta. Quando a condição do seu alerta dispara, o TradingView aciona o webhook e seu bot age sobre ele.

#Passo 5: Defina Suas Configurações de Ordem

Configure como o bot dimensiona e coloca suas ordens. No modo Sinal Personalizado, você define o valor da operação e seu take-profit e stop-loss. No modo Risk Ratio, você define em vez disso seu valor de risco fixo (o valor da operação torna-se dinâmico, e o take-profit e stop-loss vêm do webhook). Depois inicie o bot — ele fica em silêncio até um sinal chegar, e então executa.

#Mantendo Seus Webhooks Seguros

Este é o hábito mais importante com bots de sinal: suas URLs de webhook são segredos. Qualquer pessoa que tenha uma URL pode acionar aquela ação no seu bot, então:

• Nunca compartilhe ou publique suas URLs de webhook publicamente.
• Cole-as apenas em ferramentas confiáveis como seus próprios alertas do TradingView.
• Regenere imediatamente se suspeitar que uma URL foi exposta — a antiga para de funcionar na hora.

#Perguntas Frequentes

#O que é um bot de sinal na Freya Finance?

Um bot de sinal executa operações com base em sinais externos enviados a um webhook — por exemplo, um alerta do TradingView. Em vez de decidir quando operar dentro da Freya, ele espera pelo seu sinal e então abre ou fecha uma posição na sua exchange. É ideal se você já gera sinais em outra plataforma.

#Como conecto o TradingView ao meu bot de sinal?

Escolha o modo Sinal Personalizado, copie as URLs de webhook de abertura e fechamento do seu bot e cole-as nos seus alertas do TradingView (a URL de abertura para entradas, a de fechamento para saídas). No modo Risk Ratio você usa em vez disso uma única URL de webhook e inclui o take-profit e stop-loss na mensagem do alerta. Quando um alerta dispara, o TradingView aciona o webhook e seu bot opera.

#Qual é a diferença entre o modo Sinal Personalizado e o modo Risk Ratio?

No modo Sinal Personalizado, o bot age sobre os sinais de abertura e fechamento que você envia via webhook, e você configura as ordens por conta própria — o valor da operação e seu take-profit e stop-loss. No modo Risk Ratio, o payload do webhook carrega os preços de take-profit e stop-loss (a entrada é feita a mercado quando o sinal dispara), e em vez de um valor de operação você define um valor de risco fixo — a Freya então dimensiona a posição automaticamente a partir da distância entre a entrada e o stop-loss, de modo que um stop-out custa a você aproximadamente o risco exato que escolheu. Os dois modos não podem ser combinados; escolha aquele que combina com a forma como seus sinais são construídos.

#Como funciona o dimensionamento de posição no modo Risk Ratio?

Você define um valor de risco fixo por operação. Quando o sinal dispara, a Freya faz a entrada ao preço de mercado e lê o stop-loss do webhook, depois calcula o tamanho da posição para que a perda no stop-loss seja igual ao risco que você escolheu. Isso mantém seu risco por operação consistente, não importa quão largo ou apertado seja o stop — você decide a perda que está disposto a assumir, e o tamanho segue.

#Minhas URLs de webhook são secretas?

Sim — trate-as como senhas. Qualquer pessoa que tenha uma URL de webhook poderia acionar aquela ação no seu bot. Nunca as compartilhe, cole-as apenas em ferramentas confiáveis e regenere uma URL imediatamente se achar que ela foi exposta. Regenerar invalida a URL antiga na hora.

#Enviei um sinal mas nada aconteceu — por quê?

Verifique se você usou a URL de webhook correta (abertura vs fechamento), se seu modo de sinal corresponde à forma como seu alerta está configurado e se o bot está em execução e não pausado. Se você regenerou uma URL recentemente, certifique-se de que sua fonte de sinais está usando a nova. Para status geral do bot, veja Por Que Meu Bot Não Está Operando?.

#O webhook pode definir meu take-profit e stop-loss?

Sim, se você usar o modo Risk Ratio. Nesse modo os valores de take-profit e stop-loss vêm do payload do webhook em vez de serem inseridos manualmente na Freya, o que permite que sua estratégia externa controle as saídas.