Histórico de câmbio

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.

Authorization

Bearer

AuthorizationBearer <token>

Token de API obtido no dashboard em brapi.dev/dashboard

In: header

Query Parameters

currency*string

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

startDate?string

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

Match^\d{4}-\d{2}-\d{2}$

endDate?string

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

Match^\d{4}-\d{2}-\d{2}$

sortOrder?string

Ordem por data. Padrão: desc.

Value in

"asc"
"desc"

limit?integer

Máximo de pontos por par. Padrão: 365.

Range0 <= value

Response Body

`application/json`

curl -X GET "https://example.com/api/v2/currency/historical?currency=USD-BRL%2CEUR-BRL"

{  "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}

Query Parameters

currency*string

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

startDate?string

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

Match^\d{4}-\d{2}-\d{2}$

endDate?string

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

Match^\d{4}-\d{2}-\d{2}$

sortOrder?string

Ordem por data. Padrão: desc.

Value in

"asc"
"desc"

limit?integer

Máximo de pontos por par. Padrão: 365.

Range0 <= value

{ "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}

Histórico de câmbio

Histórico de câmbio

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

500application/json

Authorization

Query Parameters

Response Body

200application/json

400application/json

401application/json

403application/json

500application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`