v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB

Câmbio

Histórico de Cotações de Câmbio

Retorna séries históricas diárias de câmbio em três formas, todas derivadas das mesmas cotações PTAX de fechamento:

Direto (X-BRL) — cotação diária do par armazenado. Disponível a partir do plano Startup.
Inverso (BRL-X) — calculado como 1 / X-BRL. Requer plano Pro.
Cross-rate (X-Y, nenhum dos dois é BRL) — calculado como X-BRL / Y-BRL em cada data com observação em ambas as séries. Requer plano Pro.

Moedas Suportadas

USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK contra BRL e entre si.

Para cotações em tempo real (incluindo cripto), use /api/v2/currency.

Exemplos

# Direto
curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/v2/currency/historical?currency=USD-BRL,EUR-BRL"

# Inverso
curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/v2/currency/historical?currency=BRL-USD"

# Cross-rate
curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/v2/currency/historical?currency=USD-EUR,GBP-EUR"

# Período customizado
curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://brapi.dev/api/v2/currency/historical?currency=USD-BRL&startDate=2020-01-01&endDate=2025-12-31"

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

get/api/v2/currency/historical

Query parameters

currencystring required

Pares de moedas separados por vírgula (ex: USD-BRL,EUR-BRL). Máximo 20.

Example:USD-BRL,EUR-BRL

startDatestring

Data de início no formato YYYY-MM-DD.

Example:2024-01-01

endDatestring

Data de fim no formato YYYY-MM-DD.

Example:2024-12-31

sortOrder'asc' | 'desc'

Ordem das observações pela data. Padrão: desc.

Example:desc

limitinteger

Máximo de observações por par. Padrão: 365.

Example:365

Response

Histórico de cotações PTAX retornado 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

{
  "results": [
    {
      "pair": "USD-BRL",
      "fromCurrency": "USD",
      "toCurrency": "BRL",
      "observations": [
        {
          "date": "2026-04-30",
          "value": 4.9886
        },
        {
          "date": "2026-04-29",
          "value": 4.9712
        },
        {
          "date": "2026-04-28",
          "value": 4.9854
        },
        {
          "date": "2026-04-25",
          "value": 5.0123
        },
        {
          "date": "2026-04-24",
          "value": 5.0218
        }
      ]
    },
    {
      "pair": "EUR-BRL",
      "fromCurrency": "EUR",
      "toCurrency": "BRL",
      "observations": [
        {
          "date": "2026-04-30",
          "value": 5.6712
        },
        {
          "date": "2026-04-29",
          "value": 5.6543
        },
        {
          "date": "2026-04-28",
          "value": 5.6789
        }
      ]
    }
  ],
  "requestedAt": "2026-04-30T12:00:00.000Z",
  "took": 14
}