Execute uma ordem de compra e uma de venda simples na exchange com seu bot de trading chamando o endpoint da API de ordem.

Para fazer requisições de API, você precisará criar um aplicativo e ter um token de acesso. Se você ainda não criou um token de acesso, siga o tutorial Get an access token with Oauth2 primeiro.

Colocando uma ordem de compra

Com a API você pode colocar ordens de compra simples ou mais avançadas com seu bot de trading. Neste exemplo, vamos focar apenas em uma ordem de compra simples. Um comando de compra simples para a API só precisará de uma moeda/cifragem, porque a maioria dos outros detalhes necessários já estão configurados no próprio bot de trading, por exemplo: a quantia a ser comprada. Uma ordem de compra pode ser colocada fazendo uma chamada POST para o endpoint /hopper/{id}/order, onde {id} é o ID do seu hopper.

API endpoint:

https://api.cryptohopper.com/v1/hopper/{id}/order

JSON POST exemplo:

{
  "order_type": "buy",
  "coin": "A criptomoeda a ser comprada.",
  "amount": 0,
  "price": 0
}

Os valores JSON amount e price são opcionais, apenas order_type e coin são obrigatórios. Se você tem um bot de trading com USD como moeda de cotação e quer colocar uma ordem de compra simples para BTC, você só precisará fazer um POST do seguinte JSON para a API.

{
  "order_type": "buy",
  "coin": "BTC"
}

Se for bem-sucedido, você receberá uma resposta de status 200 com a mensagem de que seu pedido de compra será colocado na exchange. Agora, verifique seu bot de trading e veja se o pedido de compra foi aceito.

Colocando uma ordem de venda

Você também pode colocar uma ordem de venda, mas como o Cryptohopper trabalha com posições, as posições da moeda/cifragem fornecida serão vendidas. Por exemplo: se você enviar um comando para vender BTC, todas as suas posições de BTC serão vendidas (se não estiverem em hold, etc.).

API endpoint:

https://api.cryptohopper.com/v1/hopper/{id}/order

JSON POST exemplo:

{
  "order_type": "sell",
  "coin": "A criptomoeda a ser vendida."
}

O mesmo endpoint da API é usado, mas neste caso definimos order_type para sell. Se você tiver um bot de trading com USD como moeda de cotação e quiser vender todas as posições de BTC, você só precisará fazer um POST do seguinte JSON para a API.

{
  "order_type": "sell",
  "coin": "BTC"
}

Se for bem-sucedido, você receberá uma resposta de status 200 com a mensagem de que suas ordens de venda serão colocadas na exchange. Agora, verifique seu bot de trading e veja se suas posições foram vendidas.

Esperamos que você tenha conseguido colocar ordens de compra e venda com a API após concluir este tutorial. Se precisar de mais informações sobre o endpoint de ordem ou quiser colocar pedidos mais avançados, consulte a referência da API para mais informações.