---
title: "Listar tickers da B3"
method: GET
path: "/api/v2/tickers"
tags: ["Tickers"]
---

# Listar tickers da B3

`GET /api/v2/tickers`

## Request

- Base URL: `https://brapi.dev`
- URL: `https://brapi.dev/api/v2/tickers`
- Auth: none declared

Lista de tickers brasileiros com nome, tipo, setor, logo e um resumo da cotação: ações, FIIs, ETFs, BDRs e units. Os índices vêm em `indexes`.

Use para busca, autocomplete, validação de tickers e screeners.

`search` busca por parte do ticker, do nome da empresa ou de um ticker antigo. O filtro `type` aceita `stock`, `fund` e `bdr`. `facets` lista os valores aceitos nos filtros.

A lista não tem opções, futuros, Tesouro Direto, criptomoedas, câmbio nem indicadores econômicos. Esses dados têm endpoints próprios.

Não exige token. Para cotação completa, use a [cotação de ações](https://brapi.dev/docs/acoes/cotacao).

## Query parameters

- `search` string: Parte do ticker, do nome da empresa ou de um ticker antigo.
- `sortBy` 'symbol' | 'name' | 'close' | 'change' | 'volume' | 'marketCap': Campo de ordenação.
- `sortOrder` 'asc' | 'desc': Ordem.
- `page` integer: Número da página. Começa em 1.
- `limit` integer: Itens por página. Máximo: 2000.
- `sector` string: Setor.
- `subsector` string: Subsetor.
- `type` 'stock' | 'fund' | 'bdr': Tipo do ativo. Índices não entram neste filtro.
- `subType` 'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr': Subtipo do ativo: 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 do ativo.
    - `name` string, required: Nome da empresa ou do fundo.
    - `longName` string, nullable, required: Nome longo. Pode ser nulo.
    - `assetType` 'stock' | 'fund' | 'bdr', nullable, required: Tipo do ativo.
    - `subType` 'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr', nullable, required: Subtipo do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr.
    - `exchange` 'B3', required: Bolsa.
    - `currency` 'BRL', required: Moeda.
    - `sector` string, nullable, required: Setor. Pode ser nulo.
    - `subsector` string, nullable, required: Subsetor. Pode ser nulo.
    - `isActive` boolean, required: `true` quando o ativo está em negociação.
    - `logoUrl` string, nullable, required: URL do logo.
    - `quote` TickerQuoteSummary, required
      - `lastPrice` number, nullable, required: Último preço.
      - `changePercent` number, nullable, required: Variação no dia, em porcentagem.
      - `volume` number, nullable, required: Volume negociado no dia.
      - `marketCap` number, nullable, required: Valor de mercado, em reais. Pode ser nulo.
  - `indexes` TickerIndexItem[], required
    - `symbol` string, required
    - `name` string, required
    - `exchange` 'B3', required
    - `assetType` 'index', required
  - `facets` TickerFacets, required
    - `sectors` string[], required: Valores aceitos em `sector`.
    - `subsectors` string[], required: Valores aceitos em `subsector`.
    - `assetTypes` string[], required: Valores aceitos em `type`.
    - `subTypes` string[], required: Valores aceitos em `subType`.
  - `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 ISO 8601.
  - `took` integer, required: Tempo de processamento, em milissegundos.

## Other responses

- `400`: Requisição inválida. Confira os parâmetros.
- `500`: Erro interno do servidor.

## Changes

- **2026-07-15** `42aa75cac54d`: 3 info
  - added the new optional `query` request parameter `subsector`
  - added the required property `facets/subsectors` to the response with the `200` status
  - added the required property `results/items/subsector` to the response with the `200` status
- **2026-06-15** `73e0f61e068f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/v2/tickers/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)