DESENVOLVEDORESAprenda como criar um bot de trading com a API Cryptohopper e editar a configuração do(s) seu(s) bot(s) de trading. Em 2 passos simples, criaremos um novo bot de trading e adicionaremos as configurações ao bot de trading recém-criado.
Para fazer pedidos de API, tens que criar uma app e ter um token de acesso. Se ainda não criaste um token de acesso, segue primeiro o tutorial Get an access token with Oauth2.
Passo 1: Criar um novo bot de trading
Para criar um novo bot de trading com a API, precisas fazer uma chamada POST para o endpoint hopper. Com a chamada POST, podes enviar imediatamente valores de configuração, mas neste exemplo enviaremos apenas alguns exemplos de configuração e configuraremos o bot de trading no passo seguinte. Abaixo, encontras o endpoint da API e o JSON que precisas enviar com o pedido POST.
Endpoint da API:
https://api.cryptohopper.com/v1/hopper
JSON POST:
{
"name": "O nome do teu bot de trading recém-criado.",
"enabled": 0
}
Quando o pedido da API for bem-sucedido, receberás uma resposta JSON com o valor: id. Este id é o identificador único do teu bot de trading recém-criado. Guarda o id, pois precisá-lo-emos no passo seguinte para ajustar as configurações do bot de trading.
Passo 2: Configurar o teu bot de trading
Agora que criámos um novo bot de trading e tens o id do bot de trading recém-criado, é hora de configurar o bot de trading para que possas começar a negociar automaticamente com ele. Todas as atualizações ao teu bot de trading serão feitas acedendo aos endpoints do bot de trading com o teu id, como /hopper/{id}. Para atualizar a configuração do teu bot de trading, precisas fazer um pedido PATCH para este endpoint. Abaixo, encontras o endpoint para onde precisas enviar o teu pedido PATCH. Por favor, substitui {id} pelo id que recebeste no passo 1.
Endpoint da API:
https://api.cryptohopper.com/v1/hopper/{id}
Vais precisar enviar dados JSON das atualizações que queres fazer. Se quiseres alterar o nome do teu bot de trading, por exemplo, precisas enviar a chave nome novamente. Se não quiseres alterar o nome, simplesmente omite este campo. Abaixo, encontras um exemplo de um pedido JSON PATCH.
Exemplo de pedido JSON PATCH:
{
"name": "Um novo nome para o teu bot de trading recém-criado.",
"enabled": 0,
"api_config": {
"api_key": "A chave da API da tua conta da exchange.",
"api_secret": "O segredo da API da tua conta da exchange."
},
"config": {
"exchange": "binance",
"collect_currency": "btc",
.... E mais opções de configuração
}
}
Vamos analisar algumas das possíveis opções de configuração no pedido JSON.
| api_config | |
| api_key | Esta é a chave da API que criaste na tua exchange. |
| api_secret | Este é o segredo da API que criaste na tua exchange. |
| config | |
| exchange | Insere a chave da exchange da exchange que queres conectar. Para obter uma lista de todas as exchanges e chaves, vai para: https://api.cryptohopper.com/v1/exchange |
| collect_currency | Esta é a moeda de cotação do teu bot de trading em caracteres minúsculos, por exemplo: btc, usd, eth. |
| allowed_coins | Uma lista de arrays de moedas (maiúsculas) que o bot de trading pode comprar automaticamente. Por exemplo: ["BTC", "LTC", "ETH"]. |
| perc_buy_amount | A percentagem do teu total em ativos que será usada para determinar o valor de compra. |
| min_buy_amount | O montante mínimo de compra de compras automáticas. |
| max_amount_allocated | O montante máximo (em moeda de cotação) alocado ao teu bot de trading. |
| strategy | A estratégia que desejas configurar. Por exemplo: no_strategy, multiple_ta. Se desejas configurar uma estratégia feita sob medida, precisas ter o id da estratégia e configurá-la como: user_{id}, por exemplo: user_1. |
| num_targets_per_buy | O número de alvos que serão comprados se vários alvos forem encontrados pela tua estratégia. |
| max_open_time_buy | O número de minutos que as ordens de compra podem permanecer abertas antes de serem canceladas automaticamente. |
| max_open_time | O número de minutos que as ordens de venda podem permanecer abertas antes de serem canceladas automaticamente. |
| set_percentage | A percentagem de take profit que queres configurar, por exemplo: 1.5. |
É claro que existem muitas outras opções de configuração. Consulta a referência da API para mais informações sobre o objeto config.
Quando tiveres atualizado com sucesso a configuração do teu bot de trading, receberás uma resposta 200 com o teu objeto config completo devolvido. Se o pedido falhar, receberás um estado 400 com uma mensagem de erro explicando o erro.
Esperamos que consigas criar e configurar o teu bot de trading depois de leres este tutorial. Podes agora ajustar a configuração do teu bot de trading e adicionar novos bots de trading à tua conta.