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.

Requisição

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

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

Resposta

Exemplo de resposta no formato JSON.

{
  "by": "default",
  "valid_key": true,
  "results": {
    "currencies": {
      "source": "BRL",
      "USD": {
        "name": "Dollar",
        "buy": 5.2925,
        "sell": 5.2933,
        "variation": 0.015
      },
      "EUR": {
        "name": "Euro",
        "buy": 6.135,
        "sell": 6.135,
        "variation": 0.028
      },
      "GBP": {
        "name": "Pound Sterling",
        "buy": 6.9488,
        "sell": null,
        "variation": -0.013
      },
      "ARS": {
        "name": "Argentine Peso",
        "buy": 0.0035,
        "sell": null,
        "variation": 0
      },
      "CAD": {
        "name": "Canadian Dollar",
        "buy": 3.7781,
        "sell": null,
        "variation": -0.034
      },
      "AUD": {
        "name": "Australian Dollar",
        "buy": 3.4596,
        "sell": null,
        "variation": -0.02
      },
      "JPY": {
        "name": "Japanese Yen",
        "buy": 0.0341,
        "sell": null,
        "variation": 0
      },
      "CNY": {
        "name": "Renminbi",
        "buy": 0.7441,
        "sell": null,
        "variation": 0
      },
      "BTC": {
        "name": "Bitcoin",
        "buy": 577553.077,
        "sell": 577553.077,
        "variation": 1.215
      }
    },
    "stocks": {
      "IBOVESPA": {
        "name": "BM&F BOVESPA",
        "location": "Sao Paulo, Brazil",
        "points": 157632.9,
        "variation": -0.07
      },
      "IFIX": {
        "name": "Índice de Fundos de Investimentos Imobiliários B3",
        "location": "Sao Paulo, Brazil",
        "points": 3597.06,
        "variation": 0.12
      },
      "NASDAQ": {
        "name": "NASDAQ Stock Market",
        "location": "New York City, United States",
        "points": 23406.46,
        "variation": -0.26
      },
      "DOWJONES": {
        "name": "Dow Jones Industrial Average",
        "location": "New York City, United States",
        "points": 48254.82,
        "variation": 0.68
      },
      "CAC": {
        "name": "CAC 40",
        "location": "Paris, French",
        "points": 8241.24,
        "variation": 1.04
      },
      "NIKKEI": {
        "name": "Nikkei 225",
        "location": "Tokyo, Japan",
        "points": 51063.31,
        "variation": 0.43
      }
    },
    "available_sources": [
      "BRL"
    ],
    "bitcoin": {
      "blockchain_info": {
        "name": "Blockchain.info",
        "format": [
          "USD",
          "en_US"
        ],
        "last": 102898.8,
        "buy": 102898.8,
        "sell": 102898.8,
        "variation": 1.165
      },
      "bitstamp": {
        "name": "BitStamp",
        "format": [
          "USD",
          "en_US"
        ],
        "last": 102926,
        "buy": 102926,
        "sell": 102925,
        "variation": 1.201
      },
      "foxbit": {
        "name": "FoxBit",
        "format": [
          "BRL",
          "pt_BR"
        ],
        "last": 545277,
        "variation": 1.136
      },
      "mercadobitcoin": {
        "name": "Mercado Bitcoin",
        "format": [
          "BRL",
          "pt_BR"
        ],
        "last": 545499,
        "buy": 545049,
        "sell": 545287,
        "variation": 1.188
      }
    },
    "taxes": [
      {
        "date": "2025-11-12",
        "cdi": 15,
        "selic": 15,
        "daily_factor": 0,
        "selic_daily": 14.9,
        "cdi_daily": 14.9
      }
    ]
  },
  "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