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
range
einterval
(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_TOKEN
ao final da URL. - HTTP Header: Inclua o header
Authorization: Bearer SEU_TOKEN
na 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`"
}