# Tickers Disponíveis
URL: /docs/tickers.mdx

Descubra, filtre e valide tickers B3 disponíveis na brapi usando o padrão v2. Ideal para busca, autocomplete, screeners e seleção de símbolos antes de consultar dados de mercado.

***

title: Tickers Disponíveis
description: >-
Descubra, filtre e valide tickers B3 disponíveis na brapi usando o padrão
v2. Ideal para busca, autocomplete, screeners e seleção de símbolos antes de
consultar dados de mercado.
full: true
keywords: brapi, api, tickers, ações, fiis, etfs, bdrs, b3, símbolos
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/tickers
----------------------

Endpoint **público** para descoberta de tickers B3. Use antes dos endpoints de
dados de mercado para encontrar o símbolo correto, montar autocomplete, validar
entradas de usuário ou construir telas de screening.

O catálogo cobre instrumentos B3 em formato de ticker: ações, FIIs, ETFs, BDRs,
units e índices. Opções, futuros, Tesouro Direto, cripto, câmbio e séries macro
têm endpoints próprios.

Para dados por preocupação, use endpoints específicos, como `/api/v2/fii/*` ou
`/api/v2/stocks/*`. O endpoint legado `/api/quote/list`
continua funcionando, mas novas integrações devem preferir este formato v2.

## Fluxo recomendado

1. Use `/api/v2/tickers` para buscar e filtrar símbolos disponíveis.
2. Use `/api/v2/tickers/resolve` se o usuário informou um ticker antigo.
3. Use `/api/v2/tickers/renames` para mostrar o histórico de mudança de código.
4. Use `/api/v2/tickers/coverage` para descobrir quais endpoints fazem sentido
   para cada símbolo antes de buscar dados de mercado.





## Swagger Documentation

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

Single endpoint documentation for /api/v2/tickers

## Base URLs

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

## GET /api/v2/tickers

**Summary:** Listar tickers disponíveis


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


**Tags:** Tickers

### Parameters

- **search** (query)
- **sortBy** (query)
- **sortOrder** (query)
- **page** (query)
- **limit** (query)
- **sector** (query)
- **type** (query)
- **subType** (query)

### Responses

#### 200

Lista de tickers retornada com sucesso.

#### 400

Requisição inválida

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### TickerFacets

**Properties:**

- **sectors** (array) *(required)*
  Setores disponíveis para filtro
  Array items:
    **Type:** string


- **assetTypes** (array) *(required)*
  Tipos amplos disponíveis para filtro
  Array items:
    **Type:** string


- **subTypes** (array) *(required)*
  Subtipos disponíveis para filtro
  Array items:
    **Type:** string



### TickerIndexItem

**Properties:**

- **symbol** (string) *(required)*

- **name** (string) *(required)*

- **exchange** (string) - Options: `B3` *(required)*

- **assetType** (string) - Options: `index` *(required)*


### TickerListItem

**Properties:**

- **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** (string) - Options: `stock`, `fund`, `bdr` *(nullable)* *(required)*
  Tipo amplo do ativo

- **subType** (string) - Options: `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** (string) - Options: `B3` *(required)*
  Bolsa de negociação

- **currency** (string) - Options: `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** *(required)*
  Reference to: **TickerQuoteSummary**


### TickerListResponse

**Properties:**

- **results** (array) *(required)*
  Array items:
    Reference to: **TickerListItem**

- **indexes** (array) *(required)*
  Array items:
    Reference to: **TickerIndexItem**

- **facets** *(required)*
  Reference to: **TickerFacets**

- **pagination** *(required)*
  Reference to: **TickerPagination**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### TickerPagination

**Properties:**

- **page** (number) *(required)*

- **limit** (number) *(required)*

- **totalItems** (number) *(required)*

- **totalPages** (number) *(required)*

- **hasNextPage** (boolean) *(required)*


### TickerQuoteSummary

**Properties:**

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