Ações

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 e Filtrar Cotações de Ativos

Obtenha uma lista paginada de cotações de diversos ativos (ações, FIIs, BDRs) negociados na B3, com opções avançadas de busca, filtragem e ordenação.

Funcionalidades:

  • Busca por Ticker: Filtre por parte do ticker usando search.
  • Filtragem por Tipo: Restrinja a lista a stock, fund (FII) ou bdr com o parâmetro type.
  • Filtragem por Setor: Selecione ativos de um setor específico usando sector.
  • Ordenação: Ordene os resultados por diversos campos (preço, variação, volume, etc.) usando sortBy e sortOrder.
  • Paginação: Controle o número de resultados por página (limit) e a página desejada (page).

Autenticação:

Requer token de autenticação via token (query) ou Authorization (header).

Exemplo de Requisição:

Listar as 10 ações do setor Financeiro com maior volume, ordenadas de forma decrescente:

curl -X GET "https://brapi.dev/api/quote/list?sector=Finance&sortBy=volume&sortOrder=desc&limit=10&page=1&token=SEU_TOKEN"

Buscar por ativos cujo ticker contenha 'ITUB' e ordenar por nome ascendente:

curl -X GET "https://brapi.dev/api/quote/list?search=ITUB&sortBy=name&sortOrder=asc&token=SEU_TOKEN"

Resposta:

A resposta contém a lista de stocks (e indexes relevantes), informações sobre os filtros aplicados, detalhes da paginação (currentPage, totalPages, itemsPerPage, totalCount, hasNextPage) e listas de setores (availableSectors) e tipos (availableStockTypes) disponíveis para filtragem.

GET
/api/quote/list
AuthorizationBearer <token>

Autenticação via header HTTP Authorization. Use o formato Authorization: Bearer SEU_TOKEN. Obtenha seu token.

In: header

Query Parameters

search?string

Opcional. Termo para buscar ativos por ticker (correspondência parcial). Ex: PETR encontrará PETR4, PETR3.

sortBy?string

Opcional. Campo pelo qual os resultados serão ordenados.

Value in"name" | "close" | "change" | "change_abs" | "volume" | "market_cap_basic" | "sector"
sortOrder?string

Opcional. Direção da ordenação: asc (ascendente) ou desc (descendente). Requer que sortBy seja especificado.

Value in"asc" | "desc"
limit?integer

Opcional. Número máximo de ativos a serem retornados por página. O valor padrão pode variar.

Range1 <= value
page?integer

Opcional. Número da página dos resultados a ser retornada, considerando o limit especificado. Começa em 1.

Range1 <= value
type?string

Opcional. Filtra os resultados por tipo de ativo.

Value in"stock" | "fund" | "bdr"
sector?string

Opcional. Filtra os resultados por setor de atuação da empresa. Utilize um dos valores retornados em availableSectors.

Value in"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"
token?string

Obrigatório caso não esteja adicionado como header "Authorization". Seu token de autenticação pessoal da API Brapi.

Formas de Envio:

  1. Query Parameter: Adicione ?token=SEU_TOKEN ao final da URL.
  2. HTTP Header: Inclua o header Authorization: Bearer SEU_TOKEN na sua requisição.

Ambos os métodos são aceitos, mas pelo menos um deles deve ser utilizado. Obtenha seu token em brapi.dev/dashboard.

Response Body

curl -X GET "https://brapi.dev/api/quote/list?search=string&sortBy=name&sortOrder=asc&limit=1&page=1&type=stock&sector=Retail+Trade&token=string"

{
  "indexes": [
    {
      "stock": "^BVSP",
      "name": "IBOVESPA"
    }
  ],
  "stocks": [
    {
      "stock": "PETR4",
      "name": "PETROBRAS PN",
      "close": 36.71,
      "change": 3.26,
      "volume": 87666300,
      "market_cap": 497695817728,
      "logo": "https://icons.brapi.dev/icons/PETR4.svg",
      "sector": "Energy Minerals",
      "type": "stock"
    }
  ],
  "availableSectors": [
    "Energy Minerals",
    "Finance",
    "..."
  ],
  "availableStockTypes": [
    "stock",
    "fund",
    "bdr"
  ],
  "currentPage": 1,
  "totalPages": 5,
  "itemsPerPage": 10,
  "totalCount": 45,
  "hasNextPage": true
}

{
  "error": true,
  "message": "O seu token é inválido, por favor, verifique o seu token em brapi.dev/dashboard"
}

{
  "error": true,
  "message": "Campo 'sortBy' inválido. sortBy válidos: name, close, change, change_abs, volume, market_cap_basic, sector"
}