Cotação de Criptomoedas
Endpoints focados na obtenção de dados sobre Criptomoedas.
Inclui consulta de cotações atuais em diversas moedas fiduciárias, dados históricos e listagem de criptomoedas suportadas pela API.
Buscar Cotação Detalhada de Criptomoedas
Obtenha cotações atualizadas e dados históricos para uma ou mais criptomoedas.
Funcionalidades:
- Cotação Múltipla: Consulte várias criptomoedas em uma única requisição usando o parâmetro
coin. - Moeda de Referência: Especifique a moeda fiduciária para a cotação com
currency(padrão: BRL). - Dados Históricos: Solicite séries históricas usando
rangeeinterval(similar ao endpoint de ações).
Autenticação:
Requer token de autenticação via token (query) ou Authorization (header).
Exemplo de Requisição:
Cotação de Bitcoin (BTC) e Ethereum (ETH) em Dólar Americano (USD):
curl -X GET "https://brapi.dev/api/v2/crypto?coin=BTC,ETH¤cy=USD&token=SEU_TOKEN"Cotação de Cardano (ADA) em Real (BRL) com histórico do último mês (intervalo diário):
curl -X GET "https://brapi.dev/api/v2/crypto?coin=ADA¤cy=BRL&range=1mo&interval=1d&token=SEU_TOKEN"Resposta:
A resposta contém um array coins, onde cada objeto representa uma criptomoeda solicitada, incluindo sua cotação atual, dados de mercado e, opcionalmente, a série histórica (historicalDataPrice).
Autenticação via header HTTP Authorization. Use o formato Authorization: Bearer SEU_TOKEN. Obtenha seu token.
In: header
Query Parameters
Obrigatório. Uma ou mais siglas (tickers) de criptomoedas que você deseja consultar. Separe múltiplas siglas por vírgula (,).
- Exemplos:
BTC,ETH,ADA,SOL.
Opcional. A sigla da moeda fiduciária na qual a cotação da(s) criptomoeda(s) deve ser retornada. Se omitido, o padrão é BRL (Real Brasileiro).
"BRL"Opcional. Define o período para os dados históricos de preço (historicalDataPrice). Funciona de forma análoga ao endpoint de ações. Se omitido, apenas a cotação mais recente é retornada (a menos que interval seja usado).
- Valores:
1d,5d,1mo,3mo,6mo,1y,2y,5y,10y,ytd,max.
"1d" | "5d" | "1mo" | "3mo" | "6mo" | "1y" | "2y" | "5y" | "10y" | "ytd" | "max"Opcional. Define a granularidade (intervalo) dos dados históricos de preço (historicalDataPrice). Requer que range também seja especificado. Funciona de forma análoga ao endpoint de ações.
- Valores:
1m,2m,5m,15m,30m,60m,90m,1h,1d,5d,1wk,1mo,3mo.
"1m" | "2m" | "5m" | "15m" | "30m" | "60m" | "90m" | "1h" | "1d" | "5d" | "1wk" | "1mo" | "3mo"Obrigatório caso não esteja adicionado como header "Authorization". Seu token de autenticação pessoal da API Brapi.
Formas de Envio:
- Query Parameter: Adicione
?token=SEU_TOKENao final da URL. - HTTP Header: Inclua o header
Authorization: Bearer SEU_TOKENna sua requisição.
Ambos os métodos são aceitos, mas pelo menos um deles deve ser utilizado. Obtenha seu token em brapi.dev/dashboard.
Response Body
curl -X GET "https://brapi.dev/api/v2/crypto?coin=string¤cy=BRL&range=1d&interval=1m&token=string"{
"coins": [
{
"currency": "string",
"currencyRateFromUSD": 0.1,
"coinName": "string",
"coin": "string",
"regularMarketChange": 0.1,
"regularMarketPrice": 0.1,
"regularMarketChangePercent": 0.1,
"regularMarketDayLow": 0.1,
"regularMarketDayHigh": 0.1,
"regularMarketDayRange": "string",
"regularMarketVolume": 0,
"marketCap": 0,
"regularMarketTime": "2019-08-24T14:15:22Z",
"coinImageUrl": "string",
"usedInterval": "string",
"usedRange": "string",
"historicalDataPrice": [
{
"date": 0,
"open": 0.1,
"high": 0.1,
"low": 0.1,
"close": 0.1,
"volume": 0,
"adjustedClose": 0.1
}
],
"validRanges": [
"string"
],
"validIntervals": [
"string"
]
}
]
}{
"error": true,
"message": "Something went wrong while fetching the data"
}{
"error": true,
"message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}{
"error": true,
"message": "Missing required parameter: `coin`"
}