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

# Obter Cotações de Câmbio

`GET /api/v2/currency`

Retorna cotações atualizadas de pares de moedas, com preço de compra/venda, variação e extremos do dia.

### Funcionalidades:
*   **Cotação Atual:** Preço de compra (bid), venda (ask), máxima, mínima, variação
*   **Múltiplos Pares:** Consulte vários em uma requisição (separados por vírgula)
*   **Formato:** `ORIGEM-DESTINO` (ex: `USD-BRL`)

### Autenticação:
Bearer token ou query param `token`. Obtenha em brapi.dev/dashboard.

### Exemplos de Requisição:
```bash
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency?currency=USD-BRL"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency?currency=USD-BRL,EUR-BRL,GBP-BRL"
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/v2/currency?currency=BTC-BRL"
```

### Pares de Moedas Populares:
*   `USD-BRL` — Dólar Americano / Real
*   `EUR-BRL` — Euro / Real
*   `GBP-BRL` — Libra Esterlina / Real
*   `ARS-BRL` — Peso Argentino / Real
*   `EUR-USD` — Euro / Dólar
*   `BTC-BRL` — Bitcoin / Real
*   `ETH-BRL` — Ethereum / Real

### Campos da Resposta:
*   `fromCurrency` / `toCurrency` — Par de moedas
*   `name` — Nome do par
*   `bidPrice` — Preço de compra
*   `askPrice` — Preço de venda
*   `high` / `low` — Máxima/Mínima do dia
*   `bidVariation` — Variação do preço de compra
*   `percentageChange` — Variação percentual (%)

### Fonte dos Dados:
Banco Central do Brasil (PTAX) / Yahoo Finance

**Plano Mínimo:** Startup
**Autenticação:** Necessária

## Query parameters

- `currency` string — Par(es) de moedas 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 formato 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.

---

[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)