v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB
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&sector=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.

availableSectorsstring[] required
availableStockTypesstring[] required
availableSubTypeTypesstring[] required
currentPagenumber
totalPagesnumber
itemsPerPagenumber
totalCountnumber
hasNextPageboolean

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
}