Cotações
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 Subtipo: Units, FIIs, ETFs, FI-Infra, FI-Agro, FIPs, FIDCs e BDRs via subType.
- 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 limit e page.
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"
# Filtrar por subtipo
curl -H "Authorization: Bearer SEU_TOKEN" "https://brapi.dev/api/quote/list?subType=fi-agro&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 dia
- close — Preço de fechamento
- market_cap_basic — Capitalização de mercado
- name — Nome da empresa (alfabético)
Tipos de Ativo:
- stock — Ações (Ações ordinárias e preferenciais)
- fund — Fundos Imobiliários (FIIs) e ETFs
- bdr — BDRs (Brazilian Depositary Receipts)
Plano Mínimo: Gratuito Autenticação: Necessária (Bearer Token)
get/api/quote/list
Query parameters
searchstring
Termo de busca para filtrar ativos
sortBy'name' | 'close' | 'change' | 'change_abs' | 'volume' | 'market_cap_basic'
Campo para ordenação
sortOrder'asc' | 'desc'
Ordem de classificação
limitstring
Número máximo de resultados
pagestring
Número da página (paginação)
sectorstring
Filtrar por setor
type'stock' | 'fund' | 'bdr'
Filtrar por tipo de ativo
subType'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr'
Filtrar por classificação aditiva: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr
tokenstring
Token de autenticação (alternativa ao header Authorization)
Response
Lista de ativos retornada com sucesso.
Example response
{
"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"
],
"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
}