v20

latestOpenAPI 3.1.0MITraw.githubusercontent.com2026-07-2176162684.2 KB
Ações

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.

get/api/v2/stocks/quote

Query parameters

symbolsstring required

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

Example:PETR4,VALE3

Response

Cotações recuperadas com sucesso.

requestedAtstring date-time required

Data e hora da requisição em formato ISO 8601

tookinteger required

Tempo de processamento em milissegundos

Example response

{
  "results": [
    {
      "requestedSymbol": "PETR4",
      "symbol": "PETR4",
      "changed": false,
      "data": {
        "shortName": "PETROBRAS   PN  EX  N2",
        "longName": "Petróleo Brasileiro S.A. - Petrobras",
        "currency": "BRL",
        "regularMarketPrice": 41.18,
        "regularMarketDayHigh": 41.53,
        "regularMarketDayLow": 40.82,
        "regularMarketDayRange": "40.82 - 41.53",
        "regularMarketChange": -0.58,
        "regularMarketChangePercent": -1.39,
        "regularMarketTime": "2026-06-14T05:15:42.000Z",
        "marketCap": null,
        "regularMarketVolume": 34024700,
        "regularMarketPreviousClose": 41.76,
        "regularMarketOpen": 41.18,
        "fiftyTwoWeekRange": "29.31 - 50.69",
        "fiftyTwoWeekLow": 29.31,
        "fiftyTwoWeekHigh": 50.69,
        "logourl": "https://icons.brapi.dev/icons/PETR4.svg"
      }
    }
  ],
  "requestedAt": "2026-06-14T05:03:16.000Z",
  "took": 286
}