Listar 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 (embora o endpoint de cotação de moedas não esteja detalhado aqui, a listagem está disponível).
Listar Todas as Moedas Fiduciárias Disponíveis
Obtenha a lista completa de todas as moedas fiduciárias suportadas pela API, geralmente utilizadas no parâmetro currency de outros endpoints (como o de criptomoedas) ou para futuras funcionalidades de conversão.
Funcionalidade:
- Retorna um array
currenciescom os nomes das moedas. - Pode ser filtrado usando o parâmetro
search.
Autenticação:
Requer token de autenticação via token (query) ou Authorization (header).
Exemplo de Requisição:
Listar todas as moedas disponíveis:
curl -X GET "https://brapi.dev/api/v2/currency/available?token=SEU_TOKEN"Buscar moedas cujo nome contenha 'Euro':
curl -X GET "https://brapi.dev/api/v2/currency/available?search=Euro&token=SEU_TOKEN"Resposta:
A resposta é um objeto JSON com a chave currencies, contendo um array de objetos. Cada objeto possui uma chave currency com o nome completo da moeda (ex: "Dólar Americano/Real Brasileiro"). Nota: O formato do nome pode indicar um par de moedas, dependendo do contexto interno da API.
Autenticação via header HTTP Authorization. Use o formato Authorization: Bearer SEU_TOKEN. Obtenha seu token.
In: header
Query Parameters
Opcional. Termo para filtrar a lista pelo nome da moeda (correspondência parcial, case-insensitive).
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/available?search=string&token=string"{
"currencies": [
{
"name": "USD-BRL",
"currency": "Dólar Americano/Real Brasileiro"
},
{
"name": "EUR-BRL",
"currency": "Euro/Real Brasileiro"
}
]
}{
"error": true,
"message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}{
"error": true,
"message": "Currency not found"
}