Lista paginada de ativos da B3 com a cotação de cada um. É o endpoint para montar um screener, uma tabela de mercado ou um autocomplete de busca.
Filtre por parte do ticker com search, por setor com sector e por tipo com
type (stock, fund ou bdr). Ordene com sortBy e sortOrder, e pagine
com page e limit.
curl -H "Authorization: Bearer SEU_TOKEN" \
"https://brapi.dev/api/quote/list?sector=Finance&sortBy=volume&sortOrder=desc&limit=10"A resposta traz stocks, os indexes relevantes e os dados de paginação em
currentPage, totalPages, itemsPerPage, totalCount e hasNextPage. Ela
também devolve availableSectors e availableStockTypes, então você monta os
filtros da sua interface a partir da própria resposta, sem manter uma lista
fixa no seu código.
Para buscar e validar símbolos sem carregar cotação, /api/v2/tickers
é mais leve e mais rápido.
Termo de busca para filtrar ativos
Campo para ordenação
Value in
Ordem de classificação
Value in
Número máximo de resultados
Número da página (paginação)
Filtrar por setor
Filtrar pelo subsetor B3
Filtrar por tipo de ativo
Value in
Filtrar por classificação aditiva: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr
Value in
Token de autenticação (alternativa ao header Authorization)
application/json
application/json
curl -X GET "https://example.com/api/quote/list"{ "indexes": [ { "stock": "^BVSP", "name": "IBOVESPA" }, { "stock": "IFIX.SA", "name": "Índice de Fundos Imobiliários" } ], "stocks": [ { "stock": "PETR4", "name": "PETR4", "close": 36.65, "change": -0.95, "volume": 27681100, "market_cap": 483937892568, "sector": "Energy Minerals", "type": "stock", "subType": "stock", "logo": "https://icons.brapi.dev/icons/PETR4.svg" }, { "stock": "VALE3", "name": "VALE3", "close": 52.89, "change": -1.23, "volume": 18543200, "market_cap": 229876543210, "sector": "Non-Energy Minerals", "type": "stock", "subType": "stock", "logo": "https://icons.brapi.dev/icons/VALE3.svg" } ], "availableSectors": [ "Retail Trade", "Energy Minerals", "Health Services", "Utilities", "Finance", "Consumer Services", "Consumer Non-Durables", "Non-Energy Minerals", "Commercial Services", "Distribution Services", "Transportation", "Technology Services", "Process Industries", "Communications", "Producer Manufacturing", "Miscellaneous", "Electronic Technology", "Industrial Services", "Health Technology", "Consumer Durables" ], "availableSubsectors": [ "Comércio", "Intermediários Financeiros" ], "availableStockTypes": [ "stock", "fund", "bdr" ], "availableSubTypeTypes": [ "stock", "unit", "fii", "etf", "fi-infra", "fi-agro", "fip", "fidc", "bdr" ], "currentPage": 1, "totalPages": 50, "itemsPerPage": 10, "totalCount": 500, "hasNextPage": true, "requestedAt": "2026-02-08T16:25:29.000Z", "took": 12}