Montando um bot

Como montar um bot: escolher o mercado, definir condições com métrica, timeframe e limiar, combiná-las, escolher a direção, evitar sinais repetidos, incluir níveis de saída e gerenciar o bot depois.

Um bot vigia um mercado, definido por um ativo, um tipo de mercado e um símbolo: BTC, Perpétuo, BTCUSDT. O mesmo ativo existe em vários mercados, e cada um é separado, com preço, volume e liquidez próprios. Um futuro com vencimento também é um mercado à parte, e um bot não pode usar um contrato que já foi liquidado.

O tipo de mercado decide quais métricas uma condição pode ler. Funding existe só em perpétuos, open interest e liquidações exigem um derivativo, e basis exige um perpétuo ou um futuro. Uma condição que usa uma métrica que o mercado não tem é recusada ao salvar.

Uma condição também pode ler outro mercado, como a variação do BTC num bot de ETH. Essa condição informa o próprio mercado, e o sinal continua sendo do mercado do bot.

Uma condição tem três partes: uma métrica com o seu timeframe, um operador e um limiar. Os timeframes vão de 1m a 1d. Os operadores são está acima de, está em ou acima de, está abaixo de, está em ou abaixo de, cruza para cima de e cruza para baixo de.

O limiar pode ser um número, um múltiplo da média da própria métrica nas últimas N velas, ou outra métrica. A média faz uma mesma regra servir para o BTC e para uma moeda pequena: volume no dobro da média significa algo nos dois, enquanto um volume fixo em dólares não.

Um bot tem até 10 condições. Os valores dos dois lados de cada condição no momento em que o bot dispara ficam salvos junto com o sinal.

Com várias condições, o bot precisa de uma regra para combiná-las. Com todas, também chamado de AND, toda condição precisa ser verdadeira ao mesmo tempo. Com qualquer, também chamado de OR, basta uma.

Um bot usa uma única escolha para todas as suas condições, porque grupos aninhados ainda não existem. Use todas para estreitar a busca: uma queda, volume alto e RSI baixo juntos. Use qualquer para vigiar várias causas diferentes do mesmo alerta.

A direção diz para que lado o bot espera que o preço vá, para que o desempenho do sinal possa ser medido. Long mede uma alta, Short mede uma queda, e Só alerta envia o sinal com o movimento do mercado depois dele e sem resultado direcional. O Okkana nunca deduz a direção a partir das condições: você escolhe, ou o template escolhe.

O Spot não tem short. Vender a descoberto exige empréstimo, um custo que o Okkana não modela, então um bot de Spot é long, mostrado como Compra, ou só alerta. Para um short, escolha um perpétuo ou um futuro.

A direção também é o padrão ao confirmar uma entrada num sinal, e num bot Só alerta você a escolhe nesse momento.

Duas configurações impedem que um bot se repita. O cooldown é o tempo mínimo entre dois sinais do bot: de 5 minutos a 24 horas, ou nenhum. O reset funciona por evento: depois de disparar, as condições precisam deixar de ser verdadeiras antes de o bot poder disparar de novo.

Digamos que o RSI fique abaixo de 30 por três horas. Com o reset ligado, você recebe um sinal quando ele cai abaixo de 30, e o próximo só depois de ele voltar acima de 30 e cair de novo. Com o reset desligado, só o cooldown limita o bot, e ele dispara outra vez a cada fim de cooldown enquanto a condição continua verdadeira. Todo template vem com o reset ligado.

Um bot pode ter take profit e stop loss opcionais, como variações percentuais a partir do preço de entrada e sem alavancagem, como +3% e -1,5%. O take profit aceita acima de 0% e até 1000%, o stop loss acima de 0% e abaixo de 100%. Eles encerram a posição virtual do sinal, então as estatísticas do bot refletem a regra de saída dele. Sem níveis, a posição fecha no horizonte de 24h. Se uma vela alcançar os dois níveis, vale o stop loss.

Os níveis ficam no bot e nunca numa operação. Um sinal guarda os níveis que o bot tinha quando disparou, e editá-los só afeta os sinais seguintes. Se você confirmar uma entrada, a operação aberta alerta quando o preço chega a um nível medido a partir da sua entrada.

Quando as condições são atendidas e o cooldown e o reset permitem, o bot cria um sinal com o preço de entrada e os valores de cada condição, e envia um alerta em cada canal. O No app está sempre ligado. O Webhook envia o sinal ao seu webhook cadastrado e exige um no seu perfil.

Você não precisa começar de um bot em branco. Os templates são pontos de partida com condições, direção, cooldown e reset já preenchidos: sobrevendido, sobrecomprado, rompimento, pico de volume, expansão de open interest, possíveis squeezes, funding extremo e prêmio do perpétuo. Todo limiar continua editável, e um template não é uma recomendação.

Um bot está ativo, pausado ou como rascunho, e só o bot ativo vigia o mercado. Um bot pausado mantém o histórico, e um rascunho não vigia até você ativá-lo. Duplicar cria uma cópia como rascunho. Excluir para o bot e remove o histórico, sem volta. Cada conta tem um limite de bots, e criar um além dele falha.

Editar um bot afeta só os sinais seguintes: cada sinal guarda a regra que o disparou.