API Público

API público com o BitBay 2.0

Uma nova especificação da API 3.0 estará disponível em breve, a API 2.0 estará mais disponível. Se você desativar a API 2.0, nós o informaremos em tempo hábil (com aproximadamente 2 meses de antecedência) Apresentação de recursos:


https://bitbay.net/API/Public/[Moeda 1][Moeda 2]/[Categoria].json
  • [Moeda 1] - obrigatório, é o atalho de criptomoedas (BTC ou LTC)
  • [Moeda 2] - opcional, no caso de não ser padrão, define USD (para agregados da bolsa)
  • [Categoria] - tipo de cancelamento disponível:
    • trades - transações recentes
    • orderbook - ofertas da bolsa de valores
    • market - ofertas da bolsa de valores e transações recentes
    • ticker - estatísticas básicas
    • all - todas as informações acima reunidas

Exemplo:


https://bitbay.net/API/Public/BTCPLN/orderbook.json

Detalhes

trades - transações recentes

Retorna uma matriz cujos elementos são objetos JSON, classificados do mais antigo para o mais novo, no máximo 50, ou seja, a chamada padrão retornará as primeiras 50 transações em uma determinada moeda.

Exemplo:


[{"date":1396340859,"price":1524.50,"amount":0.08000000,"tid":"44"},{"date":1396340875,"price":1525.00,"amount":0.13000000,"tid":"45"}]

Em cada objeto JSON estão disponíveis:

  • date - tempo de transação como timestamp do unix
  • price - curso
  • amount - número de criptocorrências na transação
  • tid - id de transação exclusiva

Você pode fazer o download de transações iniciando com um id específico enviando o parâmetro "since" com o método get, no qual daremos a transação tid, após a qual queremos iniciar, ou seja, por exemplo:


https://bitbay.net/API/Public/BTCPLN/trades.json?since=43

irá coletar todas as transações a partir da 44 (43 não está incluída).

Desta forma, podemos recuperar todas as transações, chamando a consulta várias vezes, no parâmetro desde dando apenas o tid da última transação da consulta anterior.

Opcionalmente, você pode usar o parâmetro "sort", que recebe dois valores "desc" - retorna transações na ordem do mais recente para o mais antigo e "asc" para retornar a transação na ordem inversa.

orderbook - ofertas da bolsa de valores

Retorna um objeto com 2 chaves: lances e perguntas, que por sua vez são matrizes de ofertas de compra e ofertas. Os elementos dessas tabelas também são tabelas, eles têm dois elementos, o primeiro dos quais é um curso, e o segundo é a quantidade de moeda em uma determinada oferta.

Exemplo:


{"bids":[[1519.00,0.07],[1513.00,0.13]],"asks":[[1529.00,0.09],[1531.00,0.12]]}

market - ofertas da bolsa de valores e transações recentes A consulta, que é uma combinação dos dois acima, retorna o objeto contendo as chaves de lances, solicitações e transações. As regras de bids e aks são como acima, também transações, ou seja, retornam as 50 transações mais jovens. Essa consulta também pode usar o parâmetro "since", que afeta o conteúdo da tabela de transações, conforme descrito no primeiro ponto

ticker - estatísticas básicas Retorna o objeto JSON no seguinte formato:


{"max":4500,"min":1465,"last":1533,"bid":1513,"ask":1542,"vwap":1524.42,"average":1545.67,"volume":4.54042857}

onde:

  • max é a taxa de transação que teve o maior valor
  • min é a taxa de transação que teve o menor valor
  • bid é a taxa mais vantajosa de ofertas de compra atuais
  • ask é o curso mais vantajoso de ofertas de vendas atuais
  • vwap é uma média ponderada das últimas 24 horas
  • average é o preço médio calculado a partir das três melhores ofertas de vendas

all - todas as informações acima reunidas Retorna o objeto JSON do seguinte formato:


{"max":4500,"min":1465,"last":1533,"bid":1513,"ask":1542,"vwap":1524.42,"average":1545.67,"volume":4.54042857, "bids" {...}, "asks": {...}, "transactions": {...}}