---
title: "Cotações v2 de ações"
method: GET
path: "/api/v2/stocks/quote"
tags: ["Ações"]
---

# Cotações v2 de ações

`GET /api/v2/stocks/quote`

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

## Query parameters

- `symbols` string, required — Tickers separados por vírgula. Ex.: PETR4,VALE3. Tickers antigos são resolvidos para o ticker atual quando houver renome conhecido.

## Response `200`

Cotações recuperadas com sucesso.

- StockQuoteResponse
  - `results` StockQuoteSeries[], required
    - `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` StockQuoteSnapshot, required
      - `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
  - `requestedAt` string, date-time, required — Data e hora da requisição em formato ISO 8601
  - `took` integer, required — Tempo de processamento em milissegundos

## Other responses

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

---

[API](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro.md) · [All operations](https://skmtc.net/brapi-dev/apis/brapi-api-do-mercado-financeiro-brasileiro/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brapi-dev/brapi-api-do-mercado-financeiro-brasileiro/versions/f275d46193ea/schema)