Catálogo público de tickers da B3. Use para achar o símbolo certo, montar autocomplete, validar o que o usuário digitou ou popular uma tela de screening.
A cobertura inclui ações, FIIs, ETFs, BDRs, units e os índices que a API disponibiliza. A lista de índices é limitada. Opções, futuros, Tesouro Direto, cripto, câmbio e séries macro têm endpoints próprios.
Este endpoint devolve identidade e metadados, não cotação. Para dados de
mercado, siga para /api/v2/stocks/* ou /api/v2/fii/*. O legado
/api/quote/list continua funcionando, mas devolve muito mais do que uma busca
precisa.
Os índices aparecem na coleção indexes da resposta. O filtro type aceita
stock, fund e bdr; ele não aceita index.
| Você quer | Chame |
|---|---|
| Buscar e filtrar símbolos | /api/v2/tickers |
| Normalizar um ticker antigo | /api/v2/tickers/resolve |
| Mostrar o histórico de mudança de código | /api/v2/tickers/renames |
| Saber quais endpoints servem para um ativo | /api/v2/tickers/coverage |
Busca textual por ticker, nome da empresa ou ticker antigo
Campo para ordenação
"volume"Value in
Direção da ordenação
"desc"Value in
Página (começa em 1)
0 <= value1Itens por página. Máximo de 2000.
0 <= value20Filtra por setor
Filtra pelo subsetor B3
Filtra por tipo amplo do ativo
Value in
Filtra por subtipo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr
Value in
application/json
application/json
application/json
curl -X GET "https://example.com/api/v2/tickers"{ "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", "subsector": "Petróleo, Gás e Biocombustíveis", "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": { "sectors": [ "string" ], "subsectors": [ "string" ], "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}