API
Conheça nossa página no
APIs: clients com exemplos para Desenvolvedores

API de dados

Mercado Bitcoin

Essa página é direcionada a pessoas com conhecimento em programação que desejam consultar informações sobre as negociações ocorridas no site, de forma automatizada. Abaixo estão disponíveis métodos de chamada à API do Mercado Bitcoin, para a obtenção de informações. É possível encontrar, desde as últimas negociações concluídas, até o volume de Bitcoins negociados durante o dia.




1. Estrutura das requisições

voltar ao índice

As requisições devem ser feitas para a URL:

https://www.mercadobitcoin.net/api/<método>/

As requisições são no formato GET.


1.1. Resposta

voltar ao índice

Todas as respostas são em formato JSON.


2. Requisições

voltar ao índice

2.1. Método ticker/ticker_litecoin

voltar ao índice

Retorna as informações do mercado de bitcoin ou litecoin.

Campos de retorno

  • ticker
    Informações de retorno.
    • high
      Decimal: Maior valor, em reais, de negociação nas últimas 24 horas.
    • low
      Decimal: Menor valor, em reais, de negociação nas últimas 24 horas.
    • vol
      Decimal: Volume de bitcoins/litecoins negociados nas últimas 24 horas.
    • last
      Decimal: Preço unitário do último negócio, em reais.
    • buy
      Decimal: Maior valor, em reais, de oferta de compra.
    • sell
      Decimal: Menor valor, em reais, de oferta de venda.
    • date
      Inteiro: Data e hora em Era Unix da última atualização do ticker.

Exemplo de retorno:

{
  "ticker": {
    "high": 5.47000000,
    "low": 4.53000000,
    "vol": 67.73618443,
    "last": 4.60000000,
    "buy": 4.57000000,
    "sell": 5.47000000,
    "date": 1381374000
  }
}


2.2. Método orderbook/orderbook_litecoin

voltar ao índice

Retorna o livro de ofertas do mercado de bitcoin ou litecoin.

Campos de retorno

  • asks
    Lista de ofertas de venda.
    • [preço, volume]
      [Decimal, Decimal]: Par, cujo primeiro elemento é o preço e o segundo é o volume disponível.
  • bids
    Lista de ofertas de compra.
    • [preço, volume]
      [Decimal, Decimal]: Par, cujo primeiro elemento é o preço e o segundo é o volume disponível.

Exemplo de retorno:

{
  "asks": [
    [
      4.80000000,
      920.95000000
    ],
    [
      6.50000000,
      0.05000000
    ],
    [
      6.54999000,
      7.57720000
    ]
  ],
  "bids": [
    [
      4.41000000,
      200.00000000
    ],
    [
      4.40000000,
      800.00000000
    ]
  ]
}


2.3. Método trades/trades_litecoin

voltar ao índice

Retorna a lista de operações ocorridas nos mercados de bitcoin ou litecoin.

Campos de retorno

Cada item da lista possui os campos:

  • date
    Inteiro: Data e hora em Era Unix da operação.
  • price
    Decimal: Preço unitário da operação.
  • amount
    Decimal: Volume da moeda digital da operação.
  • tid
    Inteiro: ID da operação.
  • type
    String: Tipo da operação: sell para venda e buy para compra.

2.3.1. Formatos adicionais
voltar ao índice

É possível realizar outros tipo de consultas, através das seguintes URLs:

https://www.mercadobitcoin.net/api/trades/?tid=<tid>
Retorna as operações com tid maiores do que o indicado.

https://www.mercadobitcoin.net/api/trades/?since=<since>
Equivalente ao tid, porém com outra nomenclatura de parâmetro para o tid.

https://www.mercadobitcoin.net/api/trades/<timestamp inicial>/
Retorna as operações a partir da data e hora em Era Unix (timestamp) indicada.

https://www.mercadobitcoin.net/api/trades/<timestamp inicial>/<timestamp final>/
Retorna as operações a partir de data e hora em Era Unix (timestamp) indicada até a data e hora final indicada.


Exemplo de retorno:

[
  {
    "date": 1377249245,
    "price": 6.79000000,
    "amount": 0.04900000,
    "tid": 1,
    "type": "buy"
  },
  {
    "date": 1377249704,
    "price": 6.79000000,
    "amount": 0.05000000,
    "tid": 2,
    "type": "sell"
  },
  {
    "date": 1377257070,
    "price": 6.79000000,
    "amount": 0.05000000,
    "tid": 3,
    "type": "buy"
  },
  {
    "date": 1377259496,
    "price": 6.79000000,
    "amount": 0.05000000,
    "tid": 4,
    "type": "buy"
  },
  {
    "date": 1377260750,
    "price": 6.80000000,
    "amount": 6.00000000,
    "tid": 5,
    "type": "sell"
  }
]


3. Versionamento e compatibilidade

voltar ao índice

3.1. Método ticker/ticker_litecoin

voltar ao índice

Para preservar compatibilidade, este método possui duas versões. A versão atual é a v2, que retorna informações sobre as últimas 24 horas. As versões podem ser acessadas através da URL:

https://www.mercadobitcoin.net/api/<versão>/ticker/ ou
https://www.mercadobitcoin.net/api/<versão>/ticker_litecoin/

Versões disponíveis

v1

Retorna informações do mercado desde a meia-noite do dia atual.

v2

Retorna informações do mercado nas últimas 24 horas.



Exemplo de retorno:

{
  "ticker": {
    "high": 5.47000000,
    "low": 4.53000000,
    "vol": 67.73618443,
    "last": 4.60000000,
    "buy": 4.57000000,
    "sell": 5.47000000,
    "date": 1381374000
  }
} 


4. Cache

voltar ao índice

As informações do ticker são atualizadas a cada 60 segundos. Requisições com intervalo menor que este terão respostas idênticas.



Qualquer dúvida entre em contato com nosso Suporte.

---------------------------------------------------------------------------