Bitnuvem - API v1.0Documentação

Nossa API permite que aplicativos de terceiros consultem em tempo real dados de nosso site, como detalhes do livro de ofertas e valores de cotações nas últimas 24 horas.

URL para acesso

https://bitnuvem.com/api/BTC/{MÉTODO}

Métodos disponíveis

ticker

Método para obter informação de melhor oferta de venda e compra atual, último valor negociado, maior valor negociado nas últimas 24 horas, menor valor negociado nas últimas 24 horas, volume total negociado nas últimas 24 horas.

Exemplo de URL

https://bitnuvem.com/api/BTC/ticker

Exemplo de retorno:

{
  "ticker":
  {
    "high":"29650.00000000",
    "low":"29650.00000000",
    "vol":"0.00070000",
    "last":"29650.00000000",
    "buy":"29650.00000000",
    "sell":"29700.00000000",
    "date":"1533238081"
  }
}

Retorno da requisição

VariávelTipoDescrição
highDecimalValor mais alto negociado nas últimas 24 horas
lowDecimalValor mais baixo negociado nas últimas 24 horas
volDecimalVolume total negociado nas últimas 24 horas
lastDecimalÚltimo valor negociado
buyDecimalMelhor oferta de compra atual
sellDecimalMelhor oferta de venda atual
dataInteiroData de última atualização do ticker

orderbook

Método para obter informações das ofertas de compra e venda atuais no livro de oferta. Usamos bids para as ofertas de compra e asks para as ofertas de vendas

Exemplo de URL

https://bitnuvem.com/api/BTC/orderbook

Exemplo de retorno:

{
  "bids":
  [
    ["29650.00", "0.01683544"],
    ["29300.00", "0.02399744"],
    ["29200.00", "0.01805976"],
    ["29000.00", "0.05455275"]
  ],
  "asks":
  [
    ["29700.00", "0.04282872"],
    ["29750.00", "0.03414174"],
    ["29800.00", "0.02560631"],
    ["29900.00", "0.03891379"],
    ["30000.00", "0.03840947"]
  ]
}

Retorno da requisição (bids e asks)

VariávelTipoDescrição
[0]DecimalPreço da oferta
[1]DecimalQuantia total da oferta

trades

Método para obter informações das transações de compra e venda realizadas em um intervalo de datas. A requisição tem um limite de retorno de 1000 registros.

Exemplo de URL

https://bitnuvem.com/api/BTC/trades?from=x&to=y

Parâmetros GET

VariávelTipoDescrição
fromInteiroData inicial da pesquisa em formato Unix Timestamp (obrigatório)
toInteiroData final da pesquisa em formato Unix Timestamp (opcional)

Exemplo de retorno:

[{
    "date":"1533048047",
    "amount":"0.04237288",
    "price":"29500.00",
    "type":"sell",
    "tid":"6411"
},
{
    "date":"1533081379",
    "amount":"0.00033670",
    "price":"29700.00",
    "type":"buy",
    "tid":"3"
}]

Retorno da requisição

VariávelTipoDescrição
dateInteiroData em Unix Timestamp do momento que a transação foi executada
amountDecimalQuantidade negociada
priceDecimalPreço unitário da negociação
typeTextoTipo da ordem ativa: 'buy' (compra) ou 'sell' (venda)
tidInteiroCódigo único da transação

fee

Método para obter informação sobre valores cobrados atualmente na taxa de envio.

Exemplo de URL

https://bitnuvem.com/api/BTC/fee

Exemplo de retorno:

{
    "low":"0.00003750",
    "regular":"0.00007500",
    "priority":"0.00017250"
}

Retorno da requisição

VariávelTipoDescrição
lowDecimalValor de taxa de envio baixa
regularDecimalValor de taxa de envio regular
priorityDecimalValor de taxa de envio prioritário