Bolsa de Valores

HG BrasilFinance
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.

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

GET
https://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"

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

CampoDescrição
tickerIdentificador completo no formato {source}:{symbol}
kindTipo do ativo: stock, bdr, etf, fund, index, crypto, forex
unitUnidade dos valores (currency, points etc.)
currencyMoeda principal
symbolCódigo de negociação
nameNome simplificado
full_nameNome completo ou razão social
tax_idDocumento fiscal do emissor (ex.: CNPJ)
isinCódigo ISIN do ativo
shares_outstandingQuantidade de ações em circulação
classification.sectorSetor de atuação
classification.subsectorSubsetor de atuação
classification.segmentSegmento de atuação
logos.square_smallURL do logotipo quadrado em tamanho pequeno
logos.square_largeURL do logotipo quadrado em tamanho grande
relatedLista de tickers relacionados no formato {source}:{symbol}

Quote

CampoDescrição
quote.valueÚltimo valor negociado (moeda, pontos etc.)
quote.change_valueVariação absoluta no dia
quote.change_percentVariação percentual no dia
quote.market_capValor de mercado com base na cotação atual
quote.updated_atTimestamp da cotação (ISO 8601)

Market

CampoDescrição
market.is_openIndica se o mercado está aberto
market.open_timeHorário de abertura do mercado (ISO 8601)
market.close_timeHorário de fechamento do mercado (ISO 8601)
market.previous_valueValor de referência anterior (ex.: fechamento anterior)
market.openValor de abertura do dia
market.highMáxima do dia
market.lowMínima do dia
market.closeValor de fechamento do dia
market.volumeVolume negociado
market.updated_atTimestamp da sessão (ISO 8601)

Fonte

CampoDescrição
source.symbolCódigo da fonte
source.nameNome da fonte
source.full_nameNome completo da fonte
source.urlSite oficial
source.location.timezoneFuso horário