---
title: "Listar ativos"
method: GET
path: "/api/quote/list"
tags: ["Cotações"]
---

# Listar ativos

`GET /api/quote/list`

## Request

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

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](https://brapi.dev/docs/tickers) traz uma resposta menor.

## Query parameters

- `search` string: 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.
- `limit` string: Itens por página. Máximo: 2000. Sem este parâmetro, a resposta traz até 2000 itens e não traz paginação.
- `page` string: Número da página. Começa em 1.
- `sector` string: Setor.
- `subsector` string: 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.
- `token` string: Token de acesso. Use no lugar do header `Authorization`.

## Response `200`

Lista de ativos retornada com sucesso.

- QuoteListResponse
  - `indexes` object[], required
    - `stock` string, required
    - `name` string, required
  - `stocks` QuoteListItem[], required
    - `stock` string, required: Ticker do ativo.
    - `name` string, required: Nome da empresa.
    - `close` number, nullable, required: Último preço.
    - `change` number, nullable, required: Variação no dia, em porcentagem.
    - `volume` number, nullable, required: Volume negociado.
    - `market_cap` number, nullable, required: Valor de mercado, em reais.
    - `logo` string, nullable, required: URL do logo.
    - `sector` string, nullable, required: Setor.
    - `subsector` string, nullable, required: Subsetor.
    - `type` string, nullable, required: Tipo do ativo.
    - `subType` string, nullable, required: Subtipo do ativo: stock, unit, fii, etf, fi-infra, fi-agro, fip, fidc ou bdr.
  - `availableSectors` string[], required
  - `availableSubsectors` string[], required
  - `availableStockTypes` string[], required
  - `availableSubTypeTypes` string[], required
  - `currentPage` number
  - `totalPages` number
  - `itemsPerPage` number
  - `totalCount` number
  - `hasNextPage` boolean

## Other responses

- `500`: Erro interno do servidor.

## Changes

- **2026-07-15** `42aa75cac54d`: 3 info
  - added the new optional `query` request parameter `subsector`
  - added the required property `availableSubsectors` to the response with the `200` status
  - added the required property `stocks/items/subsector` to the response with the `200` status
- **2026-05-28** `9091a382a4b5`: 3 info
  - added the new optional `query` request parameter `subType`
  - added the required property `availableSubTypeTypes` to the response with the `200` status
  - added the required property `stocks/items/subType` to the response with the `200` status
- **2026-04-07** `19f807c15a24`: 35 breaking, 29 info
  - removed the enum value `Commercial Services` from the `query` request parameter `sector`
  - removed the enum value `Communications` from the `query` request parameter `sector`
  - removed the enum value `Consumer Durables` from the `query` request parameter `sector`
  - removed the enum value `Consumer Non-Durables` from the `query` request parameter `sector`
  - …60 more

[Operation history](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/changes/api/quote/list/get.md)

---

[API](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) - [All operations](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) - [OpenAPI document](https://skmtc.dev/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/revisions/7c732d79148a?raw)