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?symbol=petr4&key=suachave"

const url = new URL("/finance", "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';

$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'

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')

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?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";

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.124,
        "dividends": {
          "yield_12m": 8.87,
          "yield_12m_sum": 3.272,
          "last_payment": 0.336
        }
      },
      "region": "Brazil/Sao Paulo",
      "currency": "BRL",
      "market_time": {
        "open": "10:00",
        "close": "17:30",
        "timezone": -3
      },
      "market_cap": 94092.4,
      "price": 36.89,
      "change_percent": 0,
      "change_price": 0,
      "volume": 27507000,
      "updated_at": "2026-02-13 18:06:00"
    }
  },
  "execution_time": 0.07,
  "from_cache": false
}

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": [],
  "execution_time": 0.16,
  "from_cache": false
}