---
title: "Listar tickers disponíveis"
method: GET
path: "/api/v2/tickers"
tags: ["Tickers"]
---

# Listar tickers disponíveis

`GET /api/v2/tickers`

Lista tickers e instrumentos B3 disponíveis na brapi usando o padrão v2.

Use este endpoint para descoberta de símbolos, autocomplete, validação de ticker
e telas de screening. Ele substitui gradualmente `/api/quote/list` para novas
integrações, mas não retorna módulos, dividendos ou histórico completo. Para
dados de mercado de ações em novas integrações, use os endpoints composáveis
`/api/v2/stocks/*`. Para FIIs, use `/api/v2/fii/*`.

### Escopo

Este catálogo cobre instrumentos B3 em formato de ticker: ações, FIIs, ETFs,
BDRs, units e índices. Não inclui opções, futuros, Tesouro Direto, cripto,
câmbio ou séries macroeconômicas, que possuem endpoints próprios.

### Exemplos

```bash
curl "https://brapi.dev/api/v2/tickers?search=PETR&limit=10"
curl "https://brapi.dev/api/v2/tickers?type=fund&subType=fii&limit=20"
curl "https://brapi.dev/api/v2/tickers?sortBy=volume&sortOrder=desc&limit=10"
```

**Plano mínimo:** Gratuito
**Autenticação:** Não necessária

## Query parameters

- `search` string — Busca textual por ticker, nome da empresa ou ticker antigo
- `sortBy` 'symbol' | 'name' | 'close' | 'change' | 'volume' | 'marketCap' — Campo para ordenação
- `sortOrder` 'asc' | 'desc' — Direção da ordenação
- `page` integer — Página (começa em 1)
- `limit` integer — Itens por página. Máximo de 2000.
- `sector` string — Filtra por setor
- `type` 'stock' | 'fund' | 'bdr' — Filtra por tipo amplo do ativo
- `subType` 'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr' — Filtra por subtipo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr

## Response `200`

Lista de tickers retornada com sucesso.

- TickerListResponse
  - `results` TickerListItem[], required
    - `symbol` string, required — Ticker público do ativo na B3
    - `name` string, required — Nome de exibição do ativo
    - `longName` string, nullable, required — Nome longo quando disponível
    - `assetType` 'stock' | 'fund' | 'bdr', nullable, required — Tipo amplo do ativo
    - `subType` 'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr', nullable, required — Classificação aditiva do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr
    - `exchange` 'B3', required — Bolsa de negociação
    - `currency` 'BRL', required — Moeda de negociação
    - `sector` string, nullable, required — Setor quando disponível
    - `isActive` boolean, required — Indica se o ativo aparece no catálogo ativo atual
    - `logoUrl` string, nullable, required — URL do logo quando disponível
    - `quote` TickerQuoteSummary, required
      - `lastPrice` number, nullable, required — Último preço disponível para listagem/screening
      - `changePercent` number, nullable, required — Variação percentual do último snapshot disponível
      - `volume` number, nullable, required — Volume negociado do último snapshot disponível
      - `marketCap` number, nullable, required — Capitalização de mercado quando disponível
  - `indexes` TickerIndexItem[], required
    - `symbol` string, required
    - `name` string, required
    - `exchange` 'B3', required
    - `assetType` 'index', required
  - `facets` TickerFacets, required
    - `sectors` string[], required — Setores disponíveis para filtro
    - `assetTypes` string[], required — Tipos amplos disponíveis para filtro
    - `subTypes` string[], required — Subtipos disponíveis para filtro
  - `pagination` TickerPagination, required
    - `page` number, required
    - `limit` number, required
    - `totalItems` number, required
    - `totalPages` number, required
    - `hasNextPage` boolean, 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
- `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)