Acesso à API de Negociações

O acesso à API de Dados é público, não é necessário criar uma conta tampouco autenticar.

Estrutura das Requisições

URL

É necessário fazer uma chamada HTTP, método GET, para a URL https://www.mercadobitcoin.net/api/<coin>/<method>/

Parâmetros de URL

Dois parâmetros são obrigatórios e presentes em todas as requisições:

 coin: Acrônimo da moeda digital

Tipo: String
Domínio de dados:

BTC : Bitcoin
LTC : Litecoin
BCH : BCash

 method: Método da API de Dados requisitado

Tipo: String
Domínio de dados:

ticker : resumo de operações executadas
orderbook : livro de negociações, ordens abertas de compra e venda
trades : histórico de operações executadas

Respostas

As Respostas são retornadas no formato JSON.

Exemplo de URL

https://www.mercadobitcoin.net/api/BTC/ticker/

Métodos da API

ticker

Descrição

Retorna informações com o resumo das últimas 24 horas de negociações.

Resultado

 high: Maior preço unitário de negociação das últimas 24 horas.

Tipo: Decimal

 low: Menor preço unitário de negociação das últimas 24 horas.

Tipo: Decimal

 vol: Quantidade negociada nas últimas 24 horas.

Tipo: Decimal

 last: Preço unitário da última negociação.

Tipo: Decimal

 buy: Maior preço de oferta de compra das últimas 24 horas.

Tipo: Decimal

 sell: Menor preço de oferta de venda das últimas 24 horas.

Tipo: Decimal

 date: Data e hora da informação em Era Unix

Tipo: Inteiro

Exemplo de chamada:

https://www.mercadobitcoin.net/api/BTC/ticker/

Exemplo de Retorno:

{
    'ticker': {
        'high': 14481.47000000,
        'low': 13706.00002000,
        'vol': 443.73564488,
        'last': 14447.01000000,
        'buy': 14447.00100000,
        'sell': 14447.01000000,
        'date': 1502977646
    }
}

orderbook

Descrição

Livro de ofertas é composto por duas listas: (1) uma lista com as ofertas de compras ordenadas pelo maior valor; (2) uma lista com as ofertas de venda ordenadas pelo menor valor. O livro mostra até 1000 ofertas de compra e até 1000 ofertas de venda.

Uma oferta é constituída por uma ou mais ordens, sendo assim, a quantidade da oferta é o resultado da soma das quantidades das ordens de mesmo preço unitário. Caso uma oferta represente mais de uma ordem, a prioridade de execução se dá com base na data de criação da ordem, da mais antiga para a mais nova.

Resultado

 bids: Lista de ofertas de compras, ordenadas do maior para o menor preço.

Tipo: Array

[0]: Preço unitário da oferta de compra.

Tipo: Decimal

[1]: Quantidade da oferta de compra.

Tipo: Decimal

 asks: Lista de ofertas de venda, ordenadas do menor para o maior preço.

Tipo: Array

[0]: Preço unitário da oferta de venda.

Tipo: Decimal

[1]: Quantidade da oferta de venda.

Tipo: Decimal

Exemplo de chamada:

https://www.mercadobitcoin.net/api/BTC/orderbook/

Exemplo de Retorno

{
    "asks": [
        [10410.00006000, 2.09190016],
        [10420.00000000, 0.00997000],
        [10488.99999000, 0.46634897]
    ],
    "bids": [
        [10405.38258000, 0.00181000],
        [10393.84180000, 0.08387000]
    ]
}

trades

Descrição

Histórico de operações executadas ou negociações realizadas.

Resultado

 []: Lista de operações realizadas.

date: Data e hora da operação em Era Unix

Tipo: Decimal

price: Preço unitário da operação.

Tipo: Decimal

amount: Quantidade da operação.

Tipo: Decimal

tid: Identificador da operação.

Tipo: Inteiro

type: Indica a ponta executora da operação

Tipo: String
Domínio de dados:

buy : indica ordem de compra executora
sell : indica ordem de venda executora

Exemplo de chamada:

https://www.mercadobitcoin.net/api/BTC/trades/

Parâmetros adicionais

A chamada tradicional do histórico irá retornar as últimas 1000 operações. Para obter dados anteriores, é necessário utilizar outros parâmetros conforme descrito e exemplificado abaixo:

tid ou since: Retorna até 1000 operações a partir do identificador da operação informado.

Chamadas:
https://www.mercadobitcoin.net/api/coin/trades/?tid=<tid>
https://www.mercadobitcoin.net/api/coin/trades/?since=<since>
Exemplo:

https://www.mercadobitcoin.net/api/BTC/trades/?tid=3700
https://www.mercadobitcoin.net/api/BTC/trades/?since=3700

from: Retorna até 1000 operações a partir da data informada.

Formato: Era Unix
Chamada: https://www.mercadobitcoin.net/api/coin/trades/<from>/
Exemplo:

https://www.mercadobitcoin.net/api/BTC/trades/1501871369/

from-to: Retorna até 1000 operações entre o intervalo de timestamp informado.

Formato: Era Unix
Chamada: https://www.mercadobitcoin.net/api/coin/trades/<from>/<to>/
Exemplo:

https://www.mercadobitcoin.net/api/BTC/trades/1501871369/1501871380/

Exemplo de Retorno

[
    {
        'date': 1502993741,
        'price': 14086.00000000,
        'amount': 0.03840000,
        'tid': 797861,
        'type': 'sell'
    },
    {
        'date': 1502993741,
        'price': 14086.00101000,
        'amount': 0.08519000,
        'tid': 797860,
        'type': 'sell'
    },
    {
        'date': 1502993907,
        'price': 14200.00000000,
        'amount': 0.01370282,
        'tid': 797871,
        'type': 'buy'
    },
    {
        'date': 1502993898,
        'price': 14200.00000000,
        'amount': 0.00697183,
        'tid': 797870,
        'type': 'buy'
    },
    {
        'date': 1502982896,
        'price': 14320.00101000,
        'amount': 0.02089000,
        'tid': 796876,
        'type': 'sell'
    }
]