Sign in

v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB
Câmbio

Obter Cotações de Câmbio

Retorna cotações atualizadas de pares de moedas, com preço de compra/venda, variação e extremos do dia.

Funcionalidades:

  • Cotação Atual: Preço de compra (bid), venda (ask), máxima, mínima, variação
  • Múltiplos Pares: Consulte vários em uma requisição (separados por vírgula)
  • Formato: ORIGEM-DESTINO (ex: USD-BRL)

Autenticação:

Bearer token ou query param token. Obtenha em brapi.dev/dashboard.

Exemplos de Requisição:

curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency?currency=USD-BRL"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency?currency=USD-BRL,EUR-BRL,GBP-BRL"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency?currency=BTC-BRL"

Pares de Moedas Populares:

  • USD-BRL — Dólar Americano / Real
  • EUR-BRL — Euro / Real
  • GBP-BRL — Libra Esterlina / Real
  • ARS-BRL — Peso Argentino / Real
  • EUR-USD — Euro / Dólar
  • BTC-BRL — Bitcoin / Real
  • ETH-BRL — Ethereum / Real

Campos da Resposta:

  • fromCurrency / toCurrency — Par de moedas
  • name — Nome do par
  • bidPrice — Preço de compra
  • askPrice — Preço de venda
  • high / low — Máxima/Mínima do dia
  • bidVariation — Variação do preço de compra
  • percentageChange — Variação percentual (%)

Fonte dos Dados:

Banco Central do Brasil (PTAX) / Yahoo Finance

Plano Mínimo: Startup Autenticação: Necessária

get/api/v2/currency

Query parameters

currencystring

Par(es) de moedas separados por vírgula (ex: USD-BRL,EUR-BRL)

Example:USD-BRL

Response

Cotações dos pares de moedas solicitados retornadas com sucesso.

requestedAtstring date-time required

Data e hora da requisição em formato ISO 8601

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "currency": [
    {
      "fromCurrency": "USD",
      "toCurrency": "BRL",
      "name": "Dólar Americano/Real Brasileiro",
      "high": "5.343",
      "low": "5.20858",
      "bidVariation": "-0.0546",
      "percentageChange": "-1.035958",
      "bidPrice": "5.2159",
      "askPrice": "5.2189",
      "updatedAtTimestamp": "1770415348",
      "updatedAtDate": "2026-02-06 19:02:28"
    },
    {
      "fromCurrency": "EUR",
      "toCurrency": "BRL",
      "name": "Euro/Real Brasileiro",
      "high": "6.1915",
      "low": "6.15764",
      "bidVariation": "0.03386",
      "percentageChange": "0.549886",
      "bidPrice": "6.1915",
      "askPrice": "6.2415",
      "updatedAtTimestamp": "1770527911",
      "updatedAtDate": "2026-02-08 02:18:31"
    }
  ],
  "requestedAt": "2026-02-08T16:26:24.131Z",
  "took": 27
}