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
currencies
com 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.
Authorization
Authorization
RequiredBearer <token>Autenticação via header HTTP Authorization
. Use o formato Authorization: Bearer SEU_TOKEN
. Obtenha seu token.
In: header
Query Parameters
search
stringOpcional. Termo para filtrar a lista pelo nome da moeda (correspondência parcial, case-insensitive).
token
stringObrigató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
Resposta do endpoint que lista todas as moedas fiduciárias disponíveis.
TypeScript Definitions
Use the response body type in TypeScript.
currencies
array<object>Lista de objetos, cada um contendo o nome de uma moeda fiduciária ou par suportado pela API.
Schema padrão para respostas de erro da API.
TypeScript Definitions
Use the response body type in TypeScript.
error
RequiredbooleanIndica se a requisição resultou em erro. Sempre true
para este schema.
message
RequiredstringMensagem descritiva do erro ocorrido.
Schema padrão para respostas de erro da API.
TypeScript Definitions
Use the response body type in TypeScript.
error
RequiredbooleanIndica se a requisição resultou em erro. Sempre true
para este schema.
message
RequiredstringMensagem descritiva do erro ocorrido.
curl -X GET "https://brapi.dev/api/v2/currency/available?search=Real" \
-H "Authorization: Bearer <token>"
fetch("https://brapi.dev/api/v2/currency/available?search=Real", {
headers: {
"Authorization": "Bearer <token>"
}
})
package main
import (
"fmt"
"net/http"
"io/ioutil"
)
func main() {
url := "https://brapi.dev/api/v2/currency/available?search=Real"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := ioutil.ReadAll(res.Body)
fmt.Println(res)
fmt.Println(string(body))
}
import requests
url = "https://brapi.dev/api/v2/currency/available?search=Real"
response = requests.request("GET", url, headers = {
"Authorization": "Bearer <token>"
})
print(response.text)
{
"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"
}