Documentação API

Nosso site fornece APIs que possibilitam os usuários conseguir informações atualizadas sobre os principais dados de cada criptomoeda.

API é um endereço de internet onde você pode receber dados via requisição HTTP GET. O retorno é em formato JSON.

Cada criptomoeda possui 3 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.

Para que a API retorne os dados da criptomoeda solicitada, é preciso substittuir {MOEDA} pelo simbolo da criptomoeda.

http://www.negociecoins.com.br/api/v3/{MOEDA}/ticker

A {MOEDA} pode ser BTC ou LTC.

Os valores de retorno desta chamada são cacheados à cada 60 segundos. Você não conseguirá valores atualizados se requisitá-los em menos de 60 segundos à partir da última requisição. Acessos repetidos com intervalo menor que 60 segundos poderá ocasionar o bloqueio de seu acesso.

ACESSOS

ticker
http://www.negociecoins.com.br/api/v3/BTCBRL/ticker

Exemplo de retorno:

                
                    {
                        "date": 1431717439,
                        "sell": 658.65,
                        "buy": 849.3,
                        "last": 756.8,
                        "high": 771.7,
                        "low": 743.1,
                        "vol": 1.069
                    }
                
            

Campos:

  • date: timestamp da última atualização do ticker.
  • sell: valor atual em Reais ofertado para venda.
  • buy: valor atual em Reais ofertado para compra.
  • last: último valor em Reais negociado.
  • high: maior valor em Reais de negociação das últimas 24 horas.
  • low: menor valor em Reais de negociação das últimas 24 horas.
  • vol: volume de Bitcoin ou Litecoin negociado nas últimas 24 horas.

Os valores em high, low e vol são referentes aos acumulado durante um dia de negociação no Brasil (GMT-3).


orderbook
http://www.negociecoins.com.br/api/v3/BTCBRL/orderbook

Exemplo de retorno:

                
                    {
                        "ask": [
                            {
                                "price": 745.48,
                                "quantity": 0.018
                            },
                            {
                                "price": 749.58,
                                "quantity": 0.187
                            },
                            .
                            .
                        ],
                        "bid": [
                            {
                                "price": 744.75,
                                "quantity": 0.097
                            },
                            {
                                "price": 743.1,
                                "quantity": 0.149
                            },
                            .
                            .
                        ]
                    }
                
            

Campos:

  • asks: lista das ofertas de venda disponíveis. As ofertas são listadas com os valores de preço unitário em Reais seguido do volume disponível ([{preço unitário em Reais}, {volume disponível}]).
  • bids: lista das ofertas de compra disponíveis. As ofertas são listadas com os valores de preço unitário em Reais seguido do volume disponível ([{preço unitário em Reais}, {volume disponível}]).

trades
http://www.negociecoins.com.br/api/v3/BTCBRL/trades

Formatos adicionais

É possível filtrar o resultado por periodo

http://www.negociecoins.com.br/api/v3/BTCBRL/trades/(timestamp inicial)
Retorna as operações a partir da data e hora em Era Unix (timestamp) indicada.

http://www.negociecoins.com.br/api/v3/BTCBRL/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": 1413053818,
                            "price": 929.2000202,
                            "amount": 0.01087,
                            "tid": 86622,
                            "type": "buy"
                        },
                        {
                            "date": 1413067068,
                            "price": 923.99999,
                            "amount": 0.02,
                            "tid": 86646,
                            "type": "sell"
                        },
                        .
                        .
                    ]
                
            

Campos:

  • date: timestamp da operação.
  • price: preço unitário em Reais da operação.
  • amount: volume de Litecoin ou Bitcoin da operação.
  • tid: ID da operação.
  • type: Tipo da operação: sell para venda e buy para compra.