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.

# 1) Download Hummingbot install, start, and update 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) Enable script permissions

chmod a+x *.sh


# 3) Create a hummingbot instance

./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 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.

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:

Comando

Função

connect

Liste as exchanges 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 exchanges 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 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:

??? Parabéns por concluir com sucesso o guia rápido de inicialização do Hummingbot!