---
title: "Cotação de câmbio"
method: GET
path: "/api/v2/currency"
tags: ["Câmbio"]
---

# Cotação de câmbio

`GET /api/v2/currency`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/currency`
- Auth: HTTP bearer

Cotação atual de pares de moedas, com preço de compra, preço de venda, máxima,
mínima e variação do dia. Os pares cobertos pelo Banco Central usam a PTAX.

Use para converter valores, mostrar o dólar do dia e atualizar planilhas.

Informe os pares em `currency` no formato `ORIGEM-DESTINO`, como
`USD-BRL,EUR-BRL`. Os números vêm como texto.

A diferença entre `bidPrice` e `askPrice` é o spread de referência. Bancos e
casas de câmbio cobram um spread maior.

Veja os pares em [listar pares](https://brapi.dev/docs/moedas/available) e a
série diária em [histórico de câmbio](https://brapi.dev/docs/moedas/historico).
Planos Startup e Pro.

## Query parameters

- `currency` string: Pares no formato ORIGEM-DESTINO, separados por vírgula. Ex.: USD-BRL,EUR-BRL.

## Response `200`

Cotações dos pares de moedas solicitados retornadas com sucesso.

- CurrencyResponseSimple
  - `currency` CurrencyQuoteSimple[], required
    - `fromCurrency` string, required
    - `toCurrency` string, required
    - `name` string, required
    - `high` string, required
    - `low` string, required
    - `bidVariation` string, required
    - `percentageChange` string, required
    - `bidPrice` string, required
    - `askPrice` string, required
    - `updatedAtTimestamp` string, required
    - `updatedAtDate` string, required
  - `requestedAt` string, date-time, required: Data e hora da requisição em ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: **Requisição Inválida.** Parâmetro `currency` não fornecido ou formato inválido.
- `401`: **Não Autorizado.** Token de autenticação não fornecido ou inválido.
- `403`: **Acesso Proibido.** Seu plano não tem acesso ao módulo de câmbio.
- `500`: **Erro Interno.** Erro interno ao processar a requisição.
- `503`: **Serviço Indisponível.** Serviço externo temporariamente indisponível.

## Changes

- **2026-04-07** `19f807c15a24`: 6 breaking, 1 warning, 14 info
  - the response's body type changed from `object` to no type for status `400`
  - the response's body type changed from `object` to no type for status `401`
  - removed the required property `error` from the response with the `400` status
  - removed the required property `error` from the response with the `401` status
  - …17 more

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/currency/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)