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

Preço, variação, volume e market cap de ações, FIIs, BDRs, ETFs, units e índices brasileiros, para um ou mais tickers por chamada.





## 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ção de ações


Preço, variação, volume, market cap, máxima e mínima do dia, faixa de 52 semanas e logo de ações, FIIs, BDRs, ETFs, units e índices brasileiros.

Use para telas de cotação, carteiras, alertas de preço e widgets.

Envie vários tickers em `symbols`, separados por vírgula. O número máximo de tickers por chamada depende do plano.

Quando alguns tickers não existem, eles ficam fora de `results`. Se nenhum ticker tem cotação, a resposta retorna 404.

Um ticker antigo é trocado pelo ticker atual. Nesse caso, `changed` é `true` e `requestedSymbol` guarda o ticker enviado.

AXIA5 e AXIA6 retornam a cotação de uma ação AXIA3. Consulte a resolução de tickers para ver a proporção de conversão.

Para a série de preços, use o [histórico de preços](https://brapi.dev/docs/acoes/historico). Para achar tickers válidos, use a [lista de tickers](https://brapi.dev/docs/tickers).


**Tags:** Ações

### Parameters

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

### Responses

#### 200

Cotações recuperadas com sucesso.

#### 400

Requisição inválida. Confira os parâmetros.

#### 401

Token ausente ou inválido.

#### 403

O plano não inclui este recurso ou parâmetro.

#### 404

Nenhum dado encontrado para o pedido.

#### 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 ISO 8601.

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


### StockQuoteSeries

**Properties:**

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

- **symbol** (string) *(required)*
  Ticker usado para os dados retornados.

- **changed** (boolean) *(required)*
  `true` quando `symbol` difere de `requestedSymbol`.

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