HG Finance

Tenha dados econômicos no seu site de uma maneira simples e funcional.
Veja como é fácil implementar, comece agora!

Sua aplicação fica muito mais completa com nossas APIs

A HG Brasil sempre prezou pela qualidade das APIs, neste ano de 2019, comemoramos 10 anos no ar!

Nossas APIs foram feitas de desenvolvedor para desenvolvedor, documentações completas e objetivas, sem enrolação.
Em poucos minutos e com uma única chave de acesso, você tem acesso à todos os nossos dados na sua aplicação.

Seja o dólar, uma ação, o bitcoin, um índice, como está o tempo, como vai estar o tempo, a geolocalização por IP e muito mais...
Comece agora! Os principais dados possuem acesso gratuito!

Documentação completa Bibliotecas Criar chave gratuita
Documentação completa Bibliotecas Criar nova chave

API de dados financeiros para seu site ou aplicativo

Cotação das principais moedas para o Real

-0,249 %

R$ 3,76

usd Dólar / BRL Real

-0,106 %

R$ 4,22

eur Euro / BRL Real

0,064 %

R$ 4,68

gbp Libra / BRL Real

0,453 %

R$ 0,09

ars Peso / BRL Real

Cotação do BitCoin nas principais corretoras

-1,398 %

$9,803.01

coinbase / USD Dólar

-2,552 %

R$ 36.349,01

xdex / BRL Real

-1,561 %

R$ 37.797,54

foxbit / BRL Real

-2,434 %

R$ 36.879,97

mercado bitcoin / BRL Real

Índices de bolsas de valores pelo mundo

0,08 %

ibovespa
São Paulo, Brasil

-0,46 %

nasdaq
New York, EUA

-0,76 %

cac
Paris, França

-1,86 %

nikkei
Tokyo, Japan

Preço e variação de ações na bolsa de valores BOVESPA

4,44 %

Magazine Luiza S.A.
MGLU3

3,99 %

Centrais Elétricas Brasileiras S.A. - Eletrobras
ELET3

3,88 %

Centrais Elétricas Brasileiras S.A. - Eletrobras
ELET6

3,65 %

Lojas Americanas S.A.
LAME4

Status
  • Operando normamente
    Aplicação API: OK
    Website: OK
    HG Console: OK
    Rotinas: OK
    Fontes de dados: OK
    HG Finance: OK
  • Requisições hoje: 1.072
  • Latência: 21.99 ms
Download da biblioteca em PHP Gem para integração Ruby
Planos e Preços Obter suporte
Índice IBOVESPA

Índice IBOVESPA


Obtendo contações de moedas, índices dos mercados, criptomoedas e taxas

O HG Finance é uma API que fornece dados dados financeiros com o foco em trazer o máximo de informações em uma só requisição.
API fácil de implementar, com respostas e parâmetros objetivos, com bibliotecas em PHP, Ruby e JavaScript. (em breve)

Mesmo que sua aplicação não seja com essas linguagens, abaixo você pode conferir como integrar a API.
Todos esses dados são retornados na mesma requisição de uma só vez, sendo esses dados:

Em uma só requisição, você pode obter:
- as posições das principais bolsas de valores como IBOVESPA, NASDAQ, CAC 40 e NIKKEI;
- a cotação de diversas moedas em relação ao real como Dólar (USD), Euro (EUR), Libra (GBP), Peso (ARS) e Bitcoin (BTC);
- cotação do bitcoin nas principais exchanges como Coinbase, Blockchain.info, BitStamp, FoxBit, OmniTrade, Mercado Bitcoin e XDEX;
- as principais taxas de juros do Brasil como CDI e Selic.

Tudo isso em uma só requisição.

Recomendamos que sempre use sua chave, algumas informações só estão disponíveis com o uso da chave.

Criar nova chave

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

https://api.hgbrasil.com/finance

Estrutura de dados

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 - cotação das moedas
    • source - moeda base de cotação
    • ISO da moeda
      • name - nome da moeda
      • buy - valor para compra
      • sell - valor para venda (não disponível para algumas moedas)
      • variation - variação em percentual referente à última hora útil anterior
  • stocks - posições dos principais mercados
    • índice
      • name - nome do índice
      • location - localização do mercado
      • points - pontos (somente IBOVESPA)
      • variation - variação em percentual referente à última hora útil anterior
  • bitcoin - cotação nas principais corretoras
    • corretora
      • name - nome do índice
      • format - array, moeda base de câmbio
        • 0 - ISO da moeda
        • 1 - idioma da moeda
      • last - última posição
      • buy - valor para compra (pode não estar disponível)
      • sell - valor para venda (pode não estar disponível)
      • variation - variação em percentual referente à última hora útil anterior
  • taxes - taxas de juros do Brasil
    • date - data de referência
    • cdi - taxa CDI em percentual
    • selic - taxa Selic em percentual
    • daily_factor - fator diário

Você pode personalizar o resultado da consulta omitindo alguns dados veja como.

Exemplo de resposta JSON
{"by":"default","valid_key":true,"results":{"currencies":{"source":"BRL","USD":{"name":"Dollar","buy":3.7404,"sell":3.7401,"variation":-0.296},"EUR":{"name":"Euro","buy":4.2167,"sell":4.2161,"variation":-0.284},"GBP":{"name":"Pound Sterling","buy":4.7017,"sell":null,"variation":-0.119},"ARS":{"name":"Argentine Peso","buy":0.09,"sell":null,"variation":-0.111},"BTC":{"name":"Bitcoin","buy":45963.65,"sell":45963.65,"variation":3.339}},"stocks":{"IBOVESPA":{"name":"BM\u0026F BOVESPA","location":"Sao Paulo, Brazil","points":104409.383,"variation":-0.7},"NASDAQ":{"name":"NASDAQ Stock Market","location":"New York City, United States","points":8235.92,"variation":0.49},"CAC":{"name":"CAC 40","location":"Paris, French","variation":0.38},"NIKKEI":{"name":"Nikkei 225","location":"Tokyo, Japan","variation":0.2}},"available_sources":["BRL"],"bitcoin":{"blockchain_info":{"name":"Blockchain.info","format":["USD","en_US"],"last":11592.86,"buy":11592.86,"sell":11592.86,"variation":3.339},"coinbase":{"name":"Coinbase","format":["USD","en_US"],"last":11592.005,"variation":3.407},"bitstamp":{"name":"BitStamp","format":["USD","en_US"],"last":11605.19,"buy":11605.19,"sell":11598.25,"variation":3.531},"foxbit":{"name":"FoxBit","format":["BRL","pt_BR"],"last":44497.82,"variation":3.243},"mercadobitcoin":{"name":"Mercado Bitcoin","format":["BRL","pt_BR"],"last":44239.96,"buy":44010.00003,"sell":44240.0,"variation":2.294},"omnitrade":{"name":"OmniTrade","format":["BRL","pt_BR"],"last":44700.0,"buy":44700.0,"sell":45000.0,"variation":2.288},"xdex":{"name":"XDEX","format":["BRL","pt_BR"],"last":43850.0,"variation":2.453}},"taxes":[{"date":"2019-07-11","cdi":6.4,"selic":6.4,"daily_factor":1.0002462}]},"execution_time":0.0,"from_cache":true}

Obtendo o preço de ações listadas no IBOVESPA

Com esse endpoint você pode obter o preço de uma ação listada no IBOVESPA através do símbolo desse título.
Você pode obter até 5 títulos de uma só vez, basta informar os símbolos separados por vírgula.

Requer chave: sim
Requer plano: sim (Professional ou Enterprise)

Os dados são obtidos a partir do símbolo de uma empresa, através do parâmetro symbol.

https://api.hgbrasil.com/finance/stock_price?key=SUA-CHAVE&symbol=petr4,bidi4,embr3,btow3,cpfe3
Estrutura de dados

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 - cotação das moedas
    • symbol - símbolo da ação
    • name - nome da empresa
    • region - região de operação da bolsa
    • currency - moeda base
    • market_time - horário de negociação
      • open - horário de abertura
      • close - horário de fechamento
      • timezone - fuso horário
    • market_cap - valor de mercado (em milhões)
    • price - preço por ação
    • change_percent - percentual de mudança do dia
    • updated_at - última atualização

Atenção! Exoneração de responsabilidade

Exemplo de resposta JSON
{"by":"symbol","valid_key":true,"results":{"PETR4":{"symbol":"PETR4","name":"Petróleo Brasileiro S.A. - Petrobras","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":106288.0,"price":28.55,"change_percent":0.53,"updated_at":"2019-07-12 16:05:53"},"BIDI4":{"symbol":"BIDI4","name":"Banco Inter S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":4170.01,"price":13.71,"change_percent":-1.37,"updated_at":"2019-07-12 16:05:53"},"EMBR3":{"symbol":"EMBR3","name":"Embraer S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":15194.3,"price":19.21,"change_percent":0.05,"updated_at":"2019-07-12 16:05:53"},"BTOW3":{"symbol":"BTOW3","name":"B2W - Companhia Digital","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":17788.2,"price":38.85,"change_percent":-1.7,"updated_at":"2019-07-12 16:05:53"},"CPFE3":{"symbol":"CPFE3","name":"CPFL Energia S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":36111.6,"price":31.34,"change_percent":-1.54,"updated_at":"2019-07-12 16:05:53"}},"execution_time":0.0,"from_cache":true}

 

Veja nossa documentação completa!

Nossa documentação é simples e intuitiva, veja como é simples integrar sua aplicação às APIs HG Brasil!
Clara, simples e objetiva, feita de desenvolvedor para desenvolvedor.

Ver documentação

Exoneração de responsabilidade

API para fins informativos. 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. Trabalhamos pela estabilidade e precisão dos dados, porém, os dados podem estar atrasados ou errados "no estado em que se encontram", confirme todos os dados antes de efetuar qualquer ação que possa ser afetada por estes valores, assim como demais endpoints da API.

Qualquer dúvida verifique nossos termos de uso ou entre em contato.