BRbrapi-dev
Cotações

Listar ativos

Changed on

Lista de ações, FIIs, BDRs e ETFs com preço de fechamento, variação, volume, market cap, setor e logo de cada um. A resposta também traz os índices disponíveis.

Use para screeners, tabelas de mercado e busca de ativos com cotação.

search busca por parte do ticker ou do nome da empresa. Filtre por type, subType, sector e subsector. A ordem padrão é por volume, decrescente.

Sem limit, a resposta traz até 2.000 ativos e não traz os campos de paginação. Com limit, ela traz currentPage, totalPages, itemsPerPage, totalCount e hasNextPage.

availableSectors, availableSubsectors, availableStockTypes e availableSubTypeTypes listam os valores aceitos nos filtros.

Este endpoint não exige token. Para buscar e validar tickers, a lista de tickers traz uma resposta menor.

get/api/quote/list

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/quote/list
  • Auth
    none declared

Query parameters

searchstring

Parte do ticker ou do nome da empresa.

sortBy'name' | 'close' | 'change' | 'change_abs' | 'volume' | 'market_cap_basic'

Campo de ordenação. Padrão: volume.

sortOrder'asc' | 'desc'

Ordem. Padrão: desc.

limitstring

Itens por página. Máximo: 2000. Sem este parâmetro, a resposta traz até 2000 itens e não traz paginação.

pagestring

Número da página. Começa em 1.

sectorstring

Setor.

subsectorstring

Subsetor.

type'stock' | 'fund' | 'bdr'

Tipo do ativo.

subType'stock' | 'unit' | 'fii' | 'etf' | 'fi-infra' | 'fi-agro' | 'fip' | 'fidc' | 'bdr'

Subtipo do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr.

tokenstring

Token de acesso. Use no lugar do header Authorization.

Response

Lista de ativos retornada com sucesso.

availableSectorsstring[] required
availableSubsectorsstring[] 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"
  ],
  "availableSubsectors": [
    "Comércio",
    "Intermediários Financeiros"
  ],
  "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
}

Changes

  • 42aa75cac54dRevision changes
    • info

      added the new optional query request parameter subsector

    • info

      added the required property to the response with the status

    • info

      added the required property // to the response with the status

  • 9091a382a4b5Revision changes
    • info

      added the new optional query request parameter subType

    • info

      added the required property to the response with the status

    • info

      added the required property // to the response with the status