Cotação de Moedas
Endpoints para consulta de Moedas Fiduciárias.
Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio.
Buscar Cotação de Pares de Moedas Fiduciárias
Obtenha cotações atualizadas para um ou mais pares de moedas fiduciárias (ex: USD-BRL, EUR-USD).
Funcionalidades:
- Cotação Múltipla: Consulte vários pares de moedas em uma única requisição usando o parâmetro
currency. - Dados Retornados: Inclui nome do par, preços de compra (bid) e venda (ask), variação, máximas e mínimas, e timestamp da atualização.
Parâmetros:
currency(Obrigatório): Uma lista de pares de moedas separados por vírgula, no formatoMOEDA_ORIGEM-MOEDA_DESTINO(ex:USD-BRL,EUR-USD). Consulte os pares disponíveis em/api/v2/currency/available.token(Obrigatório): Seu token de autenticação.
Autenticação:
Requer token de autenticação válido via token (query) ou Authorization (header).
Autenticação via header HTTP Authorization. Use o formato Authorization: Bearer SEU_TOKEN. Obtenha seu token.
In: header
Query Parameters
Obrigatório. Uma lista de um ou mais pares de moedas a serem consultados, separados por vírgula (,).
- Formato:
MOEDA_ORIGEM-MOEDA_DESTINO(ex:USD-BRL). - Disponibilidade: Consulte os pares válidos usando o endpoint
/api/v2/currency/available. - Exemplo:
USD-BRL,EUR-BRL,BTC-BRL
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/currency?currency=USD-BRL%2CEUR-USD&token=string"{
"currency": [
{
"fromCurrency": "USD",
"toCurrency": "BRL",
"name": "Dólar Americano/Real Brasileiro",
"high": "5.22",
"low": "5.162",
"bidVariation": "0.0454",
"percentageChange": "0.88",
"bidPrice": "5.2097",
"askPrice": "5.2127",
"updatedAtTimestamp": "1696601423",
"updatedAtDate": "2023-10-06 11:10:23"
}
]
}{
"error": true,
"message": "Algo deu errado ao buscar essa moeda"
}{
"error": true,
"message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}{
"error": true,
"message": "Não foi possível encontrar o parâmetro obrigatório: 'currency', exemplo: https://brapi.dev/api/v2/currency?currency=USD-BRL"
}