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.
Você pode obter cotações da Bolsa de Valores (B3) como ações, BDRs e fundos listados no Ibovespa, etc. Este endpoint fornece informações com payload enxuto e baixa latência, ideal para atualização frequente de valores.
Ativos
Consulte as ações, FIIs e BDRs disponíveis e seus respectivos tickers para utilizar na consulta abaixo.
Ativos Disponíveis
Consulte os ativos disponíveis para uso na API. Use o campo abaixo para buscar por nome ou símbolo.
Requisição
Para consultar um ou mais ativos, informe os campos no parâmetro tickers separados por vírgula. Por exemplo, para consultar a Petrobras PN (PETR4):
GEThttps://api.hgbrasil.com/v2/finance/quotes?tickers=B3:PETR4&key=suachave
curl -X GET "https://api.hgbrasil.com/v2/finance/quotes?tickers=B3%3APETR4&key=suachave"
const url = new URL("/v2/finance/quotes", "https://api.hgbrasil.com")
url.searchParams.set("tickers", "B3:PETR4")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/v2/finance/quotes';
$queryString = http_build_query([
'tickers' => 'B3:PETR4',
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/v2/finance/quotes'
params = {
'tickers': 'B3: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/v2/finance/quotes')
uri.query = URI.encode_www_form({
tickers: 'B3: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/v2/finance/quotes?tickers=B3%3APETR4&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/quotes";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["tickers"] = "B3:PETR4";
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
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.fields
string
Filtro de campos para reduzir o payload de retorno. Ex:
ticker,quote.value,quote.change_percent.Resposta
{
"metadata": {
"key_status": "valid",
"cached": false,
"response_time_ms": 20,
"language": "pt-br"
},
"results": [
{
"ticker": "B3:PETR4",
"kind": "stock",
"unit": "currency",
"currency": "BRL",
"symbol": "PETR4",
"name": "Petrobrás",
"full_name": "Petroleo Brasileiro S.A. Petrobras",
"tax_id": "33.000.167/0001-01",
"shares_outstanding": 12888732761,
"classification": {
"sector": "Petróleo, Gás e Biocombustíveis"
},
"logos": {
"square_small": "https://assets.hgbrasil.com/finance/companies/small/petrobras.png",
"square_large": "https://assets.hgbrasil.com/finance/companies/big/petrobras.png"
},
"quote": {
"value": 46.18,
"change_value": -0.04,
"change_percent": -0.0865,
"market_cap": 128516000000,
"updated_at": "2026-05-08T11:27:07-03:00"
},
"market": {
"is_open": true,
"open_time": "2026-05-08T10:000-3:00",
"close_time": "2026-05-08T17:300-3:00",
"previous_value": 46.22,
"open": 46.39,
"close": 46.18,
"high": 46.55,
"low": 45.8,
"volume": 6775500,
"updated_at": "2026-05-08T11:27:07-03:00"
},
"dividends": {
"yield_12m_percent": 6.88,
"yield_12m_cash": 3.177
},
"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"
}
},
"related": [
"B3:VBBR3",
"B3:PRIO3",
"B3:RECV3",
"B3:UGPA3",
"B3:SBSP3"
]
}
]
}
Campos
Os dados do ativo retornam dentro da lista results com os seguintes campos:
Ativo
| Campo | Descrição |
|---|---|
ticker | Identificador completo no formato {source}:{symbol} |
kind | Tipo do ativo: stock, bdr, etf, fund, index, crypto, forex |
unit | Unidade dos valores (currency, points etc.) |
currency | Moeda principal |
symbol | Código de negociação |
name | Nome simplificado |
full_name | Nome completo ou razão social |
tax_id | Documento fiscal do emissor (ex.: CNPJ) |
isin | Código ISIN do ativo |
shares_outstanding | Quantidade de ações em circulação |
classification.sector | Setor de atuação |
classification.subsector | Subsetor de atuação |
classification.segment | Segmento de atuação |
logos.square_small | URL do logotipo quadrado em tamanho pequeno |
logos.square_large | URL do logotipo quadrado em tamanho grande |
related | Lista de tickers relacionados no formato {source}:{symbol} |
Quote
| Campo | Descrição |
|---|---|
quote.value | Último valor negociado (moeda, pontos etc.) |
quote.change_value | Variação absoluta no dia |
quote.change_percent | Variação percentual no dia |
quote.market_cap | Valor de mercado com base na cotação atual |
quote.updated_at | Timestamp da cotação (ISO 8601) |
Market
| Campo | Descrição |
|---|---|
market.is_open | Indica se o mercado está aberto |
market.open_time | Horário de abertura do mercado (ISO 8601) |
market.close_time | Horário de fechamento do mercado (ISO 8601) |
market.previous_value | Valor de referência anterior (ex.: fechamento anterior) |
market.open | Valor de abertura do dia |
market.high | Máxima do dia |
market.low | Mínima do dia |
market.close | Valor de fechamento do dia |
market.volume | Volume negociado |
market.updated_at | Timestamp da sessão (ISO 8601) |
Fonte
| Campo | Descrição |
|---|---|
source.symbol | Código da fonte |
source.name | Nome da fonte |
source.full_name | Nome completo da fonte |
source.url | Site oficial |
source.location.timezone | Fuso horário |