---
title: "Histórico de Cotações de Câmbio"
method: GET
path: "/api/v2/currency/historical"
tags: ["Câmbio"]
---

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

`GET /api/v2/currency/historical`

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

```bash
# 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

## Query parameters

- `currency` string, required — Pares de moedas separados por vírgula (ex: USD-BRL,EUR-BRL). Máximo 20.
- `startDate` string — Data de início no formato YYYY-MM-DD.
- `endDate` string — Data de fim no formato YYYY-MM-DD.
- `sortOrder` 'asc' | 'desc' — Ordem das observações pela data. Padrão: desc.
- `limit` integer — Máximo de observações por par. Padrão: 365.

## Response `200`

Histórico de cotações PTAX retornado com sucesso.

- CurrencyHistoricalResponse
  - `results` CurrencyHistoricalPairResult[], required
    - `pair` string, required
    - `fromCurrency` string, required
    - `toCurrency` string, required
    - `observations` object[], required
      - `date` string, required
      - `value` number, required
  - `errors` CurrencyHistoricalError[]
    - `pair` string, required
    - `code` string, required
    - `message` string, required
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

- `400` — **Requisição Inválida.** Parâmetros ausentes ou inválidos.
- `401` — **Não Autorizado.**
- `403` — **Acesso Proibido.** Plano sem acesso ao módulo de câmbio.
- `500` — **Erro Interno.**

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/revisions/f275d46193ea/schema)