Tickers Disponíveis
Endpoint público para descoberta de tickers B3. Use antes dos endpoints de dados de mercado para encontrar o símbolo correto, montar autocomplete, validar entradas de usuário ou construir telas de screening.
O catálogo cobre instrumentos B3 em formato de ticker: ações, FIIs, ETFs, BDRs, units e índices. Opções, futuros, Tesouro Direto, cripto, câmbio e séries macro têm endpoints próprios.
Para dados por preocupação, use endpoints específicos, como /api/v2/fii/* ou
/api/v2/stocks/*. O endpoint legado /api/quote/list
continua funcionando, mas novas integrações devem preferir este formato v2.
Fluxo recomendado
- Use
/api/v2/tickerspara buscar e filtrar símbolos disponíveis. - Use
/api/v2/tickers/resolvese o usuário informou um ticker antigo. - Use
/api/v2/tickers/renamespara mostrar o histórico de mudança de código. - Use
/api/v2/tickers/coveragepara descobrir quais endpoints fazem sentido para cada símbolo antes de buscar dados de mercado.
Query Parameters
Busca textual por ticker, nome da empresa ou ticker antigo
Campo para ordenação
"volume""symbol" | "name" | "close" | "change" | "volume" | "marketCap"Direção da ordenação
"desc""asc" | "desc"Página (começa em 1)
10 <= valueItens por página. Máximo de 2000.
200 <= valueFiltra por setor
Filtra por tipo amplo do ativo
"stock" | "fund" | "bdr"Filtra por subtipo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr
"stock" | "unit" | "fii" | "etf" | "fi-infra" | "fi-agro" | "fip" | "fidc" | "bdr"Response Body
application/json
application/json
application/json
curl -X GET "https://brapi.dev/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",
"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"
],
"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
}{
"error": true,
"message": "Parâmetros inválidos",
"code": "BAD_REQUEST"
}{
"error": true,
"message": "Erro interno do servidor",
"code": "INTERNAL_SERVER_ERROR"
}