:

Conheça a nova documentação do HG Finance


Obter todos os dados

Com este método, todos os dados são retornados em uma única requisição.

Dados retornados:
Câmbio das moedas: Dólar USD, Euro EUR, Libra (GBP), Peso (ARS) e Bitcoin (BTC) para Real (BRL);
Valores de exchanges de Bitcoin (BTC) como Coinbase, Blockchain.info, BitStamp, FoxBit, OmniTrade, XDEX e Mercado Bitcoin;
Variação das bolsas de valores: IBOVESPA, NASDAQ, CAC 40 e NIKKEI;
Taxas brasileiras: CDI, SELIC e fator diário.

GET https://api.hgbrasil.com/finance?format=json&key=SUA-CHAVE
visualizar resposta

Parâmetros:

format: (formato de resposta)
- json
- json-cors (liberado para AJAX, requer chave com domínio correto)
- php-serialize
- debug (resposta em JSON indentado, recomenda-se apenas para leitura)

key: (sua chave de API, obrigatório para Bitcoin e taxas)
- informe sua chave de API HG Brasil, obtenha uma aqui.

Obter cotações de moedas e bolsas

Com este método, todos os dados são retornados em uma única requisição.

Dados retornados:
Câmbio das moedas: Dólar USD, Euro EUR, Libra (GBP) e Peso (ARS) para Real (BRL);
Valores de exchanges de Bitcoin (BTC) como Coinbase, Blockchain.info, BitStamp, FoxBit, OmniTrade e Mercado Bitcoin;
Variação das bolsas de valores: IBOVESPA, NASDAQ, CAC 40 e NIKKEI.

GET https://api.hgbrasil.com/finance/quotations?format=json&key=SUA-CHAVE
visualizar resposta

Parâmetros:

format: (formato de resposta)
- json
- json-cors (liberado para AJAX, requer chave com domínio correto)
- php-serialize
- debug (resposta em JSON indentado, recomenda-se apenas para leitura)

key: (sua chave de API, obrigatório para exchanges de Bitcoin)
- informe sua chave de API HG Brasil, obtenha uma aqui.

Taxas CDI e SELIC

Com este método, todos os dados são retornados em uma única requisição.

Dados retornados:
Taxas brasileiras: CDI, SELIC e fator diário.

GET https://api.hgbrasil.com/finance/taxes?format=json&key=SUA-CHAVE
visualizar resposta

Parâmetros:

format: (formato de resposta)
- json
- json-cors (liberado para AJAX, requer chave com domínio correto)
- php-serialize
- debug (resposta em JSON indentado, recomenda-se apenas para leitura)

key: (sua chave de API)
- informe sua chave de API HG Brasil, obtenha uma aqui.

Dados históricos

Com este método, você pode acessar dados históricos registrados pela API.
Esse método necessita da contratação de um plano que tenha suporte à dados históricos.
Conheça os planos da API.

Dados retornados:
Os mesmos do endpoint principal da API.

GET https://api.hgbrasil.com/finance/historical?format=json&days_ago=10&key=SUA-CHAVE
visualizar resposta

Parâmetros:

- Você pode escolher a data por 3 tipos de filtros diferentes:

Por intervalo de datas:

start_date: (data de inicio)
- string yyyy-mm-dd

end_date: (data de término)
- string yyyy-mm-dd

Por data única:

date: (data)
- string yyyy-mm-dd

Por número de dias atrás:

days_ago: (número de dias atrás)
- inteiro

- Você pode obter todos os dados, ou somente um usando o filtro mode:

mode: (dados desejados)
- string (disponíveis: all, currencies, stocks, bitcoin, taxes)

format: (formato de resposta)
- json
- json-cors (liberado para AJAX, requer chave com domínio correto)
- php-serialize
- debug (resposta em JSON indentado, recomenda-se apenas para leitura)

key: (sua chave de API)
- informe sua chave de API HG Brasil, obtenha uma aqui.
Criar nova chave gratuita

Atenção!

Não garantimos a precisão dos dados fornecidos pela API ou contidos nesta página, uma vez que devem ser utilizados apenas para efeitos informativos. Recomendamos que confirme todos os dados antes de efetuar qualquer ação que possa ser afetada por estes valores. Os dados são obtidos de fontes públicas da internet e podem sofrer alterações sem aviso prévio. O IP de origem, assim como a chave de API, são armazenados pelo sistema a fim de monitoramento do consumo de dados. Existem alguns limites no número de consultas, você pode verificar aqui, seu acesso pode ser restringido caso o limite seja atingido, ou se houver riscos à integridade do sistema no caso de sobrecargas oriundas de suas consultas. Entre em contato para consultas em larga escala ou para obter atualizações dos dados mais frequentes. Limites podem ser alterados ou impostos sem aviso prévio.

Confira os termos de uso do sistema para mais informações.