Cotações Históricas

HG BrasilFinance
Acesse o histórico de cotações de ações, fundos imobiliários, BDRs, ETFs e outros ativos negociados na B3 (Ibovespa).

Acesse o histórico completo de cotações de ativos negociados na B3. Preços de abertura, fechamento, máxima, mínima e volume — tudo em um único endpoint!

Para acessar os dados da API é necessário utilizar uma chave de integração e um plano compatível.

Dados OHLCV

A API retorna dados no formato OHLCV (Open, High, Low, Close, Volume), padrão amplamente utilizado no mercado financeiro para análise técnica e construção de gráficos de candlestick:

CampoTítuloDescrição
openAberturaPreço do ativo no momento da abertura do período.
highMáximaMaior preço atingido pelo ativo durante o período.
lowMínimaMenor preço atingido pelo ativo durante o período.
closeFechamentoPreço do ativo no momento do fechamento do período.
volumeVolumeQuantidade total de ativos negociados no período.

Requisição

Informe o ticker no formato {fonte}:{símbolo}. O exemplo consulta cotações diárias dos últimos 30 dias.

GET
https://api.hgbrasil.com/v2/finance/history?tickers=B3:PETR4&days_ago=30&sample_by=1d&key=suachave
curl -X GET "https://api.hgbrasil.com/v2/finance/history?tickers=B3%3APETR4&days_ago=30&sample_by=1d&key=suachave"

Parâmetros

tickers
string required
Ticker do ativo no formato {fonte}:{símbolo}. Para múltiplos ativos, separe por vírgula: B3:PETR4,B3:VALE3.
sample_by
string
Controla a granularidade do histórico retornado. Opções disponíveis:
  • 1m: 1 minuto
  • 5m: 5 minutos
  • 15m: 15 minutos
  • 30m: 30 minutos
  • 1h: 1 hora
  • 2h: 2 horas
  • 1d: 1 dia
  • 1M: 1 mês
start_date
string
Data inicial para filtrar o histórico (yyyy-mm-dd).
end_date
string
Data final para filtrar o histórico (yyyy-mm-dd).
date
string
Data específica para consultar cotações de um único dia (yyyy-mm-dd).
days_ago
number
Número de dias atrás a partir de hoje. Use 0 para cotações do dia atual.
Somente um tipo de filtro de data pode ser utilizado por requisição: intervalo (start_date/end_date), data específica (date) ou dias atrás (days_ago).

Resposta

{
  "metadata": {
    "key_status": "valid",
    "cached": false,
    "response_time_ms": 63.5,
    "language": "pt-br"
  },
  "results": [
    {
      "ticker": "B3:PETR4",
      "unit": "currency",
      "currency": "BRL",
      "samples": [
        {
          "date": "2026-10-19T00:00:00.000000Z",
          "open": 59.3,
          "close": 58,
          "high": 59.3,
          "low": 57.95,
          "volume": 34560800
        },
        {
          "date": "2026-10-20T00:00:00.000000Z",
          "open": 58.82,
          "close": 58.21,
          "high": 59.1,
          "low": 56.91,
          "volume": 42313400
        },
        {
          "date": "2026-10-21T00:00:00.000000Z",
          "open": 58.21,
          "close": 57.75,
          "high": 58.68,
          "low": 57.75,
          "volume": 65431200
        },
        {
          "date": "2026-10-22T00:00:00.000000Z",
          "open": 58.39,
          "close": 57.83,
          "high": 58.6,
          "low": 57.01,
          "volume": 36384200
        },
        {
          "date": "2026-10-23T00:00:00.000000Z",
          "open": 58.1,
          "close": 58.68,
          "high": 59.79,
          "low": 58.01,
          "volume": 54678300
        },
        {
          "date": "2026-10-26T00:00:00.000000Z",
          "open": 51.2,
          "close": 53.88,
          "high": 54.23,
          "low": 51.17,
          "volume": 188204100
        },
        {
          "date": "2026-10-27T00:00:00.000000Z",
          "open": 53.6,
          "close": 52.79,
          "high": 53.7,
          "low": 52.66,
          "volume": 73608300
        },
        {
          "date": "2026-10-28T00:00:00.000000Z",
          "open": 53.17,
          "close": 52.51,
          "high": 53.21,
          "low": 52.22,
          "volume": 47039300
        },
        {
          "date": "2026-10-29T00:00:00.000000Z",
          "open": 52.05,
          "close": 52.2,
          "high": 53.03,
          "low": 51.75,
          "volume": 69130800
        },
        {
          "date": "2026-10-30T00:00:00.000000Z",
          "open": 52.45,
          "close": 52.71,
          "high": 53.66,
          "low": 52.36,
          "volume": 53431000
        },
        {
          "date": "2026-11-03T00:00:00.000000Z",
          "open": 51.2,
          "close": 50.69,
          "high": 51.21,
          "low": 49.15,
          "volume": 152392700
        },
        {
          "date": "2026-11-04T00:00:00.000000Z",
          "open": 50.04,
          "close": 47.12,
          "high": 50.31,
          "low": 46.64,
          "volume": 74958600
        },
        {
          "date": "2026-11-05T00:00:00.000000Z",
          "open": 47.9,
          "close": 46.52,
          "high": 48.04,
          "low": 46.33,
          "volume": 37451300
        },
        {
          "date": "2026-11-06T00:00:00.000000Z",
          "open": 46,
          "close": 45.36,
          "high": 46.11,
          "low": 44.96,
          "volume": 35697200
        },
        {
          "date": "2026-11-09T00:00:00.000000Z",
          "open": 44.6,
          "close": 44.67,
          "high": 45.39,
          "low": 44.29,
          "volume": 31267200
        },
        {
          "date": "2026-11-10T00:00:00.000000Z",
          "open": 45.08,
          "close": 45.09,
          "high": 45.69,
          "low": 44.5,
          "volume": 40547800
        },
        {
          "date": "2026-11-11T00:00:00.000000Z",
          "open": 44,
          "close": 43.8,
          "high": 44.52,
          "low": 43.3,
          "volume": 50044900
        },
        {
          "date": "2026-11-12T00:00:00.000000Z",
          "open": 43.4,
          "close": 44.92,
          "high": 44.97,
          "low": 43.24,
          "volume": 29655800
        },
        {
          "date": "2026-11-13T00:00:00.000000Z",
          "open": 44.89,
          "close": 45.17,
          "high": 45.28,
          "low": 44.62,
          "volume": 16992800
        },
        {
          "date": "2026-11-16T00:00:00.000000Z",
          "open": 45.1,
          "close": 43.93,
          "high": 45.11,
          "low": 43.65,
          "volume": 21758900
        },
        {
          "date": "2026-11-17T00:00:00.000000Z",
          "open": 44.3,
          "close": 44.07,
          "high": 44.75,
          "low": 44.05,
          "volume": 14641200
        }
      ],
      "source": {
        "symbol": "B3",
        "name": "B3",
        "full_name": "B3 S.A. - Brasil, Bolsa, Balcão",
        "url": "https://www.b3.com.br",
        "location": {
          "timezone": "America/Sao_Paulo"
        }
      }
    }
  ]
}

Campos

Os dados de cada ativo retornam no array results:

Ativo

CampoTipoDescriçãoExemplo
tickerstringTicker completo no formato {fonte}:{símbolo}.B3:PETR4
unitstringUnidade dos valores (currency para moeda).currency
currencystringMoeda dos valores.BRL

Cotações

Cada item do array samples representa uma cotação no período:

CampoTipoDescriçãoExemplo
datestringData e hora do período (ISO 8601).2026-01-16T00:00:00.000000Z
opennumberPreço de abertura do período.31.95
closenumberPreço de fechamento do período.32.04
highnumberPreço máximo atingido no período.32.2
lownumberPreço mínimo atingido no período.31.88
volumenumberVolume total negociado no período.59717700.0
Entendendo os preços: Os valores de open, close, high e low são expressos na moeda indicada pelo campo currency. Para ativos da B3, os valores são em Reais (BRL).

Fonte

O objeto source contém informações sobre a bolsa de valores:

CampoTipoDescriçãoExemplo
source.symbolstringCódigo da bolsa.B3
source.namestringNome da bolsa.B3
source.full_namestringNome completo da bolsa.B3 S.A. - Brasil, Bolsa, Balcão
source.urlstringSite oficial da bolsa.https://www.b3.com.br
source.location.timezonestringFuso horário da bolsa.America/Sao_Paulo