Mercado Financeiro

Finance

Dados financeiros atualizados e precisos.

A HG Finance reúne diversos conjuntos de dados essenciais para o monitoramento do mercado financeiro. Com ela, você poderá:

Acessar cotações de moedas e ativos (como ações e FIIs);
Consultar índices de mercado, inclusive os que exibem altas e baixas;
Obter informações sobre criptomoedas a partir de múltiplas exchanges;
Recuperar as principais taxas de juros do Brasil (CDI, SELIC, etc.);
Consultar dados históricos para análises e projeções.

Esta página serve como ponto de partida para entender a estrutura geral da API, como autenticar suas requisições e quais formatos de resposta estão disponíveis.

Para acessar os dados da API é necessário utilizar uma chave de integração.

As cotações são atualizadas em intervalos de 15 a 45 minutos durante o pregão.

Requisição

Todas as requisições tem como base o seguinte endpoint:

GEThttps://api.hgbrasil.com/finance?key=suachave

curl -X GET "https://api.hgbrasil.com/finance?key=suachave"

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

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

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

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?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["key"] = "suachave";

var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);

Resposta

Exemplo de resposta no formato JSON.

{
  "by": "default",
  "valid_key": true,
  "results": {
    "currencies": {
      "source": "BRL",
      "USD": {
        "name": "Dollar",
        "buy": 5.1491,
        "sell": 5.1508,
        "variation": -0.174
      },
      "EUR": {
        "name": "Euro",
        "buy": 5.9484,
        "sell": 5.9524,
        "variation": 0.108
      },
      "GBP": {
        "name": "Pound Sterling",
        "buy": 6.8237,
        "sell": null,
        "variation": 0.245
      },
      "ARS": {
        "name": "Argentine Peso",
        "buy": 0.0037,
        "sell": null,
        "variation": 0
      },
      "CAD": {
        "name": "Canadian Dollar",
        "buy": 3.6999,
        "sell": null,
        "variation": 0.049
      },
      "AUD": {
        "name": "Australian Dollar",
        "buy": 3.5673,
        "sell": null,
        "variation": 0.338
      },
      "JPY": {
        "name": "Japanese Yen",
        "buy": 0.0323,
        "sell": null,
        "variation": 0
      },
      "CNY": {
        "name": "Renminbi",
        "buy": 0.7491,
        "sell": null,
        "variation": -0.04
      },
      "BTC": {
        "name": "Bitcoin",
        "buy": 378743.527,
        "sell": 378743.527,
        "variation": 3.732
      }
    },
    "stocks": {
      "IBOVESPA": {
        "name": "BM&F BOVESPA",
        "location": "Sao Paulo, Brazil",
        "points": 188849.7,
        "variation": 0.42
      },
      "IFIX": {
        "name": "Índice de Fundos de Investimentos Imobiliários B3",
        "location": "Sao Paulo, Brazil",
        "points": 3884.31,
        "variation": -0.03
      },
      "NASDAQ": {
        "name": "NASDAQ Stock Market",
        "location": "New York City, United States",
        "points": 21999.96,
        "variation": 0.55
      },
      "DOWJONES": {
        "name": "Dow Jones Industrial Average",
        "location": "New York City, United States",
        "points": 46464.99,
        "variation": -0.07
      },
      "CAC": {
        "name": "CAC 40",
        "location": "Paris, French",
        "points": 7962.39,
        "variation": -0.24
      },
      "NIKKEI": {
        "name": "Nikkei 225",
        "location": "Tokyo, Japan",
        "points": 53413.68,
        "variation": 0.55
      }
    },
    "available_sources": [
      "BRL"
    ],
    "bitcoin": {
      "blockchain_info": {
        "name": "Blockchain.info",
        "format": [
          "USD",
          "en_US"
        ],
        "last": 69397.46,
        "buy": 69397.46,
        "sell": 69397.46,
        "variation": 3.741
      },
      "bitstamp": {
        "name": "BitStamp",
        "format": [
          "USD",
          "en_US"
        ],
        "last": 69431,
        "buy": 69444,
        "sell": 69443,
        "variation": 3.786
      },
      "foxbit": {
        "name": "FoxBit",
        "format": [
          "BRL",
          "pt_BR"
        ],
        "last": 357542,
        "variation": 3.191
      },
      "mercadobitcoin": {
        "name": "Mercado Bitcoin",
        "format": [
          "BRL",
          "pt_BR"
        ],
        "last": 357296,
        "buy": 357140,
        "sell": 357296,
        "variation": 3.171
      }
    },
    "taxes": [
      {
        "date": "2026-04-06",
        "cdi": 14.75,
        "selic": 14.75,
        "daily_factor": 0,
        "selic_daily": 14.65,
        "cdi_daily": 14.65
      }
    ]
  },
  "execution_time": 0,
  "from_cache": true
}

Campos

Os dados referentes à consulta chegam no parâmetro results, você também pode conferir a autenticação de sua chave no parâmetro de retorno valid_key.

currencies

object

Cotação das moedas.

Campo	Tipo	Descrição	Exemplo
`source`	`string`	Código ISO da moeda base da cotação.	BRL
`[iso]`	`object`	Código ISO da moeda destino.	USD
`[iso].name`	`string`	Nome da moeda.	Dollar
`[iso].buy`	`number`	Valor de compra.	5.7276
`[iso].sell`	`number`	Valor de venda.	5.7274
`[iso].variation`	`number`	Variação em percentual referente à última hora útil anterior.	-0.021

stocks

object

Posições dos principais mercados.

Campo	Tipo	Descrição	Exemplo
`[index]`	`object`	Dados do índice de mercado.	Ibovespa
`[index].name`	`string`	Nome do índice.	BM&F BOVESPA
`[index].location`	`string`	Localização do mercado.	Sao Paulo, Brazil
`[index].points`	`number`	Pontos (somente Ibovespa).	126571.9
`[index].variation`	`number`	Variação em percentual referente à última hora útil anterior.	-0.44

bitcoin

object

Cotação do Bitcoin nas principais corretoras.

Campo	Tipo	Descrição	Exemplo
`[broker]`	`object`	Dados da corretora.	blockchain_info
`[broker].name`	`string`	Nome da corretora.	Blockchain.info
`[broker].format`	`Array`	Array com moeda base e idioma da moeda.	`["USD", "en_US"]`
`[broker].last`	`number`	Última posição (cotação atual).	93989.45
`[broker].buy`	`number`	Valor para compra (pode não estar disponível).	93989.45
`[broker].sell`	`number`	Valor para venda (pode não estar disponível).	93989.45
`[broker].variation`	`number`	Variação em percentual referente à última hora útil anterior.	-1.245

taxes

array

Taxas de juros do Brasil.

Campo	Tipo	Descrição	Exemplo
`[].date`	`string`	Data de referência.	2025-02-27
`[].cdi`	`number`	Taxa CDI em percentual.	13.25
`[].selic`	`number`	Taxa Selic em percentual.	13.25
`[].daily_factor`	`number`	Fator diário.	1.00049037
`[].selic_daily`	`number`	Taxa Selic diária em percentual.	13.15
`[].cdi_daily`	`number`	Taxa CDI diária em percentual.	13.15

Boas Práticas

Recomendações para garantir uma integração eficiente, escalável e robusta.

Fluxo de Caixa

Consulte a demonstração do fluxo de caixa de ações e outros ativos listados na B3, com dados anuais e trimestrais.