Ações

Histórico de preços de ações

Changed on

Série de preços por pregão com abertura, máxima, mínima, fechamento, fechamento ajustado e volume. Serve para ações, FIIs, BDRs, ETFs, units e índices com histórico.

Use para gráficos, backtests e cálculo de retorno.

Em conversões de ações, use o ticker original para consultar o histórico daquela classe. Por exemplo, AXIA6 mantém seu próprio histórico.

LCAM3 e BRFS3 também mantêm históricos próprios, separados de RENT3 e MBRF3. PRGA3 usa a série de BRFS3. MRFG3 usa MBRF3.

O histórico disponível pode ser consultado mesmo quando o ticker não tem cotação atual.

Defina a janela com range e interval, por exemplo range=1y&interval=1d, ou com startDate e endDate. O padrão é range=1mo e interval=1d.

O plano define os valores aceitos em range e interval e o tamanho máximo da janela por data. Um pedido acima do limite do plano retorna erro 400.

Em intervalos diários, open, high, low e close podem vir ajustados. Nesses pontos, close coincide com adjustedClose. Outros pontos podem trazer close sem ajuste ou adjustedClose nulo. Os campos raw*, quando disponíveis, trazem os preços originais.

Use adjustedClose para calcular retorno diário. Ele considera proventos, desdobramentos e grupamentos.

includeRaw=true exige o plano Pro. Em intervalos diários, ele adiciona rawOpen, rawHigh, rawLow e rawClose, os preços originais sem ajuste. Esses campos podem ser nulos. Intervalos intradiários não trazem campos raw*.

get/api/v2/stocks/historical

Request

  • Base URL
    https://brapi.dev
  • URL
    https://brapi.dev/api/v2/stocks/historical
  • Auth
    HTTP bearer

Query parameters

symbolsstring required

Tickers separados por vírgula. Ex.: PETR4,VALE3. requestedSymbol identifica o ticker enviado e symbol identifica os dados retornados.

Example:PETR4,VALE3
range'1d' | '2d' | '5d' | '7d' | '1mo' | '3mo' | '6mo' | '1y' | '2y' | '5y' | '10y' | 'ytd' | 'max'

Janela relativa. Padrão: 1mo.

Example:1y
interval'1m' | '2m' | '5m' | '15m' | '30m' | '60m' | '90m' | '1h' | '1d' | '5d' | '1wk' | '1mo' | '3mo'

Intervalo entre os pontos. Padrão: 1d.

Example:1d
startDatestring

Data inicial no formato YYYY-MM-DD.

Example:2024-01-01
endDatestring

Data final no formato YYYY-MM-DD. Sem startDate, range conta para trás a partir desta data.

Example:2024-12-31
sortOrder'asc' | 'desc'

Ordem dos pontos por data.

Example:desc
includeRaw'true' | 'false'

Inclui os preços originais sem ajuste (rawOpen, rawHigh, rawLow, rawClose) em intervalos diários. Exige o plano Pro.

Example:true

Response

Histórico recuperado com sucesso.

requestedAtstring date-time required

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

tookinteger required

Tempo de processamento, em milissegundos.

Example response

{
  "results": [
    {
      "requestedSymbol": "PETR4",
      "symbol": "PETR4",
      "changed": false,
      "data": {
        "usedInterval": "1d",
        "usedRange": "1mo",
        "historicalDataPrice": [
          {
            "date": 1781233200,
            "open": 41.06,
            "high": 41.53,
            "low": 40.82,
            "close": 41.18,
            "volume": 34081000,
            "adjustedClose": 41.18
          }
        ]
      }
    }
  ],
  "requestedAt": "2026-06-14T05:03:16.000Z",
  "took": 907
}

Changes

    • info

      added the new optional query request parameter includeRaw

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      added the optional property ///// to the response with the status

    • info

      endpoint added