O Hummingbot é um cliente de software de negociação de criptografia de código aberto que permite aos usuários negociar criptomoedas com estratégias de negociação de alta frequência, como criação de mercado e arbitragem. O Hummingbot atualmente oferece suporte a mais de nove exchanges, tanto centralizadas quanto descentralizadas.
Guia de instalação do Hummingbot
Instale o Hummingbot
Esta é a parte 1 do guia de início rápido do Hummingbot:
Requisitos de sistema
Se você estiver instalando o Hummingbot localmente ou em um servidor em nuvem, aqui estão os requisitos mínimos de sistema recomendados:
Sistema operacional
- Linux: Ubuntu 16.04 ou posterior
- MacOS: macOS 10.12.6 (Sierra) ou posterior
- Windows: Windows 10 ou posterior
Memória
1 GB de RAM por instância + 250 MB por instância adicional de
armazenamento
- 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 sua máquina local, certifique-se de desligar todos os recursos de hibernação ou economia de energia que possam encerrar sua conexão de rede.
Chaves API
Para autorizar o Hummingbot a negociar seus ativos, você precisará inserir as chaves da API de troca habilitadas para troca 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 obter mais informações sobre como obter as chaves de API para cada troca, consulte as páginas de troca individuais 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 comerciantes e desenvolvedores experientes: Recomendamos que você instale a versão Docker em uma instância de nuvem para maximizar o desempenho e a confiabilidade. Consulte Instalação no Manual do Usuário.
janelas
Baixe o instalador do Windows em nossa página de Downloads e clique nele 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 nele 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 sé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.
- Baixe o Hummingbot para instalar, iniciar e atualizar o script
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/create.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/start.sh
wget https://raw.githubusercontent.com/CoinAlpha/hummingbot/development/installation/docker-commands/update.sh
2. Habilite as permissões de script
chmod a+x *.sh
3. Crie uma instância do Hummingbot
./create.sh
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 Instalação dos 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 Criação de Mercado.
Configure um bot de criação de mercado
Esta é a parte 2 do guia de início rápido do Hummingbot:
Se você instalou o Hummingbot com êxito, deverá ver a tela de boas-vindas, ler o aviso de isenção importante e criar uma senha segura.
Crie uma senha segura
Se você estiver usando o Hummingbot pela primeira vez nesta máquina, o sistema solicitará que você crie uma senha. Esta senha será usada para criptografar definições de configuração confidenciais, por exemplo, chaves API, chaves secretas e chaves privadas de carteira.

Aviso: Por razões de segurança, a senha só é armazenada localmente 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 de comando
- Painel inferior esquerdo: painel de entrada de comando
- Painel direito: logs de negociação
Insira o comando help para ver uma lista de comandos:
COMANDO | DESCRIÇÃO |
---|---|
connect | Liste as trocas disponíveis e adicione chaves de API a elas |
create | Crie um novo bot |
import | Importe um bot existente carregando o arquivo de configuração |
help | Lista os comandos disponíveis |
balance | Exibir seus saldos de ativos em todas as trocas conectadas |
config | Mostra a configuração do bot atual |
start | Inicie o bot atual |
stop | Pare o bot atual |
status | Obtenha o status de mercado do bot atual |
history | Veja o desempenho anterior do bot atual |
exit | Saia e cancele todos os pedidos pendentes |
paper_trade | Alternar modo de negociação de papel |
export | Exporte as negociações ou chaves privadas do seu bot |
order_book | Exiba o lance máximo atual e pergunte na carteira de pedidos |
Insira as chaves de API
O Hummingbot requer chaves API habilitadas para comércio para acessar sua conta de troca. Para obter informações específicas de troca sobre como encontrar suas chaves de API, consulte a página Conectores nos documentos do Hummingbot.
Digite o comando connect [exchange]
para conectar sua conta de troca ao Hummingbot adicionando chaves de API, onde [troca] é uma das trocas suportadas pelo Hummingbot. Você pode clicar em ESPAÇO ou começar a digitar para ver as opções disponíveis.
O comando conectar mostra se as chaves de API foram adicionadas com sucesso.
Observe que cada troca possui 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 Colar itens da área de transferência no PuTTY, podem ajudar.
Crie uma nova configuração
A seguir, criaremos uma configuração para um bot de criação de mercado usando a estratégia de criação de mercado pura .
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 a troca e o par de negociação
Em seguida, selecione a troca e o par de negociação.
Como estamos criando um robô de troca de papel, 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 troca. Aqui estão dois exemplos:
Binance.com

Coinbase Pro

Insira os parâmetros de criação de mercado
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 criação de mercado: 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 criadores de mercado podem controlar. Spreads mais estreitos fazem com que seus pedidos sejam atendidos 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 mais amplos, como 1,00% para cada lado da carteira de pedidos ou mais.
Ordens de compra e venda alternativas
O recurso 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 da formação de mercado. Consulte a seção Criação de mercado avançada dos documentos do Hummingbot para obter mais maneiras de gerenciar o risco de estoque.
Salvar configuração
Digite o nome que deseja para o seu arquivo de configuração para concluir o processo.

Execute seu primeiro bot
Esta é a parte 3 do guia de início rápido do Hummingbot:
Se você configurou um bot com êxito na etapa 2, deverá ver a seguinte mensagem no painel esquerdo do Hummingbot:
Habilite o modo de troca de papel (opcional)
Você pode configurar o bot para funcionar no modo de negociação de papel. 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 fará ordens reais usando seus saldos de câmbio.
Digite o comando paper_trade para habilitar este recurso.
Depois disso, a barra superior no cliente Hummingbot deve dizer 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 BTC de 1000, execute o saldo de papel BTC 1000.
Comece o bot
Agora que configurou com sucesso um bot de negociação, você pode iniciar a criação de mercado 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 status do comando (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 abertos atuais
● Avisos: Avisos que podem afetar a forma como o seu bot é executado .
Se você não vir nenhum pedido ativo, verifique se inseriu corretamente as chaves de API para a troca.
Veja as negociações anteriores e o desempenho
Entre no histórico de comandos.
Este comando mostra a você:
● Lista de negociações: As negociações que seu bot realizou durante esta sessão
● Inventário: Como seu inventário mudou como resultado dessas negociações
● Desempenho: Quanto lucro ou perda seu bot obteve como resultado delas trades
Para obter mais informações sobre como o Hummingbot calcula o desempenho, consulte Análise de desempenho.
Sair do Hummingbot
Digite stop para parar o bot, ou saia para parar e também saia do Hummingbot.

Parar e sair cancela automaticamente todos os pedidos pendentes e notifica você se acredita que há pedidos potencialmente não cancelados.

Ao reiniciar o Hummingbot, você pode importar o arquivo de configuração salvo, que foi automaticamente denominado conf_pure_mm_1.yml:

??? Parabéns por concluir com sucesso o guia de início rápido do Hummingbot!