Cotação de todas as ações
Endpoints para consulta de dados relacionados a ativos negociados na B3, como Ações, Fundos Imobiliários (FIIs), BDRs, ETFs e Índices (ex: IBOVESPA).
Permite buscar cotações atuais, dados históricos, informações fundamentalistas (via módulos) e listagens de ativos disponíveis.
Listar Ativos Disponíveis
Retorna uma lista paginada de todos os ativos disponíveis na API (Ações, FIIs, BDRs, ETFs, Índices). Use este endpoint para construir screeners, exploradores de ações ou para descobrir novos ativos.
Funcionalidades:
- Busca por Nome ou Ticker: Encontre ativos digitando "Petrobras", "PETR4" ou qualquer termo.
- Filtros por Tipo: Ações (stock), Fundos Imobiliários (fund), BDRs (bdr).
- Filtros por Setor: Energia, Financeiro, Tecnologia, Saúde, etc.
- Ordenação Flexível: Ordene por volume, preço, market cap ou nome.
- Paginação: Controle o número de resultados com
limitepage.
Autenticação:
Requer token Bearer. Obtenha seu token em brapi.dev/dashboard.
Exemplos de Requisição:
# Listar todos os ativos (primeiros 100)
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list"
# Buscar por nome ou ticker
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?search=petrobras"
# Filtrar por tipo e ordenar por volume
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?type=stock&sortBy=volume&sortOrder=desc&limit=10"
# Listar apenas FIIs de um setor específico
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?type=fund§or=Logística&limit=20"Parâmetros de Ordenação:
volume— Volume de negociação do diaclose— Preço de fechamentomarket_cap_basic— Capitalização de mercadoname— Nome da empresa (alfabético)
Tipos de Ativo:
stock— Ações (Ações ordinárias e preferenciais)fund— Fundos Imobiliários (FIIs) e ETFsbdr— BDRs (Brazilian Depositary Receipts)
Fonte dos Dados:
B3 (Bolsa de Valores do Brasil), TradingView
Plano Mínimo: Gratuito Autenticação: Necessária (Bearer Token)
Query Parameters
Termo de busca para filtrar ativos
Campo para ordenação
"name" | "close" | "change" | "change_abs" | "volume" | "market_cap_basic"Ordem de classificação
"asc" | "desc"Número máximo de resultados
Número da página (paginação)
Filtrar por setor
Filtrar por tipo de ativo
"stock" | "fund" | "bdr"Token de autenticação (alternativa ao header Authorization)
Response Body
application/json
application/json
curl -X GET "https://brapi.dev/api/quote/list"{
"indexes": [
{
"stock": "^BVSP",
"name": "IBOVESPA"
},
{
"stock": "^GSPC",
"name": "S&P 500"
}
],
"stocks": [
{
"stock": "PETR4",
"name": "PETR4",
"close": 36.65,
"change": -0.95,
"volume": 27681100,
"market_cap": 483937892568,
"sector": "Energy Minerals",
"type": "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",
"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"
],
"availableStockTypes": [
"stock",
"fund",
"bdr"
],
"currentPage": 1,
"totalPages": 50,
"itemsPerPage": 10,
"totalCount": 500,
"hasNextPage": true,
"requestedAt": "2026-02-08T16:25:29.000Z",
"took": 12
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}