Ações
Listar e filtrar ativos da B3
Carregando conteúdo...
FOR LLMs: add .md to any documentation URL to get the page as Markdown. Example: /docs/acoes/dividendos.md. The index of all pages is at /llms.txt.
Carregando documentação...
Lista de ações, FIIs, BDRs e ETFs com preço de fechamento, variação, volume, market cap, setor e logo de cada um. A resposta também traz os índices disponíveis.
Use para screeners, tabelas de mercado e busca de ativos com cotação.
search busca por parte do ticker ou do nome da empresa. Filtre por type, subType, sector e subsector. A ordem padrão é por volume, decrescente.
Sem limit, a resposta traz até 2.000 ativos e não traz os campos de paginação. Com limit, ela traz currentPage, totalPages, itemsPerPage, totalCount e hasNextPage.
availableSectors, availableSubsectors, availableStockTypes e availableSubTypeTypes listam os valores aceitos nos filtros.
Este endpoint não exige token. Para buscar e validar tickers, a lista de tickers traz uma resposta menor.
Parte do ticker ou do nome da empresa.
Campo de ordenação. Padrão: volume.
Value in
Ordem. Padrão: desc.
Value in
Itens por página. Máximo: 2000. Sem este parâmetro, a resposta traz até 2000 itens e não traz paginação.
Número da página. Começa em 1.
Setor.
Subsetor.
Tipo do ativo.
Value in
Subtipo do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr.
Value in
Token de acesso. Use no lugar do 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}