BRbrapi-dev
Câmbio

Histórico de câmbio

Changed on

Série diária de câmbio pela PTAX de fechamento do Banco Central. Cobre USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK e SEK contra o real e entre si.

Use para backtests, conversão de valores em datas passadas e gráficos de câmbio.

Há três tipos de par:

  • Direto, como USD-BRL: planos Startup e Pro.
  • Inverso, como BRL-USD: calculado como 1 / USD-BRL. Só no plano Pro.
  • Cruzado, como EUR-USD: calculado como EUR-BRL / USD-BRL nas datas em que as duas séries têm valor. Só no plano Pro.

Peça até 20 pares por chamada. Sem datas, a janela é dos últimos 12 meses. A PTAX sai uma vez por dia útil, então não há pontos em fins de semana e feriados.

Um par não aceito ou fora do plano gera um item em errors e não derruba os outros pares. Para cripto, use a cotação de criptomoedas.

get/api/v2/currency/historical

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/currency/historical
  • Auth
    HTTP bearer

Query parameters

currencystring required

Pares no formato ORIGEM-DESTINO, separados por vírgula, até 20. Ex.: USD-BRL,EUR-BRL.

Example:USD-BRL,EUR-BRL
startDatestring

Data inicial no formato YYYY-MM-DD. Padrão: 12 meses atrás.

Example:2024-01-01
endDatestring

Data final no formato YYYY-MM-DD. Padrão: hoje.

Example:2024-12-31
sortOrder'asc' | 'desc'

Ordem por data. Padrão: desc.

Example:desc
limitinteger

Máximo de pontos 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 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
}

Changes