# Cotação de Moedas
URL: /docs/moedas.mdx

Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta de taxas de câmbio.

***

title: Cotação de Moedas
description: >-
Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na listagem
das moedas disponíveis para conversão ou consulta de taxas de câmbio.
full: true
keywords: brapi, api, documentação, moedas
openGraph:
title: Cotação de Moedas
description: >-
Endpoints para consulta de Moedas Fiduciárias. Atualmente, focado na
listagem das moedas disponíveis para conversão ou consulta de taxas de
câmbio.
type: website
locale: pt\_BR
lastUpdated: '2025-04-28T01:22:35.254Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/currency
toc:

* depth: 2
  title: Listar Todas as Moedas Fiduciárias Disponíveis
  url: '#listar-todas-as-moedas-fiduciárias-disponíveis'
  structuredData:
  headings:
  * content: Listar Todas as Moedas Fiduciárias Disponíveis
    id: listar-todas-as-moedas-fiduciárias-disponíveis
    contents:
  * content: >-
    Obtenha cotações atualizadas para um ou mais pares de moedas
    fiduciárias (ex: USD-BRL, EUR-USD).

    ### Funcionalidades:

    * **Cotação Múltipla:** Consulte vários pares de moedas em uma única
      requisição usando o parâmetro `currency`. \*   **Dados Retornados:**
      Inclui nome do par, preços de compra (bid) e venda (ask), variação,
      máximas e mínimas, e timestamp da atualização.

    ### Parâmetros:

    * **`currency` (Obrigatório):** Uma lista de pares de moedas
      separados por vírgula, no formato `MOEDA_ORIGEM-MOEDA_DESTINO` (ex:
      `USD-BRL`, `EUR-USD`). Consulte os pares disponíveis em
      [`/api/v2/currency/available`](#/Moedas/getAvailableCurrencies).
    * **`token` (Obrigatório):** Seu token de autenticação.

    ### Autenticação:

    Requer token de autenticação válido via `token` (query) ou
    `Authorization` (header).

    ### Estrutura da Resposta (200 OK):

    A resposta bem-sucedida (`CurrencyResponse`) contém um array
    `currency`. Cada objeto dentro deste array (`CurrencyQuote`)
    representa um par solicitado e inclui: \*   `fromCurrency`: Sigla da
    moeda de origem. \*   `toCurrency`: Sigla da moeda de destino.

    * `name`: Nome descritivo do par. \*   `high`, `low`: Preços máximo e
      mínimo do período recente. \*   `bidVariation`, `percentageChange`:
      Variação absoluta e percentual. \*   `bidPrice`, `askPrice`: Preços de
      compra e venda atuais. \*   `updatedAtTimestamp`, `updatedAtDate`:
      Timestamps da última atualização.

    ````json {
        \"currency\":
    [
          {
            \"fromCurrency\": \"USD\",
          \"toCurrency\":
    \"BRL\",
          \"name\": \"Dólar Americano/Real
    Brasileiro\",
          \"high\": \"5.22\",
          \"low\":
    \"5.162\",
          \"bidVariation\":
    \"0.0454\",
          \"percentageChange\":
    \"0.88\",
          \"bidPrice\": \"5.2097\",
          \"askPrice\":
    \"5.2127\",
          \"updatedAtTimestamp\":
    \"1696601423\",
          \"updatedAtDate\": \"2023-10-06
    11:10:23\"
        },
        {
            \"fromCurrency\":
    \"EUR\",
          \"toCurrency\": \"USD\",
          \"name\": \"Euro/Dólar
    Americano\",
          \"high\": \"1.0568\",
          \"low\":
    \"1.0482\",
          \"bidVariation\":
    \"-0.0037\",
          \"percentageChange\":
    \"-0.35\",
          \"bidPrice\": \"1.051\",
          \"askPrice\":
    \"1.0511\",
          \"updatedAtTimestamp\":
    \"1696601456\",
          \"updatedAtDate\": \"2023-10-06
    11:10:56\"
        }
      ]
    } ```
    heading: listar-todas-as-moedas-fiduciárias-disponíveis
    ````

***

import { Callout } from 'fumadocs-ui/components/callout';

Endpoints para consulta de **Moedas Fiduciárias**.

<DocsQuickInfo>
  <Callout title="Fonte de Dados" type="info">
    Taxas de câmbio do **BCB** e provedores forex. USD, EUR, GBP e 50+ pares com atualização em tempo real.
  </Callout>

  <AnswerBox
    question="Como obter a cotação do Dólar?"
    answer="GET /api/v2/currency?currency=USD-BRL retorna bid, ask e variação."
    relatedEndpoints={[
  { name: "Cotação", path: "/api/v2/currency" },
  { name: "Lista", path: "/api/v2/currency/available" }
]}
    codeExample={`const currency = await client.currency.retrieve('USD-BRL');
console.log(currency.currency[0].bidPrice);`}
    note="Múltiplos: ?currency=USD-BRL,EUR-BRL. Formato: ORIGEM-DESTINO."
  />
</DocsQuickInfo>

Atualmente, focado na listagem das moedas disponíveis para conversão ou consulta
de taxas de câmbio.





## Swagger Documentation

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

Single endpoint documentation for /api/v2/currency

## Base URLs

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

## GET /api/v2/currency

**Summary:** Obter Cotações de Câmbio


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


**Tags:** Câmbio

### Parameters

- **currency** (query)

### Responses

#### 200

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

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

## Schemas

The following schemas are used by this endpoint:

### CurrencyQuoteSimple

**Properties:**

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


### CurrencyResponseSimple

**Properties:**

- **currency** (array) *(required)*
  Array items:
    Reference to: **CurrencyQuoteSimple**

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