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.

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

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

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

Todas as respostas são em formato JSON.

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
  }
}

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
    ]
  ]
}

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.

É 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"
  }
]

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

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

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
  }
} 

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

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