web

DOCUMENTAÇÃO API

Acesso rápido:
API de Dados
API de Negociações



API DE DADOS

Como funciona:

Nosso site fornece APIs que possibilitam os usuários conseguir informações atualizadas sobre os principais dados do Bitcoin em nossa plataforma. API é um endereço de internet onde você pode receber dados via requisição HTTP GET. O retorno é em formato JSON.

O Clube Bitcoin possui 4 APIs para acesso:

  • ticker: retorna o ticker de preço da criptomoeda.
  • orderbook: retorna as ofertas de compra e venda da criptomoeda.
  • trades: retorna as negociações ou operações realizadas da criptomoeda.
  • exchanges: retorna os dados das exchanges conectadas ao bitpreço, com taxas e ordens de compra e venda.

  • Ticker

    https://api.bitpreco.com/btc-brl/ticker
    Retornará um JSON com os campos
  • high: maior valor negociado nas últimas 24h.
  • low: menor valor negociado nas últimas 24h.
  • var: variação entre o menor e maior valor (em porcentagem).
  • vol: Volume negociado nas últimas 24h.
  • last: Último valor negociado.
  • timestamp: dia e horas que foram gerados estes valores.


  • Exemplo de retorno: { "last":26353.32, "high":26636.3, "low":26162.93, "vol":0.19396095, "var":-1.78, "timestamp":2018-09-11 22:17:26 }


    Orderbook

    https://api.bitpreco.com/btc-brl/orderbook
    Retornará um JSON com os campos
  • asks: lista das ofertas de venda disponíveis. As ofertas são listadas com os valores de volume disponível seguido do preço unitário em Reais e id da ordem. ([{volume disponível}, {preço unitário em Reais}, {id da ordem}]).
  • bids: lista das ofertas de compra disponíveis. As ofertas são listadas com os valores de volume disponível seguido do preço unitário em Reais e id da ordem.([{volume disponível}, {preço unitário em Reais}, {id da ordem}]).
  • timestamp: dia e horas que foram gerados estes valores.

  • Exemplo de retorno:
    {
    "bids":[{ "amount":0.00337633, "price":26697.09, "id":"AQV2BGNlZQNjZN" }],
    "asks":[{ "amount":0.10909091, "price":27194.93, "id":"ZwV2BGNlZQNjZN"}],
    "timestamp":"2018-09-13 01:44:27"
    }


    Trades

    https://api.bitpreco.com/btc-brl/trades
    Retornará um JSON com os campos
  • type: tipo de ordem executada, buy: compra e sell: venda.
  • amount: quantidade transacionada.
  • timestamp: dia e horas que foram gerados estes valores.
  • price: preço unitário em reais.

  • Exemplo de retorno:
    [{"type":"BUY", "amount":0.0018522, "timestamp":"2018-09-12 17:20:38", "price":26313.85},
    {"type":"SELL", "amount":0.01126283, "timestamp":"2018-09-11 22:18:18", "price":26636.3}]


    Exchanges

    https://api.bitpreco.com/btc-brl/exchanges
    Retornará um JSON com os campos
  • name: nome da exchange.
  • execution: taxa de execução.
  • deposit: taxa de depósito.
  • withdrawal: taxa de saque.
  • bid: preço de compra.
  • ask: preço de venda.
  • timestamp: dia e horas que foram gerados estes valores.

  • Exemplo de retorno:
    [{"name":"MercadoBitcoin","execution":0.7,"deposit":0,"withdrawal":1.99,"bid":26203.22003,"ask":26488.64,"timestamp":"2018-10-02 14:50:04"}]


    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.

    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: Content-Type: application/json' \
    --data '{ \
    "cmd":"balance", \
    "auth_token": "ABg3M………….SEpWSQ" \
    }'



    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: Content-Type: application/json' \
    --data '{ \
    "cmd":"open_orders", \
    "auth_token": "ABg3M………….SEpWSQ" \
    }'



    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: Content-Type: application/json' \
    --data '{ \
    "cmd":"buy", \
    “market”:”BTC-BRL”, \
    “price”: 25350.35, \
    “amount”: 1.00001234, \
    "auth_token": "ABg3M………….SEpWSQ" \
    }'



    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: Content-Type: application/json' \
    --data '{ \
    "cmd":"sell", \
    “market”:”BTC-BRL”, \
    “price”: 25350.35, \
    “amount”: 1.00001234, \
    "auth_token": "ABg3M………….SEpWSQ" \
    }'



    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: Content-Type: application/json' \
    --data '{ \
    "cmd":"order_cancel", \
    “order_id ”:”AlDaJizAZTT”, \
    "auth_token": "ABg3M………….SEpWSQ" \
    }'



    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: Content-Type: application/json' \
    --data '{ \
    "cmd":"all_orders_cancel", \
    "auth_token": "ABg3M………….SEpWSQ" \
    }'



    ORDERBOOK

    Descrição: Retorna o livro com as principais ordens da plataforma. Esta chamada não precisa de token de acesso.
    Propriedades da requisição:
  • cmd = “orderbook” (string)
  • market = “BTC-BRL”(string).

  • Exemplo cURL:

    curl --request POST \
    --url https://api.bitpreco.com/trading/ \
    --header 'Content-type: Content-Type: application/json' \
    --data '{ \
    "cmd":"orderbook", \
    “market ”:”BTC-BRL”, \
    }'



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