# Cotação de Ações
URL: /docs/acoes/cotacao.mdx

Snapshot de cotação para ações, BDRs, ETFs, FIIs, units e índices B3 usando o padrão composável /api/v2/stocks.

***

title: Cotação de Ações
description: >-
Snapshot de cotação para ações, BDRs, ETFs, FIIs, units e índices B3 usando
o padrão composável /api/v2/stocks.
full: true
keywords: brapi, api, ações, cotação, stocks, quote, v2, b3
lang: pt-BR
\_openapi:
method: GET
route: /api/v2/stocks/quote
---------------------------

Endpoint para buscar apenas o snapshot de cotação de um ou mais tickers.
Use quando você precisa de preço atual, variação, volume, market cap, faixa do
dia, faixa de 52 semanas e logo, sem carregar módulos financeiros, dividendos
ou histórico.

Este endpoint segue o padrão composável: primeiro descubra ou valide o
ticker em `/api/v2/tickers`, depois consulte o dado de mercado específico em
`/api/v2/stocks/quote?symbols=PETR4,VALE3`.

Tickers antigos são resolvidos para o ticker atual quando houver renome
conhecido. A resposta inclui `requestedSymbol`, `symbol` e `changed` para o
cliente saber quando a brapi retornou outro ticker.





## Swagger Documentation

# brapi - API do Mercado Financeiro Brasileiro - /api/v2/stocks/quote

Single endpoint documentation for /api/v2/stocks/quote

## Base URLs

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

## GET /api/v2/stocks/quote

**Summary:** Cotações v2 de ações


Retorna apenas o snapshot de cotação para um ou mais tickers B3.

Use este endpoint quando você precisa de preço, variação, volume, market cap,
faixa do dia, faixa de 52 semanas e logo, sem carregar módulos financeiros,
histórico ou dividendos do endpoint legado `/api/quote/{tickers}`.

Este é o primeiro endpoint composável de ações em `/api/v2/stocks/*`. Para
descobrir tickers válidos, use `/api/v2/tickers`; para resolver tickers
antigos, use `/api/v2/tickers/resolve`.


**Tags:** Ações

### Parameters

- **symbols** (query) *required*

### Responses

#### 200

Cotações recuperadas com sucesso.

#### 400

Requisição inválida

#### 401

Não autorizado

#### 403

Acesso negado

#### 404

Não encontrado

#### 429

Limite de requisições excedido

#### 500

Erro interno do servidor

## Schemas

The following schemas are used by this endpoint:

### ErrorResponse

Erro interno do servidor

**Properties:**

- **error** (boolean) - Options: `true` *(required)*

- **message** (string) *(required)*

- **code** (string)


### StockQuoteResponse

**Properties:**

- **results** (array) *(required)*
  Array items:
    Reference to: **StockQuoteSeries**

- **requestedAt** (string, date-time) *(required)*
  Data e hora da requisição em formato ISO 8601

- **took** (integer) *(required)*
  Tempo de processamento em milissegundos


### StockQuoteSeries

**Properties:**

- **requestedSymbol** (string) *(required)*
  Ticker informado na requisição.

- **symbol** (string) *(required)*
  Ticker retornado pela brapi após normalização/renome.

- **changed** (boolean) *(required)*
  `true` quando o ticker informado foi resolvido para outro ticker.

- **data** *(required)*
  Reference to: **StockQuoteSnapshot**


### StockQuoteSnapshot

**Properties:**

- **shortName** (string) *(required)*

- **longName** (string) *(required)*

- **currency** (string) *(required)*

- **regularMarketPrice** (number) *(required)*

- **regularMarketDayHigh** (number) *(required)*

- **regularMarketDayLow** (number) *(required)*

- **regularMarketDayRange** (string) *(required)*

- **regularMarketChange** (number) *(required)*

- **regularMarketChangePercent** (number) *(required)*

- **regularMarketTime** (string) *(required)*
  Horário da cotação em ISO 8601.

- **marketCap** (number) *(nullable)* *(required)*

- **regularMarketVolume** (number) *(required)*

- **regularMarketPreviousClose** (number) *(required)*

- **regularMarketOpen** (number) *(required)*

- **fiftyTwoWeekRange** (string) *(required)*

- **fiftyTwoWeekLow** (number) *(required)*

- **fiftyTwoWeekHigh** (number) *(required)*

- **logourl** (string) *(required)*