# Cotação de todas as ações
URL: /docs/acoes/list.mdx

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.

***

title: Cotação de todas as ações
description: >-
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.
full: true
keywords: brapi, api, documentação, ações
openGraph:
title: Cotação de todas as ações
description: >-
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.
type: website
locale: pt\_BR
lastUpdated: '2025-04-28T01:22:35.251Z'
lang: pt-BR
\_openapi:
method: GET
route: /api/quote/list
toc:

* depth: 2
  title: Cotações de todas as ações, fundos, índices e BDRs
  url: '#cotacoes-de-todas-as-acoes-fundos-indices-e-bdrs'
  structuredData:
  headings:
  * content: Listar e Filtrar Cotações de Ativos
    id: cotacoes-de-todas-as-acoes-fundos-indices-e-bdrs
    contents:
  * content: >-
    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:**

    ```bash

    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:**

    ```bash

    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.
    heading: cotacoes-de-todas-as-acoes-fundos-indices-e-bdrs

***

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.





## Swagger Documentation

# Brapi - API do Mercado Financeiro Brasileiro - /api/quote/list

Single endpoint documentation for /api/quote/list

## Base URLs

- `https://brapi.dev` - Servidor principal da API Brapi
- `http://localhost:3000` - Servidor local para desenvolvimento

## GET /api/quote/list

**Summary:** 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:**

```bash
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:**

```bash
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.

**Tags:** Ações

### Parameters

- **search** (query): **Opcional.** Termo para buscar ativos por ticker (correspondência parcial). Ex: `PETR` encontrará `PETR4`, `PETR3`.
- **sortBy** (query): **Opcional.** Campo pelo qual os resultados serão ordenados.
- **sortOrder** (query): **Opcional.** Direção da ordenação: `asc` (ascendente) ou `desc` (descendente). Requer que `sortBy` seja especificado.
- **limit** (query): **Opcional.** Número máximo de ativos a serem retornados por página. O valor padrão pode variar.
- **page** (query): **Opcional.** Número da página dos resultados a ser retornada, considerando o `limit` especificado. Começa em 1.
- **type** (query): **Opcional.** Filtra os resultados por tipo de ativo.
- **sector** (query): **Opcional.** Filtra os resultados por setor de atuação da empresa. Utilize um dos valores retornados em `availableSectors`.
- **undefined** (undefined)

### Responses

#### 200

**Sucesso.** Retorna a lista paginada e filtrada de ativos, juntamente com metadados de paginação e filtros disponíveis.

#### 401

#### 417

**Expectation Failed.** Requisição malformada ou parâmetro inválido. Geralmente ocorre se um valor inválido for fornecido para `sortBy`, `sortOrder`, `type`, `sector` ou se `limit`/`page` não forem números inteiros positivos.

**Example Response:**

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

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Schema padrão para respostas de erro da API.

**Properties:**

- **error** (boolean) *(required)*
  Indica se a requisição resultou em erro. Sempre `true` para este schema.

- **message** (string) *(required)*
  Mensagem descritiva do erro ocorrido.


### IndexSummary

Resumo de informações de um índice, geralmente retornado em listas.

**Properties:**

- **stock** (string)
  Ticker do índice (ex: `^BVSP`).

- **name** (string)
  Nome do índice (ex: `IBOVESPA`).


### QuoteListResponse

Resposta do endpoint de listagem de cotações (`/api/quote/list`).

**Properties:**

- **indexes** (array)
  Lista resumida de índices relevantes (geralmente inclui IBOVESPA).
  Array items:
    Reference to: **IndexSummary**

- **stocks** (array)
  Lista paginada e filtrada dos ativos solicitados.
  Array items:
    Reference to: **StockSummary**

- **availableSectors** (array)
  Lista de todos os setores disponíveis que podem ser usados no parâmetro de filtro `sector`.
  Array items:
    **Type:** string


- **availableStockTypes** (array)
  Lista dos tipos de ativos (`stock`, `fund`, `bdr`) disponíveis que podem ser usados no parâmetro de filtro `type`.
  Array items:
    **Type:** string

    **Options:** `stock`, `fund`, `bdr`


- **currentPage** (integer)
  Número da página atual retornada nos resultados.

- **totalPages** (integer)
  Número total de páginas existentes para a consulta/filtros aplicados.

- **itemsPerPage** (integer)
  Número de itens (ativos) retornados por página (conforme `limit` ou padrão).

- **totalCount** (integer)
  Número total de ativos encontrados que correspondem aos filtros aplicados (sem considerar a paginação).

- **hasNextPage** (boolean)
  Indica se existe uma próxima página de resultados (`true`) ou se esta é a última página (`false`).


### StockSummary

Resumo de informações de um ativo (ação, FII, BDR), geralmente retornado em listas.

**Properties:**

- **stock** (string)
  Ticker do ativo (ex: `PETR4`, `MXRF11`).

- **name** (string)
  Nome do ativo ou empresa (ex: `PETROBRAS PN`).

- **close** (number, float)
  Preço de fechamento mais recente ou último preço negociado.

- **change** (number, float)
  Variação percentual do preço em relação ao fechamento anterior.

- **volume** (integer, int64)
  Volume financeiro negociado no último pregão ou dia atual.

- **market_cap** (number, float) *(nullable)*
  Capitalização de mercado (Preço x Quantidade de Ações). Pode ser nulo para FIIs ou outros tipos.

- **logo** (string, url)
  URL para a imagem do logo da empresa/ativo.

- **sector** (string) *(nullable)*
  Setor de atuação da empresa (ex: `Energy Minerals`, `Finance`). Pode ser nulo ou variar para FIIs.

- **type** (string) - Options: `stock`, `fund`, `bdr`
  Tipo do ativo: `stock` (Ação), `fund` (Fundo Imobiliário/FII), `bdr` (Brazilian Depositary Receipt).


