Buscar Cotação de Uma ou Mais Criptomoedas (BTC, ETH, etc)

Nesta seção, você encontrará informações detalhadas sobre como buscar cotações de criptomoedas por meio da API da brapi. Este endpoint é a porta de entrada para obter informações atualizadas sobre várias criptomoedas, permitindo que você acompanhe os preços, variações, volume de negociação e muito mais.

Endpoint

O endpoint que você deve utilizar para buscar cotações de criptomoedas é o seguinte:

GET /api/v2/crypto

Parâmetros da Solicitação

Para utilizar este endpoint, você precisa fornecer os seguintes parâmetros na solicitação:

coin (obrigatório)

O parâmetro "coin" é obrigatório e permite que você adicione uma ou mais criptomoedas separadas por vírgula. Você pode consultar a lista de criptomoedas disponíveis aqui (opens in a new tab).

Exemplo de uso: ?coin=BTC,ETH

Isso facilita a busca por informações específicas de criptomoedas de seu interesse.

currency (opcional)

O parâmetro "currency" é opcional e especifica a moeda na qual as informações serão retornadas. Por padrão, a moeda é definida como BRL, mas você pode escolher entre várias moedas disponíveis. Consulte a lista de moedas aqui (opens in a new tab).

Exemplo de uso: ?currency=BRL

Isso permite que você obtenha informações de cotação em diferentes moedas, dependendo de suas necessidades.

range (opcional)

O intervalo de tempo para os dados solicitados, exemplo dados dos últimos 6 meses. Os valores aceitáveis são

1d - Um dia de negociação, incluindo o dia atual.
5d - Cinco dias de negociação, incluindo o dia atual.
1mo - Um mês de negociação, incluindo o dia atual.
3mo - Três meses de negociação, incluindo o dia atual.
6mo - Seis meses de negociação, incluindo o dia atual.
1y - Um ano de negociação, incluindo o dia atual.
2y - Dois anos de negociação, incluindo o dia atual.
5y - Cinco anos de negociação, incluindo o dia atual.
10y - Dez anos de negociação, incluindo o dia atual.
ytd - O ano atual até a data atual.
max - Todos os dados disponíveis.

interval (opcional)

O intervalo de tempo entre os dados, exemplo dados de 1 em 1 minuto. Os valores válidos incluem:

1m - Um minuto.
2m - Dois minutos.
5m - Cinco minutos.
15m - Quinze minutos.
30m - Trinta minutos.
60m - Sessenta minutos.
90m - Noventa minutos.
1h - Uma hora.
1d - Um dia.
5d - Cinco dias.
1wk - Uma semana.
1mo - Um mês.
3mo - Três meses.

token (obrigatório)

O token de autenticação é obrigatório e exclusivo para cada usuário. Você pode obtê-lo em https://brapi.dev/dashboard (opens in a new tab). A autenticação é necessária para acessar os recursos da API e garantir a segurança das suas solicitações.

Esse token pode ser passado como parâmetro de query ou como header Authorization: Bearer {token}.

Esta flexibilidade na definição de parâmetros permite que você ajuste suas solicitações para atender a uma variedade de necessidades, desde a obtenção de cotações simples até a busca de informações fundamentais e dados detalhados sobre criptomoedas.

Exemplo de Solicitação

Para uma solicitação que busca as cotações de BTC e ETH em relação ao BRL, a solicitação ficaria da seguinte forma:

curl -X GET \
"https://brapi.dev/api/v2/crypto?coin=BTC,ETC&currency=BRL&range=5d&interval=1d&token=eJGEyu8vVHctULdVdHYzQd"

Parâmetro	Valor
coin	BTC,ETC
currency	BRL
range	5d
interval	1d
token	eJGEyu8vVHctULdVdHYzQd

Resposta da Solicitação

200 OK

A solicitação foi bem-sucedida.

{
  "coins": [
    {
      "currency": "USD",
      "currencyRateFromUSD": 1,
      "coinName": "Solana USD",
      "coin": "SOL",
      "regularMarketChange": -16.79895,
      "regularMarketPrice": 199.2073,
      "regularMarketChangePercent": -7.777063,
      "regularMarketDayLow": 196.79688,
      "regularMarketDayHigh": 208.90076,
      "regularMarketDayRange": "196.79688 - 208.90076",
      "regularMarketVolume": 5044000256,
      "marketCap": 97023246336,
      "regularMarketTime": "2025-02-05T19:44:00.000Z",
      "coinImageUrl": "https://s2.coinmarketcap.com/static/img/coins/64x64/5426.png",
      "usedInterval": "1d",
      "usedRange": "5d",
      "historicalDataPrice": [
        {
          "date": 1738281600, // Data em UNIX timestamp (epoch) -> new Date(date * 1000)
          "open": 239.0167, // Preço de abertura
          "high": 241.6666, // Preço máximo
          "low": 228.4788, // Preço mínimo
          "close": 231.6379, // Preço de fechamento
          "volume": 4043216055, // Volume
          "adjustedClose": 231.6379 // Preço de fechamento ajustado
        },
        {
          "date": 1738368000,
          "open": 231.6406,
          "high": 233.8638,
          "low": 213.4364,
          "close": 213.785,
          "volume": 3546350864,
          "adjustedClose": 213.785
        },
        {
          "date": 1738454400,
          "open": 213.7809,
          "high": 218.3844,
          "low": 195.4492,
          "close": 203.1196,
          "volume": 8432593480,
          "adjustedClose": 203.1196
        },
        {
          "date": 1738540800,
          "open": 203.1215,
          "high": 218.6477,
          "low": 180.4093,
          "close": 216.1496,
          "volume": 15260840772,
          "adjustedClose": 216.1496
        },
        {
          "date": 1738627200,
          "open": 216.1505,
          "high": 219.9959,
          "low": 202.8488,
          "close": 207.092,
          "volume": 7328632702,
          "adjustedClose": 207.092
        },
        {
          "date": 1738784640,
          "open": 207.0365,
          "high": 208.9008,
          "low": 196.7969,
          "close": 199.2073,
          "volume": 5044000256,
          "adjustedClose": 199.2073
        }
      ],
      "validRanges": [
        "1d",
        "2d",
        "5d",
        "7d",
        "1mo",
        "3mo",
        "6mo",
        "1y",
        "2y",
        "5y",
        "10y",
        "ytd",
        "max"
      ],
      "validIntervals": [
        "1m",
        "2m",
        "5m",
        "15m",
        "30m",
        "60m",
        "90m",
        "1h",
        "1d",
        "5d",
        "1wk",
        "1mo",
        "3mo"
      ]
    },
    {
      "currency": "USD",
      "currencyRateFromUSD": 1,
      "coinName": "Bitcoin USD",
      "coin": "BTC",
      "regularMarketChange": -2937.0547,
      "regularMarketPrice": 97285.75,
      "regularMarketChangePercent": -2.9305284,
      "regularMarketDayLow": 96550.875,
      "regularMarketDayHigh": 98884.625,
      "regularMarketDayRange": "96550.875 - 98884.625",
      "regularMarketVolume": 57898749952,
      "marketCap": 1928213168128,
      "regularMarketTime": "2025-02-05T19:44:00.000Z",
      "coinImageUrl": "https://s2.coinmarketcap.com/static/img/coins/64x64/1.png",
      "usedInterval": "1d",
      "usedRange": "5d",
      "historicalDataPrice": [
        {
          "date": 1738281600,
          "open": 104737.5625,
          "high": 106026.3516,
          "low": 101543.8828,
          "close": 102405.0234,
          "volume": 45732764360,
          "adjustedClose": 102405.0234
        },
        {
          "date": 1738368000,
          "open": 102402.7969,
          "high": 102755.7266,
          "low": 100297.7109,
          "close": 100655.9063,
          "volume": 27757944848,
          "adjustedClose": 100655.9063
        },
        {
          "date": 1738454400,
          "open": 100661.5391,
          "high": 101430.6641,
          "low": 96216.0781,
          "close": 97688.9766,
          "volume": 63091816853,
          "adjustedClose": 97688.9766
        },
        {
          "date": 1738540800,
          "open": 97681.1016,
          "high": 102514.1719,
          "low": 91242.8906,
          "close": 101405.4219,
          "volume": 115400897748,
          "adjustedClose": 101405.4219
        },
        {
          "date": 1738627200,
          "open": 101398.7188,
          "high": 101745.6172,
          "low": 96208.1094,
          "close": 97871.8203,
          "volume": 73002130211,
          "adjustedClose": 97871.8203
        },
        {
          "date": 1738784640,
          "open": 97807.8438,
          "high": 98884.625,
          "low": 96550.875,
          "close": 97285.75,
          "volume": 57898749952,
          "adjustedClose": 97285.75
        }
      ],
      "validRanges": [
        "1d",
        "2d",
        "5d",
        "7d",
        "1mo",
        "3mo",
        "6mo",
        "1y",
        "2y",
        "5y",
        "10y",
        "ytd",
        "max"
      ],
      "validIntervals": [
        "1m",
        "2m",
        "5m",
        "15m",
        "30m",
        "60m",
        "90m",
        "1h",
        "1d",
        "5d",
        "1wk",
        "1mo",
        "3mo"
      ]
    }
  ]
}

400 Bad Request

A solicitação foi malformada, inválida ou a moeda não existe.

{
  "error": true,
  "message": "Something went wrong while fetching the data"
}

417 Expectation Failed

Não encontramos a moeda que você está procurando.

{
  "error": true,
  "message": "Missing required parameter: `coin`"
}

401 Unauthorized

O token de autenticação não foi informado ou é inválido.

{
  "error": true,
  "message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}

/api/available /api/v2/crypto/available