# Histórico de Moedas
URL: /docs/moedas/historico.mdx

Série histórica diária de cotações PTAX para pares de moedas em BRL — USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK contra o real.

***

title: Histórico de Moedas
description: >-
Série histórica diária de cotações PTAX para pares de moedas em BRL —
USD, EUR, GBP, JPY, CHF, CAD, AUD, DKK, NOK, SEK contra o real.
full: true
keywords: brapi, api, moedas, ptax, histórico, dolar, euro, libra
openGraph:
title: Histórico de Moedas — brapi
description: >-
Série histórica diária de cotações PTAX para pares de moedas em BRL.
type: website
locale: pt\_BR
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/currency/historical
----------------------------------

Retorna a série histórica diária da cotação PTAX de venda para um ou mais
pares contra o real. Ideal para back-testing, gráficos de longo prazo e
análise de risco cambial.

<DocsQuickInfo>
  <AnswerBox
    question="Como obter a cotação histórica do dólar?"
    answer="GET /api/v2/currency/historical?currency=USD-BRL retorna a série PTAX diária dos últimos 12 meses."
    relatedEndpoints={[
  { name: "Histórico", path: "/api/v2/currency/historical" },
  { name: "Cotação Atual", path: "/api/v2/currency" },
  { name: "Pares Disponíveis", path: "/api/v2/currency/available" }
]}
    codeExample={`const r = await client.currency.historical.retrieve({
currency: 'USD-BRL,EUR-BRL',
startDate: '2020-01-01',
});`}
    note="Aceita até 20 pares. Padrão: últimos 12 meses, 365 pontos."
  />
</DocsQuickInfo>





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/currency/historical

Single endpoint documentation for /api/v2/currency/historical

## Base URLs

- `https://brapi.dev` - Servidor principal da API brapi
- `http://localhost:3001` - Servidor local para desenvolvimento

## GET /api/v2/currency/historical

**Summary:** 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.
- **Inverso** (BRL-X) — calculado como `1 / X-BRL`.
- **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.

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


**Tags:** Câmbio

### Parameters

- **currency** (query) *required*
- **startDate** (query)
- **endDate** (query)
- **sortOrder** (query)
- **limit** (query)

### Responses

#### 200

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

#### 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.**

## Schemas

The following schemas are used by this endpoint:

### CurrencyHistoricalError

**Properties:**

- **pair** (string) *(required)*

- **code** (string) *(required)*

- **message** (string) *(required)*


### CurrencyHistoricalPairResult

**Properties:**

- **pair** (string) *(required)*

- **fromCurrency** (string) *(required)*

- **toCurrency** (string) *(required)*

- **observations** (array) *(required)*
  Array items:
    **Properties:**

    - **date** (string) *(required)*

    - **value** (number) *(required)*



### CurrencyHistoricalResponse

**Properties:**

- **results** (array) *(required)*
  Array items:
    Reference to: **CurrencyHistoricalPairResult**

- **errors** (array)
  Array items:
    Reference to: **CurrencyHistoricalError**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)