---
title: "Listar Ativos Disponíveis"
method: GET
path: "/api/quote/list"
tags: ["Cotações"]
---

# Listar Ativos Disponíveis

`GET /api/quote/list`

Retorna uma lista paginada de todos os ativos disponíveis na API (Ações, FIIs, BDRs, ETFs, Índices). Use este endpoint para construir screeners, exploradores de ações ou para descobrir novos ativos.

### Funcionalidades:
*   **Busca por Nome ou Ticker:** Encontre ativos digitando "Petrobras", "PETR4" ou qualquer termo.
*   **Filtros por Tipo:** Ações (stock), Fundos Imobiliários (fund), BDRs (bdr).
*   **Filtros por Subtipo:** Units, FIIs, ETFs, FI-Infra, FI-Agro, FIPs, FIDCs e BDRs via `subType`.
*   **Filtros por Setor:** Energia, Financeiro, Tecnologia, Saúde, etc.
*   **Ordenação Flexível:** Ordene por volume, preço, market cap ou nome.
*   **Paginação:** Controle o número de resultados com `limit` e `page`.

### Autenticação:
Requer token Bearer. Obtenha seu token em [brapi.dev/dashboard](https://brapi.dev/dashboard).

### Exemplos de Requisição:
```bash
# Listar todos os ativos (primeiros 100)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list"

# Buscar por nome ou ticker
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?search=petrobras"

# Filtrar por tipo e ordenar por volume
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?type=stock&sortBy=volume&sortOrder=desc&limit=10"

# Filtrar por subtipo
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?subType=fi-agro&limit=10"

# Listar apenas FIIs de um setor específico
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?type=fund&sector=Logística&limit=20"
```

### Parâmetros de Ordenação:
*   `volume` — Volume de negociação do dia
*   `close` — Preço de fechamento
*   `market_cap_basic` — Capitalização de mercado
*   `name` — Nome da empresa (alfabético)

### Tipos de Ativo:
*   `stock` — Ações (Ações ordinárias e preferenciais)
*   `fund` — Fundos Imobiliários (FIIs) e ETFs
*   `bdr` — BDRs (Brazilian Depositary Receipts)

**Plano Mínimo:** Gratuito
**Autenticação:** Necessária (Bearer Token)

## Query parameters

- `search` string — Termo de busca para filtrar ativos
- `sortBy` 'name' | 'close' | 'change' | 'change_abs' | 'volume' | 'market_cap_basic' — Campo para ordenação
- `sortOrder` 'asc' | 'desc' — Ordem de classificação
- `limit` string — Número máximo de resultados
- `page` string — Número da página (paginação)
- `sector` string — Filtrar por setor
- `type` 'stock' | 'fund' | 'bdr' — Filtrar por tipo de ativo
- `subType` 'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr' — Filtrar por classificação aditiva: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr
- `token` string — Token de autenticação (alternativa ao header Authorization)

## Response `200`

Lista de ativos retornada com sucesso.

- QuoteListResponse
  - `indexes` object[], required
    - `stock` string, required
    - `name` string, required
  - `stocks` QuoteListItem[], required
    - `stock` string, required — Ticker do ativo
    - `name` string, required — Nome da empresa
    - `close` number, nullable, required — Preço de fechamento
    - `change` number, nullable, required — Variação percentual
    - `volume` number, nullable, required — Volume negociado
    - `market_cap` number, nullable, required — Capitalização de mercado
    - `logo` string, nullable, required — URL do logo
    - `sector` string, nullable, required — Setor
    - `type` string, nullable, required — Tipo do ativo
    - `subType` string, nullable, required — Classificação aditiva do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr
  - `availableSectors` string[], required
  - `availableStockTypes` string[], required
  - `availableSubTypeTypes` string[], required
  - `currentPage` number
  - `totalPages` number
  - `itemsPerPage` number
  - `totalCount` number
  - `hasNextPage` boolean

## Other responses

- `500` — Erro interno do servidor

---

[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/versions/f275d46193ea/schema)