Sign in

v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB
Tickers

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

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

get/api/v2/tickers

Query parameters

searchstring

Busca textual por ticker, nome da empresa ou ticker antigo

Example:PETR
sortBy'symbol' | 'name' | 'close' | 'change' | 'volume' | 'marketCap'

Campo para ordenação

Example:volume
sortOrder'asc' | 'desc'

Direção da ordenação

Example:desc
pageinteger

Página (começa em 1)

Example:1
limitinteger

Itens por página. Máximo de 2000.

Example:20
sectorstring

Filtra por setor

Example:Finance
type'stock' | 'fund' | 'bdr'

Filtra por tipo amplo do ativo

Example:stock
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

Example:fii

Response

Lista de tickers retornada com sucesso.

requestedAtstring date-time required

Data e hora da requisição em formato ISO 8601

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "results": [
    {
      "symbol": "PETR4",
      "name": "Petróleo Brasileiro S.A.",
      "longName": "Petroleo Brasileiro SA Petrobras Preference Shares",
      "assetType": "stock",
      "subType": "stock",
      "exchange": "B3",
      "currency": "BRL",
      "sector": "Energy Minerals",
      "isActive": true,
      "logoUrl": "https://icons.brapi.dev/icons/PETR4.svg",
      "quote": {
        "lastPrice": 36.65,
        "changePercent": -0.95,
        "volume": 27681100,
        "marketCap": 483937892568
      }
    }
  ],
  "indexes": [
    {
      "symbol": "^BVSP",
      "name": "IBOVESPA",
      "exchange": "B3",
      "assetType": "index"
    }
  ],
  "facets": {
    "assetTypes": [
      "stock",
      "fund",
      "bdr"
    ],
    "subTypes": [
      "stock",
      "unit",
      "fii",
      "etf",
      "bdr"
    ]
  },
  "pagination": {
    "page": 1,
    "limit": 20,
    "totalItems": 2302,
    "totalPages": 116,
    "hasNextPage": true
  },
  "requestedAt": "2025-01-24T17:32:38.000Z",
  "took": 45
}