Cotações Históricas
Finance
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!
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:
| Campo | Título | Descrição |
|---|---|---|
open | Abertura | Preço do ativo no momento da abertura do período. |
high | Máxima | Maior preço atingido pelo ativo durante o período. |
low | Mínima | Menor preço atingido pelo ativo durante o período. |
close | Fechamento | Preço do ativo no momento do fechamento do período. |
volume | Volume | Quantidade 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.
GEThttps://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"
const url = new URL("/v2/finance/history", "https://api.hgbrasil.com")
url.searchParams.set("tickers", "B3:PETR4")
url.searchParams.set("days_ago", "30")
url.searchParams.set("sample_by", "1d")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/v2/finance/history';
$queryString = http_build_query([
'tickers' => 'B3:PETR4',
'days_ago' => '30',
'sample_by' => '1d',
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/v2/finance/history'
params = {
'tickers': 'B3:PETR4',
'days_ago': '30',
'sample_by': '1d',
'key': 'suachave'
}
response = requests.get(url, params=params)
data = response.json()
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.hgbrasil.com/v2/finance/history')
uri.query = URI.encode_www_form({
tickers: 'B3:PETR4',
days_ago: '30',
sample_by: '1d',
key: 'suachave'
})
response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)
import java.net.URI;
import java.net.http.*;
var url = "https://api.hgbrasil.com/v2/finance/history?tickers=B3%3APETR4&days_ago=30&sample_by=1d&key=suachave";
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();
using System.Net.Http;
using System.Text.Json;
using System.Web;
var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/v2/finance/history";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["tickers"] = "B3:PETR4";
queryParams["days_ago"] = "30";
queryParams["sample_by"] = "1d";
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
Ativos Disponíveis
Consulte os ativos disponíveis para uso na API. Use o campo abaixo para buscar por nome ou símbolo.
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 minuto5m: 5 minutos15m: 15 minutos30m: 30 minutos1h: 1 hora2h: 2 horas1d: 1 dia1M: 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
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
ticker | string | Ticker completo no formato {fonte}:{símbolo}. | B3:PETR4 |
unit | string | Unidade dos valores (currency para moeda). | currency |
currency | string | Moeda dos valores. | BRL |
Cotações
Cada item do array samples representa uma cotação no período:
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
date | string | Data e hora do período (ISO 8601). | 2026-01-16T00:00:00.000000Z |
open | number | Preço de abertura do período. | 31.95 |
close | number | Preço de fechamento do período. | 32.04 |
high | number | Preço máximo atingido no período. | 32.2 |
low | number | Preço mínimo atingido no período. | 31.88 |
volume | number | Volume 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:
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
source.symbol | string | Código da bolsa. | B3 |
source.name | string | Nome da bolsa. | B3 |
source.full_name | string | Nome completo da bolsa. | B3 S.A. - Brasil, Bolsa, Balcão |
source.url | string | Site oficial da bolsa. | https://www.b3.com.br |
source.location.timezone | string | Fuso horário da bolsa. | America/Sao_Paulo |