Bolsa de Valores
Finance
Cotações dos principais indicadores do mercado financeiro, além de informações detalhadas sobre ações e FIIs negociados no Ibovespa.
Ações e FIIs
Você pode obter cotações de ações e fundos imobiliários listados no Ibovespa. Este endpoint fornece informações detalhadas sobre preços, variações, volumes e outros dados relevantes dos ativos negociados na bolsa brasileira.
Requisição
Para consultar uma ação específica, informe o código do ativo no parâmetro symbol. Por exemplo, para consultar a Petrobras PN (PETR4):
GEThttps://api.hgbrasil.com/finance/stock_price?symbol=petr4&key=suachave
curl -X GET "https://api.hgbrasil.com/finance/stock_price?symbol=petr4&key=suachave"
const url = new URL("/finance/stock_price", "https://api.hgbrasil.com")
url.searchParams.set("symbol", "petr4")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/finance/stock_price';
$queryString = http_build_query([
'symbol' => 'petr4',
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/finance/stock_price'
params = {
'symbol': 'petr4',
'key': 'suachave'
}
response = requests.get(url, params=params)
data = response.json()
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.hgbrasil.com/finance/stock_price')
uri.query = URI.encode_www_form({
symbol: 'petr4',
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/finance/stock_price?symbol=petr4&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/finance/stock_price";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["symbol"] = "petr4";
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
Resposta
{
"by": "symbol",
"valid_key": true,
"results": {
"PETR4": {
"kind": "stock",
"symbol": "PETR4",
"name": "Petrobras",
"company_name": "Petroleo Brasileiro S.A. Petrobras",
"document": "33.000.167/0001-01",
"description": "Pesquisa. Lavra. Refinação. Processamento. Comércio E Transporte de Petróleo. de Seus Derivados. de Gás Natural E de Outros Hidrocarbonetos Fluidos. Além Das Atividades Vinculadas à Energia.",
"ai_description": "A Petrobras, uma das maiores empresas do setor de energia da América Latina, é líder na exploração, produção e refino de petróleo e gás natural. Com um core business focado na energia, a companhia se destaca pela vasta experiência na operação de plataformas offshore e tecnologia avançada em exploração de reservatórios. Seus principais diferenciais competitivos incluem um portfólio diversificado de ativos, forte presença nacional e internacional e um compromisso com a sustentabilidade e as práticas de ESG. A relevância da Petrobras no mercado de energia é incontestável, e sua robustez financeira, sustentada por receitas constantes e controle de custos, a posiciona como um elemento essencial para o desenvolvimento econômico do Brasil.",
"website": "http://www.petrobras.com.br/",
"sector": "Petróleo, Gás e Biocombustíveis",
"related": [
"PETR4",
"PRIO3",
"RECV3",
"UGPA3",
"SBSP3"
],
"bookkeeper": "BRADESCO",
"logo": {
"small": "https://assets.hgbrasil.com/finance/companies/small/petrobras.png",
"big": "https://assets.hgbrasil.com/finance/companies/big/petrobras.png"
},
"financials": {
"equity": 422934000000,
"quota_count": 12888732761,
"equity_per_share": 32.814,
"price_to_book_ratio": 1.248,
"dividends": {
"yield_12m": 7.99,
"yield_12m_sum": 3.272,
"last_payment": 0.4716
}
},
"region": "Brazil/Sao Paulo",
"currency": "BRL",
"market_time": {
"open": "10:00",
"close": "17:30",
"timezone": -3
},
"market_cap": 552374,
"price": 40.56,
"change_percent": -0.95,
"change_price": -0.39,
"volume": 7410500,
"updated_at": "2026-03-04 10:55:53"
}
},
"execution_time": 0,
"from_cache": true
}
Campos
Os dados da ação retornam no results com os seguintes campos:
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
kind | string | Tipo do ativo (stock para ações ou fii para FIIs). | stock |
symbol | string | Código de negociação do ativo na bolsa. | PETR4 |
name | string | Nome simplificado da empresa. | Petrobras |
company_name | string | Razão social completa da empresa. | Petroleo Brasileiro S.A. |
document | string | CNPJ da empresa. | 33.000.167/0001-01 |
description | string | Descrição das atividades da empresa. | Pesquisa e refino... |
ai_description | string | Descrição detalhada gerada por IA sobre a empresa e seus diferenciais. | A Petrobras, uma das... |
website | string | Site oficial da empresa. | http://www.petrobras.com.br/ |
sector | string | Setor de atuação da empresa. | Petróleo, Gás e... |
related | array | Lista de símbolos de ações relacionadas ou do mesmo setor. | "PETR4", "PRIO3" |
bookkeeper | string | Instituição escrituradora responsável pelos registros da empresa. | BRADESCO |
logo | object | URLs das logos da empresa (small e big). | {...} |
financials | object | Informações financeiras (equity, quota_count, dividends, etc.). | {...} |
financials.equity | number | Patrimônio líquido. | 366006000000 |
financials.quota_count | number | Quantidade de ações em circulação. | 12888732761 |
financials.equity_per_share | number | Patrimônio líquido por ação (VPA). | 28.397 |
financials.price_to_book_ratio | number | Relação Preço/Valor Patrimonial (P/VP). | 1.156 |
financials.dividends | object | Informações sobre dividendos (yield_12m e yield_12m_sum). | {...} |
region | string | Região/fuso horário da bolsa onde o ativo é negociado. | Brazil/Sao Paulo |
currency | string | Moeda de negociação do ativo. | BRL |
market_time | object | Horários de funcionamento do mercado (open, close e timezone). | {...} |
market_cap | number | Valor de mercado da empresa em milhões (market cap). | 80690.6 |
price | number | Preço atual da ação. | 32.82 |
change_percent | number | Variação percentual do dia. | 0 |
change_price | number | Variação em valor absoluto do dia. | 0 |
volume | number | Volume de negociação do dia (quantidade de ações negociadas). | 48719300 |
updated_at | string | Data e hora da última atualização dos dados. | 2025-11-19 18:07:55 |
Maiores Altas e Baixas
Além de consultar ações individuais, você também pode recuperar uma lista das ações que tiveram as maiores altas ou baixas do dia. Para isso, utilize o parâmetro symbol com as opções especiais get-high (maiores altas) ou get-low (maiores baixas).
GEThttps://api.hgbrasil.com/finance/stock_price?symbol=get-high&key=suachave
Ibovespa
Para análises mais refinadas, você pode obter dados diários detalhados do IBOVESPA, com informações de preços de abertura, fechamento, máxima, mínima e média.
Requisição
Por padrão, a API retorna os dados do pregão atual (se estiver acontecendo no momento), ou do último pregão.
GEThttps://api.hgbrasil.com/finance/ibovespa?key=suachave
curl -X GET "https://api.hgbrasil.com/finance/ibovespa?key=suachave"
const url = new URL("/finance/ibovespa", "https://api.hgbrasil.com")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/finance/ibovespa';
$queryString = http_build_query([
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/finance/ibovespa'
params = {
'key': 'suachave'
}
response = requests.get(url, params=params)
data = response.json()
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.hgbrasil.com/finance/ibovespa')
uri.query = URI.encode_www_form({
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/finance/ibovespa?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/finance/ibovespa";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
Resposta
{
"by": "last_business_day",
"valid_key": true,
"results": [
{
"date": "2026-03-04",
"close": 185121,
"high": 186299,
"low": 183110,
"last": 185121,
"volume": 0,
"change_percent": 1.1,
"previous_date": "2026-03-03",
"previous_close": 183105,
"data": [
{
"points": 183110.3,
"change": 0,
"date": "20260304100000"
},
{
"points": 183110.02,
"change": 0,
"date": "20260304100100"
},
{
"points": 183110.02,
"change": 0,
"date": "20260304100200"
},
{
"points": 183122.05,
"change": 0.01,
"date": "20260304100300"
},
{
"points": 183427.59,
"change": 0.18,
"date": "20260304100400"
},
{
"points": 183882.63,
"change": 0.42,
"date": "20260304100500"
},
{
"points": 184012.63,
"change": 0.5,
"date": "20260304100600"
},
{
"points": 184019.55,
"change": 0.5,
"date": "20260304100700"
},
{
"points": 185476.81,
"change": 1.3,
"date": "20260304100800"
},
{
"points": 185487.52,
"change": 1.3,
"date": "20260304100900"
},
{
"points": 185770.73,
"change": 1.46,
"date": "20260304101000"
},
{
"points": 185755.95,
"change": 1.45,
"date": "20260304101100"
},
{
"points": 185704.17,
"change": 1.42,
"date": "20260304101200"
},
{
"points": 185880.41,
"change": 1.52,
"date": "20260304101300"
},
{
"points": 186170.7,
"change": 1.67,
"date": "20260304101400"
},
{
"points": 186109.47,
"change": 1.64,
"date": "20260304101500"
},
{
"points": 185985.44,
"change": 1.57,
"date": "20260304101600"
},
{
"points": 186136.55,
"change": 1.66,
"date": "20260304101700"
},
{
"points": 186039.91,
"change": 1.6,
"date": "20260304101800"
},
{
"points": 186099.88,
"change": 1.64,
"date": "20260304101900"
},
{
"points": 186155.98,
"change": 1.67,
"date": "20260304102000"
},
{
"points": 186299.02,
"change": 1.74,
"date": "20260304102100"
},
{
"points": 186228.09,
"change": 1.71,
"date": "20260304102200"
},
{
"points": 186153.48,
"change": 1.66,
"date": "20260304102300"
},
{
"points": 186110.58,
"change": 1.64,
"date": "20260304102400"
},
{
"points": 186145.56,
"change": 1.66,
"date": "20260304102500"
},
{
"points": 186147.44,
"change": 1.66,
"date": "20260304102600"
},
{
"points": 186148.05,
"change": 1.66,
"date": "20260304102700"
},
{
"points": 186107.44,
"change": 1.64,
"date": "20260304102800"
},
{
"points": 186111.22,
"change": 1.64,
"date": "20260304102900"
},
{
"points": 186106.31,
"change": 1.64,
"date": "20260304103000"
},
{
"points": 185980.98,
"change": 1.57,
"date": "20260304103100"
},
{
"points": 185855.77,
"change": 1.5,
"date": "20260304103200"
},
{
"points": 185926.66,
"change": 1.54,
"date": "20260304103300"
},
{
"points": 185828.66,
"change": 1.49,
"date": "20260304103400"
},
{
"points": 185627.08,
"change": 1.38,
"date": "20260304103500"
},
{
"points": 185506.06,
"change": 1.31,
"date": "20260304103600"
},
{
"points": 185292.48,
"change": 1.19,
"date": "20260304103700"
},
{
"points": 185287.61,
"change": 1.19,
"date": "20260304103800"
},
{
"points": 185447.13,
"change": 1.28,
"date": "20260304103900"
},
{
"points": 185271.52,
"change": 1.18,
"date": "20260304104000"
},
{
"points": 185401.52,
"change": 1.25,
"date": "20260304104100"
},
{
"points": 185138.09,
"change": 1.11,
"date": "20260304104200"
},
{
"points": 185107.86,
"change": 1.09,
"date": "20260304104300"
},
{
"points": 185068.23,
"change": 1.07,
"date": "20260304104400"
},
{
"points": 185060.14,
"change": 1.07,
"date": "20260304104500"
},
{
"points": 185231,
"change": 1.16,
"date": "20260304104600"
},
{
"points": 185159.94,
"change": 1.12,
"date": "20260304104700"
},
{
"points": 185278.88,
"change": 1.19,
"date": "20260304104800"
},
{
"points": 185256.34,
"change": 1.17,
"date": "20260304104900"
},
{
"points": 185191.95,
"change": 1.14,
"date": "20260304105000"
},
{
"points": 185286.89,
"change": 1.19,
"date": "20260304105100"
},
{
"points": 185167.41,
"change": 1.13,
"date": "20260304105200"
},
{
"points": 185075.56,
"change": 1.08,
"date": "20260304105300"
},
{
"points": 185142.66,
"change": 1.11,
"date": "20260304105400"
},
{
"points": 185075.66,
"change": 1.08,
"date": "20260304105500"
},
{
"points": 184917.69,
"change": 0.99,
"date": "20260304105600"
},
{
"points": 184935.72,
"change": 1,
"date": "20260304105700"
},
{
"points": 184998.56,
"change": 1.03,
"date": "20260304105800"
},
{
"points": 185045.05,
"change": 1.06,
"date": "20260304105900"
},
{
"points": 185232.38,
"change": 1.16,
"date": "20260304110000"
},
{
"points": 185230.34,
"change": 1.16,
"date": "20260304110100"
},
{
"points": 185351.47,
"change": 1.23,
"date": "20260304110200"
},
{
"points": 185074.34,
"change": 1.08,
"date": "20260304110300"
},
{
"points": 185120.77,
"change": 1.1,
"date": "20260304110400"
}
]
}
],
"execution_time": 0,
"from_cache": true
}