Instale o Hummingbot
Esta é a primeira parte do guia rápido de inicialização do Hummingbot:
Requisitos de sistema
Se você estiver instalando o Hummingbot nonseu computador ou em um servidor em nuvem, aqui estão os requisitos mínimos de sistema recomendados:
Sistema operacional
- Linux: Ubuntu 16.04 ou superior
- MacOS: macOS 10.12.6 (Sierra) ou superior
- Windows: Windows 10 ou superior
Memória
1 GB de RAM por instância + 250 MB por instância adicional
Armazenar
- Instale usando Docker: 5 GB por instância
- Instale da fonte: 3 GB por instância
- Instalador para download: 3 GB por instância
Rede
Uma conexão estável com a Internet é necessária para manter o Hummingbot conectado às centrais quando um bot está em execução.
Dica: se você estiver executando o Hummingbot em seu computador, certifique-se de desligar todos os recursos de suspensão ou economia de energia que podem encerrar sua conexão de rede.
Chaves API
Para autorizar o Hummingbot a negociar seus ativos, você precisará inserir as chaves API de exchanges habilitadas para negociação durante o processo de configuração do Hummingbot. Separadamente, se desejar participar da mineração de liquidez, você precisará fornecer chaves de API somente leitura no Miner App
Para encontrar mais informações sobre como obter as chaves de API para cada exchange, consulte as páginas das exchanges em Conectores.
Métodos de instalação
Para novos usuários: Recomendamos que você baixe o instalador (veja abaixo). Isso permite que você experimente o Hummingbot em apenas alguns minutos.
Para traders e desenvolvedores experientes: Recomendamos que você instale a versão Docker em uma instância de nuvem para maximizar o desempenho e a confiabilidade. Ver Instalação no manual do usuário.
Janelas
Baixe o instalador do Windows em nossa página de Downloads e clique para iniciar o processo de instalação.
Assista a este vídeo que mostra como concluir o processo de instalação:
Para obter mais assistência, consulte este guia na documentação do Hummingbot.
Mac OS
Baixe o instalador do macOS em nossa página de Downloads e clique para iniciar o processo de instalação.
Assista a este vídeo que mostra como concluir o processo de instalação:
Para obter mais assistência, consulte este guia na documentação do Hummingbot.
Linux / Docker
Recomendamos que usuários instalem a versão Docker do Hummingbot, que é otimizada para executar vários bots simultaneamente.
Abra uma janela Terminal/Bash e execute os comandos a seguir. Esses comandos baixam e executam os scripts de instalação do Docker.
Siga as instruções do script para criar uma instância do Hummingbot.
Para obter mais informações sobre outras opções de instalação, consulte a seção de Instalação de documentos do Hummingbot.
Depois de instalar o Hummingbot, você deverá ver a interface do Hummingbot:
Prossiga para a próxima parte do guia de início rápido do Hummingbot: Configurar um bot de Market Making
Configure um bot de Market Making
Esta é a segunda parte do guia rápido de inicialização do Hummingbot:
Se você instalou o Hummingbot com êxito, deverá ver a tela de boas-vindas, ler o importante aviso de isenção e criar uma senha segura.
Crie uma senha segura
Se você estiver usando o Hummingbot pela primeira vez neste computador, o sistema solicitará que você crie uma senha. Essa senha será usada para criptografar configurações confidenciais, por exemplo, chaves API, chaves secretas e chaves privadas de carteira.
Aviso: Por razões de segurança, a senha é armazenada localmente e de forma criptografada. Não temos acesso à sua senha.
Navegue na interface do cliente
Depois de configurar sua senha, você deverá ver a interface do Hummingbot baseada em linha de comando.
Primeiro, vamos examinar o design da interface do cliente Hummingbot:
- Painel superior esquerdo: painel de saída do comando
- Painel inferior esquerdo: painel de entrada de comando
- Painel direito: logs de negociação
Digite o comando help para ver uma lista de comandos:
Insira as chaves de API
O Hummingbot requer chaves API habilitadas para trade para acessar sua conta na exchange. Para obter informações específicas da exchage ou sobre como encontrar suas chaves de API, consulte os Conectores na página de documentos do Hummingbot.
Digite o comando connect [exchange] para conectar sua conta da exchange ao Hummingbot adicionando chaves de API, onde [exchange] está uma das exchanges suportadas pelo Hummingbot. Você pode clicar em ESPAÇO ou começar a digitar para ver as opções disponíveis.
O comando connect mostra se as chaves de API foram adicionadas com sucesso.
Observe que cada exchange tem um formato diferente para chaves API.
Dica: Alguns usuários relataram não conseguir copiar e colar suas chaves de API em algumas plataformas. Nossos artigos de ajuda, como Outras maneiras de copiar e colar e Cole itens da área de transferência no PuTTY pode ajudar.
Crie uma nova configuração
A seguir, criaremos uma configuração para um bot de market making usando o pura estratégia de market making.
Digite o comando create para começar a criar um arquivo de configuração de estratégia. Esta configuração será salva em um arquivo que poderá ser importado posteriormente.
Selecione exchange e par de negociação
Em seguida, selecione a exchange e o par de negociação.
Como estamos criando um robô de trade de papel (conta teste), você não precisa de nenhum ativo na bolsa. No entanto, você precisará de uma conta para gerar chaves de API.
Para o par de negociação, selecione ETH-USDT ou ETH-USDC dependendo da exchange. Aqui estão dois exemplos:
Binance.com
Blocktane.io
Insira os parâmetros de market making
Os parâmetros de estratégia de um bot controlam como ele se comporta. Durante esta etapa, você definirá os parâmetros básicos para o seu bot de market making: spreads de pedidos, tamanhos de pedidos e com que frequência os pedidos serão atualizados.
Quais spreads devo definir? A distribuição de pedidos é uma das alavancas mais importantes que os market makers podem controlar. Spreads mais estreitos fazem com que seus pedidos sejam preenchidos com mais frequência, resultando em mais negociações, maiores mudanças no saldo de ativos e potencialmente mais risco. Recomendamos que os novos usuários comecem com spreads maiores , como 1,00% para cada lado do livro de pedidos ou mais.
Ordens de compra e venda alternativas
O recurso de pingue-pongue ajuda os usuários a gerenciar o risco de estoque, alternando os pedidos de compra e venda após o preenchimento.
Gerenciar o risco de estoque em face da volatilidade do mercado é um dos aspectos mais importantes do market making. Veja a seção Market Making Avançado da documentação do Hummingbot para mais maneiras de gerenciar o risco de inventário.
Salvar configuração
Digite o nome que deseja para o seu arquivo de configuração para concluir o processo.
Prossiga para a próxima parte do guia de início rápido do Hummingbot: Execute seu primeiro bot de negociação
Execute seu primeiro bot
Esta é a terceira parte do guia rápido de inicialização do Hummingbot:
Se você configurou um bot com sucesso na etapa 2, deverá ver a seguinte mensagem no painel esquerdo do Hummingbot:! [] (./ quickstart_start.png)
Ativar modo de trade de papel (opcional)
Você pode configurar o bot para operar no modo de negociação de papel (conta teste). No modo de negociação de papel, o bot usa dados do livro de ordens ao vivo e negociações reais para simular a colocação de ordens e obtê-las preenchidas. Observe que se você não habilitar o modo de negociação de papel, o bot colocará ordens reais usando seus saldos de câmbio.
Digite o comando paper_trade para habilitar este recurso.
Em seguida, a barra superior no cliente Hummingbot deve mostrar paper_trade: ON.
Como edito os saldos do modo de negociação de papel? Para alterar os saldos de ativos usados no comércio de papel, use o comando balance paper. Por exemplo, para definir um saldo comercial de papel de 1000 BTC, execute balance paper 1000 BTC.
Iniciar bot
Agora que configurou com sucesso um bot de negociação, você pode iniciar market making executando o comando start.
Executar bot
Após algumas verificações preliminares, o bot irá buscar o estado atual do livro de pedidos e começar a colocar os pedidos.
Você deve ver mensagens como esta no painel de registro à direita.
Obter status de bot
Digite o comando status (você também pode usar o atalho de teclado Ctrl-S ).
Este comando mostra a você:
- Verificações preliminares: verificações para garantir que o bot é capaz de executar
- Ativos: quanto de cada ativo você tem
- Pedidos ativos: lista dos pedidos em aberto atuais
- Avisos: avisos que podem afetar o funcionamento do seu bot.
Se você não conseguir ver nenhum pedido ativo, verifique se inseriu corretamente as chaves de API para a exchange.
Veja as negociações anteriores e o desempenho
Digite o comando history.
Este comando mostra a você:
- Lista de negociações : as negociações que seu bot realizou durante esta sessão
- Estoque : como sua reserva mudou com o resultado dessas negociações
- Desempenho : Quanto lucro ou perda o seu bot obteve como resultado dessas negociações
Para obter mais informações sobre como o Hummingbot calcula o desempenho, consulte Análise de desempenho.
Sair do Hummingbot
Entre stop para parar o bot, ou exit para parar e também sair do Hummingbot.
O stop e exit cancela automaticamente todos os pedidos pendentes e notifica você, se acredita, que há pedidos que podem não ter sido cancelados.
Ao reiniciar o Hummingbot, você pode importar o arquivo de configuração salvo, que foi nomeado automaticamente conf_pure_mm_1.yml: