# Listar Moedas
URL: /docs/moedas/available.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 (embora o endpoint de cotação de moedas não esteja detalhado aqui, a listagem está disponível).

***

title: Listar 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 (embora o
endpoint de cotação de moedas não esteja detalhado aqui, a listagem está
disponível).
full: true
keywords: brapi, api, documentação, moedas
openGraph:
title: Listar 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 (embora o endpoint de cotação de moedas não esteja detalhado aqui, a
listagem está disponível).
type: website
locale: pt\_BR
lastUpdated: '2025-04-28T01:22:35.254Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/currency/available
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 a lista completa de todas as moedas fiduciárias suportadas
    pela API, geralmente utilizadas no parâmetro `currency` de outros
    endpoints (como o de criptomoedas) ou para futuras funcionalidades de
    conversão.

    ### Funcionalidade:

    * Retorna um array `currencies` com os nomes das moedas.

    * Pode ser filtrado usando o parâmetro `search`.

    ### Autenticação:

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

    ### Exemplo de Requisição:

    **Listar todas as moedas disponíveis:**

    ```bash

    curl -X GET
    "https://brapi.dev/api/v2/currency/available?token=SEU_TOKEN"

    ```

    **Buscar moedas cujo nome contenha 'Euro':**

    ```bash

    curl -X GET
    "https://brapi.dev/api/v2/currency/available?search=Euro&token=SEU_TOKEN"

    ```

    ### Resposta:

    A resposta é um objeto JSON com a chave `currencies`, contendo um
    array de objetos. Cada objeto possui uma chave `currency` com o nome
    completo da moeda (ex: `"Dólar Americano/Real Brasileiro"`). **Nota:**
    O formato do nome pode indicar um par de moedas, dependendo do
    contexto interno da API.
    heading: listar-todas-as-moedas-fiduciárias-disponíveis

***

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 (embora o endpoint de cotação de moedas não esteja detalhado
aqui, a listagem está disponível).





## Swagger Documentation

# Brapi - API do Mercado Financeiro Brasileiro - /api/v2/currency/available

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

## Base URLs

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

## GET /api/v2/currency/available

**Summary:** Listar Todas as Moedas Fiduciárias Disponíveis

Obtenha a lista completa de todas as moedas fiduciárias suportadas pela API, geralmente utilizadas no parâmetro `currency` de outros endpoints (como o de criptomoedas) ou para futuras funcionalidades de conversão.

### Funcionalidade:

*   Retorna um array `currencies` com os nomes das moedas.
*   Pode ser filtrado usando o parâmetro `search`.

### Autenticação:

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

### Exemplo de Requisição:

**Listar todas as moedas disponíveis:**

```bash
curl -X GET "https://brapi.dev/api/v2/currency/available?token=SEU_TOKEN"
```

**Buscar moedas cujo nome contenha 'Euro':**

```bash
curl -X GET "https://brapi.dev/api/v2/currency/available?search=Euro&token=SEU_TOKEN"
```

### Resposta:

A resposta é um objeto JSON com a chave `currencies`, contendo um array de objetos. Cada objeto possui uma chave `currency` com o nome completo da moeda (ex: `"Dólar Americano/Real Brasileiro"`). **Nota:** O formato do nome pode indicar um par de moedas, dependendo do contexto interno da API.

**Tags:** Moedas

### Parameters

- **search** (query): **Opcional.** Termo para filtrar a lista pelo nome da moeda (correspondência parcial, case-insensitive).
- **undefined** (undefined)

### Responses

#### 200

**Sucesso.** Retorna a lista de moedas disponíveis, possivelmente filtrada.

**Example Response:**

```json
{
  "currencies": [
    {
      "name": "USD-BRL",
      "currency": "Dólar Americano/Real Brasileiro"
    },
    {
      "name": "EUR-BRL",
      "currency": "Euro/Real Brasileiro"
    }
  ]
}
```

#### 401

#### 404

**Not Found.** Nenhuma moeda encontrada correspondendo ao critério de busca (`search`) informado.

**Example Response:**

```json
{
  "error": true,
  "message": "Currency not found"
}
```

## Schemas

The following schemas are used by this endpoint:

### CurrencyAvailableResponse

Resposta do endpoint que lista todas as moedas fiduciárias disponíveis.

**Properties:**

- **currencies** (array)
  Lista de objetos, cada um contendo o nome de uma moeda fiduciária ou par suportado pela API.
  Array items:
    **Properties:**

    - **currency** (string)
      Nome da moeda ou par de moedas suportado (ex: `Dólar Americano/Real Brasileiro`, `Euro/Real Brasileiro`). A sigla pode ser extraída deste nome ou consultada em documentação adicional.



### ErrorResponse

Schema padrão para respostas de erro da API.

**Properties:**

- **error** (boolean) *(required)*
  Indica se a requisição resultou em erro. Sempre `true` para este schema.

- **message** (string) *(required)*
  Mensagem descritiva do erro ocorrido.