API DE NEGOCIAÇÕES

Como funciona:

A API de Negociações da bitPreço permite que você automatize seus processos de compra e venda de criptomoedas, e ainda aproveite dos descontos existentes na plataforma para aumentar a rentabilidade de suas negociações ou arbitragens.

- A API permite no máximo 30 acessos por minuto, somando acessos da API de negociações e pública.

O endpoint de acesso a API RESTFull é https://api.bitpreco.com/trading/
Este endpoint, assim como todos os dados que trafegam no mesmo, é criptografado por SSL

Toda requisição deve ser feita pelo método POST e deve incluir o valor de ‘auth_token’, que
nada mais é que sua chave de acesso, composta pela concatenação das strings que representam
sua “assinatura” e “chave da api”. Você deve solicitar estas chaves dentro da própria plataforma.

Veja exemplo

Você receberá por email:

signature = "ABg3MTIxOTYzOQtrDtKNGae9YG3NjNHK0ZFVkY1UWVCaCtRQXYvWkIxRlAvSlRSV"

api_key = “ApVdlRUCddOd3p0RSt6VExvN3NqZlhIcUcxZWJpclRpSEpWSQ”

E seu token de acesso será:

auth_token = signature+api_key; (strings concatenadas)


Veja abaixo os métodos existentes na API de negociações:

BALANCE

Descrição: Devolve o balanço atual de sua conta
Propriedades da requisição:
cmd = "balance" (string) auth_token = [seu_token] (string). Exemplo cURL: curl --request POST \ --url https://api.bitpreco.com/trading/ \ --header 'Content-Type: application/json' \ --data '{ \ "cmd":"balance", \ "auth_token": "ABg3M………….SEpWSQ" \ }' Exemplos de respostas: {"success":true,"BTC":3.51633389,"BTC_locked":2.2983727,"BRL":180177.23,"BRL_locked":0} Obs: "BTC" e "BRL" retornam a quantidade disponível para uso (available) e não a quantidade total em sua conta. O total é a soma destes valores com os valores bloqueados (locked)

OPEN ORDERS

Descrição: Devolve a lista de suas ordens que estão aguardando execução na plataforma
Propriedades da requisição:
cmd = "open_orders" (string) auth_token = [seu_token] (string). Exemplo cURL: curl --request POST \ --url https://api.bitpreco.com/trading/ \ --header 'Content-Type: application/json' \ --data '{ \ "cmd":"open_orders", \ "auth_token": "ABg3M………….SEpWSQ" \ }' Exemplos de respostas: {"id":"ZQVmZQNmZGNjZN","market":"BTC-BRL","type":"SELL","status":"EMPTY","amount":2.16,"price":25500,"exec_amount":0,"cost":0,"limited":"1"}, {"id":"AmNkAwDjZGNjZN","market":"BTC-BRL","type":"SELL","status":"PARTIAL","amount":0.2,"price":25600,"exec_amount":0.0616273,"cost":1577.66,"limited":"1"}

BUY

Descrição: Coloca uma ordem de compra na plataforma
Propriedades da requisição:
cmd = "buy" (string) market = "BTC-BRL" (string). price = [preço em BRL] (float) . amount = [quantidade] (float) . auth_token = [seu_token] (string). Exemplo cURL: curl --request POST \ --url https://api.bitpreco.com/trading/ \ --header 'Content-Type: application/json' \ --data '{ \ "cmd":"buy", \ "market":"BTC-BRL", \ "price": 25350.35, \ "amount": 1.00001234, \ "auth_token": "ABg3M………….SEpWSQ" \ }' Exemplos de respostas: {"success":true,"order_id":"AQt0BGRkZmNjZN","message_cod":"ORDER_CREATED"}

SELL

Descrição: Coloca uma ordem de venda na plataforma
Propriedades da requisição:
cmd = "sell" (string) market = "BTC-BRL" (string). price = [preço em BRL] (float) . amount = [quantidade] (float) . auth_token = [seu_token] (string). Exemplo cURL: curl --request POST \ --url https://api.bitpreco.com/trading/ \ --header 'Content-Type: application/json' \ --data '{ \ "cmd":"sell", \ "market":"BTC-BRL", \ "price": 25350.35, \ "amount": 1.00001234, \ "auth_token": "ABg3M………….SEpWSQ" \ }' Exemplos de respostas: {"success":true,"order_id":"AQ1eBGRkZmNjZN","message_cod":"ORDER_CREATED"}

ORDER CANCEL

Descrição: Cancela uma ordem que está aberta na plataforma
Propriedades da requisição:
cmd = "order_cancel" (string) order_id = [order id] (string). auth_token = [seu_token] (string). Exemplo cURL: curl --request POST \ --url https://api.bitpreco.com/trading/ \ --header 'Content-Type: application/json' \ --data '{ \ "cmd":"order_cancel", \ "order_id":"AlDaJizAZTT", \ "auth_token": "ABg3M………….SEpWSQ" \ }' Exemplos de respostas: {"success":true,"message_cod":"ORDER_CANCELED"}

ALL ORDERS CANCEL

Descrição: Cancela todas as suas ordens que estejam abertas na plataforma
Propriedades da requisição:
cmd = "all_orders_cancel" (string) auth_token = [seu_token] (string). Exemplo cURL: curl --request POST \ --url https://api.bitpreco.com/trading/ \ --header 'Content-Type: application/json' \ --data '{ \ "cmd":"all_orders_cancel", \ "auth_token": "ABg3M………….SEpWSQ" \ }' Exemplos de respostas: {"success":true,"orders_canceled":3}

ORDER STATUS

Descrição: Mostra o status das ordens.
Propriedades da requisição:
cmd = "order_status" (string) order_id = "xxxxxxxx" (string) auth_token = [seu_token] (string).. Exemplo cURL: curl --request POST \ --url https://api.bitpreco.com/trading/ \ --header 'Content-Type: application/json' \ --data '{ \ "cmd":"order_status", \ "order_id":"ZGNjAwVmZmRjZN", \ "auth_token": "ABg3M………….SEpWSQ" \ }' Exemplos de respostas: {"success":true,"order":{"id":"ZGNjAwVmZmRjZN","market":"BTC-BRL","type":"BUY","status":"EMPTY","amount":0.12,"price":14684.08,"exec_amount":0,"cost":0,"limited":"1","canceled":"0","time_stamp":"2019-01-09 05:36:17"}} Existem essas possibilidades: EMPTY, PARTIAL, FILLED.

Qualquer dúvida entre em contato suporte@bitpreco.com