API Pública

API Pública con BitBay 2.0

La nueva especificación API 2.0 estará disponible próximamente. En caso de desconexión de API 2.0 os informaremos previamente en un plazo adecuado de tiempo (aproximadamente 2 meses antes)

Presentación de conexiones:


https://bitbay.net/API/Public/[Moneda 1][Moneda 2]/[Categoría].json
  • [Moneda1] - obligatoria, es la abreviatura de la criptomoneda (BTC o LTC)
  • [Moneda 2] - opcional, en el caso de no ser propuesta, se establece USD como predeterminada (para unidades bursátiles)
  • [Categoría] - tipo de llamada, están disponibles:
    • trades - últimas transacciones
    • orderbook - ofertas de la bolsa
    • market - ofertas de la bolsa y últimas transacciones
    • ticker - estadísticas básicas
    • all - la información anterior en su totalidad

Ejemplo:


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

Detalles

trades - últimas transacciones

Devuelve una matriz cuyos elementos son objetos JSON, ordenados del más antiguo al más nuevo, como máximo 50, es decir, la llamada predeterminada devuelve las primeras 50 transacciones en una moneda determinada.

Ejemplo:


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

Para cada objeto JSON están disponibles:

  • date - fecha de la transacción como unix timestamp
  • price - tipo de cambio
  • amount - cantidad de criptomonedas en la transacción
  • tid - id único de la transacción

Es posible descargar transacciones que comiencen con un id específico, enviando el parámetro "since" usando el método get, en el que damos el tid de la transacción, después de la que queremos comenzar, es decir, p.ej.:


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

descargar todas las transacciones desde la 44 (la 43 no se cuenta).

De esta manera podemos descargar todas las transacciones, realizando la pregunta varias veces, en el parámetro since, dando solamente el tid de la última transacción de la pregunta anterior.

Opcionalmente, puede usarse el parámetro "sort", que toma dos valores "desc" - devuelve las transacciones en el orden de la más reciente a la más antigua, y "asc" para devolver la transacción en orden inverso.

orderbook - ofertas de la bolsa

Devuelve un objeto que posee 2 claves: bids y asks, que son, a su vez, matrices de las siguientes ofertas de compra y venta. Los elementos de estas matrices son también matrices, y poseen 2 elementos, de los cuales el primero es el tipo de cambio, y el segundo la cantidad de monedas de una oferta determinada.

Ejemplo:


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

market - ofertas de la bolsa y últimas transacciones La pregunta que conecta las dos anteriores, devuelve un objeto que posee las claves bids, asks y transactions. Las reglas de bids y aks son como las anteriores, al igual que transactions, es decir, devuelve las 50 transacciones más recientes. Esta pregunta también admite el parámetro "since", que afecta al contenido de la matriz transactions, tal como se describe en el primer punto

ticker - estadísticas básicas Devuelve el objeto JSON de la siguiente forma:


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

en el cual:

  • max es el tipo de cambio de la transacción de mayor valor
  • min es el tipo de cambio de la transacción de menor valor
  • bid es el tipo de cambio más utilizado de las actuales ofertas de compra