# 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).