HG Finance API

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

Veja alguns exemplos de dados reais e de como implementar

Veja como é simples e prático implementar em seu site ou aplicativo nossa API de dados financeiros!

Documentação completa Bibliotecas Criar nova chave

API de dados financeiros para seu site ou aplicativo

Cotação das principais moedas para o Real

-2,215 %

R$ 5,23

usd Dólar / BRL Real

-1,41 %

R$ 6,30

eur Euro / BRL Real

-0,917 %

R$ 7,05

gbp Libra / BRL Real

-1,113 %

R$ 0,06

ars Peso / BRL Real

0,0 %

R$ 4,03

cad Canadense / BRL Real

-0,001 %

R$ 3,85

aud Australianos / BRL Real

0,059 %

R$ 0,05

jpy Iene / BRL Real

-0,005 %

R$ 0,79

cny Renminbi / BRL Real

Cotação do BitCoin nas principais corretoras

-1,926 %

$18,750.52

coinbase / USD Dólar

-2,144 %

$18,717.60

bitstamp / USD Dólar

-0,791 %

R$ 99.339,02

foxbit / BRL Real

-1,165 %

R$ 99.131,17

mercado bitcoin / BRL Real

Índices de bolsas de valores pelo mundo

2,13 %

ibovespa
São Paulo, Brasil

1,28 %

nasdaq
New York, EUA

63,09 %

cac
Paris, França

-0,12 %

nikkei
Tokyo, Japan

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

7,68 %

Cogna Educação S.A.
COGN3

7,51 %

Estácio Participações S.A.
YDUQ3

7,15 %

EcoRodovias Infraestrutura e Logística S.A.
ECOR3

6,0 %

Multiplan Empreendimentos Imobiliários S.A.
MULT3

Há mais de 10 anos no ar, com recursos que você irá amar

Veja como em poucos minutos sua aplicação estará repleta de dados financeiros!

Simples e prático

Todos os dados que você precisa, no menor número de requisições possível.

Cotação das pricipais moedas para o Real;

Cotação do Bitcoin nas principais corretoras;

Índice das principais bolsas de valores do mundo;

Preço e variação de ações na IBOVESPA;

Temos novidade!
Lista das maiores altas e baixas no IBOVESPA;

Taxa SELIC e CDI;

Veja a documentação completa

Desenvolvido de programador para programador

API sem complicações.
Nada de autenticações e métodos complexos.

Documentação completa e direto ao ponto, sem enrolação.

Autenticação simples via parâmetro GET;

Respostas completas em uma única requisição;

Liberado para no navegador (CORS);

Exemplos de respostas;

Bibliotecas para download;

Crie sua chave agora mesmo

Status
  • Operando normamente
    Aplicação API: OK
    Website: OK
    HG Console: OK
    Rotinas: OK
    Fontes de dados: OK
    HG Finance: OK
  • Requisições hoje: 86.465
  • Latência: 49.09 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), Dólar Canadense (CAD), Dólar Australiano (AUD), Iene do Japão (JPY), Renminbi da China (CNY) e Bitcoin (BTC);
- cotação do bitcoin nas principais exchanges como Coinbase, Blockchain.info, BitStamp, FoxBit e Mercado Bitcoin;
- 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
    • selic_daily - taxa Selic diária em percentual
    • cdi_daily - taxa CDI diária em percentual

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":5.3753,"sell":5.3752,"variation":-1.06},"EUR":{"name":"Euro","buy":6.388,"sell":6.393,"variation":-0.71},"GBP":{"name":"Pound Sterling","buy":7.2177,"sell":null,"variation":0.85},"ARS":{"name":"Argentine Peso","buy":0.067,"sell":null,"variation":-0.09},"CAD":{"name":"Canadian Dollar","buy":4.1351,"sell":null,"variation":-0.001},"AUD":{"name":"Australian Dollar","buy":3.9575,"sell":null,"variation":0.0},"JPY":{"name":"Japanese Yen","buy":0.0515,"sell":null,"variation":-0.071},"CNY":{"name":"Renminbi","buy":0.8155,"sell":null,"variation":0.002},"BTC":{"name":"Bitcoin","buy":108450.786,"sell":108450.786,"variation":0.165}},"stocks":{"IBOVESPA":{"name":"BM\u0026F BOVESPA","location":"Sao Paulo, Brazil","points":109786.297,"variation":2.24},"NASDAQ":{"name":"NASDAQ Stock Market","location":"New York City, United States","points":12036.79,"variation":1.31},"CAC":{"name":"CAC 40","location":"Paris, French","variation":1.21},"NIKKEI":{"name":"Nikkei 225","location":"Tokyo, Japan","variation":1.59}},"available_sources":["BRL"],"bitcoin":{"blockchain_info":{"name":"Blockchain.info","format":["USD","en_US"],"last":19033.74,"buy":19033.74,"sell":19033.74,"variation":0.165},"coinbase":{"name":"Coinbase","format":["USD","en_US"],"last":19045.12,"variation":0.653},"bitstamp":{"name":"BitStamp","format":["USD","en_US"],"last":19043.73,"buy":19046.9,"sell":19033.73,"variation":0.427},"foxbit":{"name":"FoxBit","format":["BRL","pt_BR"],"last":103440.17,"variation":0.183},"mercadobitcoin":{"name":"Mercado Bitcoin","format":["BRL","pt_BR"],"last":104150.0,"buy":103999.99001,"sell":104150.0,"variation":0.357}},"taxes":[{"date":"2020-11-23","cdi":2.0,"selic":2.0,"daily_factor":1.00007469,"selic_daily":1.9,"cdi_daily":1.9}]},"execution_time":0.0,"from_cache":true}

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

API gratuita para obter preço de ações na bolsa de valores BOVESPA!

Com esse endpoint você pode obter o preço de uma ação listada no IBOVESPA através do símbolo desse título.
Sendo membro a partir do plano Professional, você pode obter até 5 títulos de uma só vez, basta informar os símbolos separados por vírgula.
Planos acima do Professional oferencem um maior número de títulos ao mesmo tempo, confira aqui nossos planos.

Delay:
API para fins informativos, os dados podem estar atrasados entre 15 minutos e 1 hora.
É possível conferir o horário de atualização do dado no updated_at.

Títulos disponíveis: veja a lista.

Requer chave: sim

Os dados são obtidos a partir do símbolo de uma empresa (veja a lista), através do parâmetro symbol.
Plano gratuito está limitado a apenas 1 símbulo por vez.

https://api.hgbrasil.com/finance/stock_price?key=SUA-CHAVE&symbol=bidi4


Nos planos Professional ou Enterprise é possível obter vários símbolos nas mesma consulta, separando por vírgula.

https://api.hgbrasil.com/finance/stock_price?key=SUA-CHAVE&symbol=bidi4,petr4,qual3,ciel3
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":{"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":16685.6,"price":22.58,"change_percent":-0.22,"updated_at":"2020-11-24 20:48:26"},"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":64939.0,"price":26.23,"change_percent":4.5,"updated_at":"2020-11-24 20:48:26"},"QUAL3":{"symbol":"QUAL3","name":"Qualicorp Consultoria e Corretora de Seguros S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":9900.74,"price":34.86,"change_percent":0.61,"updated_at":"2020-11-24 20:48:26"},"CIEL3":{"symbol":"CIEL3","name":"Cielo S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":10215.2,"price":3.74,"change_percent":-0.8,"updated_at":"2020-11-24 20:48:26"}},"execution_time":0.01,"from_cache":false}

Obtendo as ações com as maiores altas ou baixas no IBOVESPA

Novidade! Este endpoint acabou de sair do forno!

Agora é possível obter a lista de títulos com as maiores altas ou baixas!

Com esse endpoint você pode obter a lista de títulos que estão em maiores altas ou baixas.
O número de empresas retornadas na lista varia de acordo com o plano contratado.

Conheça nossos planos

Delay:
API para fins informativos, os dados podem estar atrasados entre 15 minutos e 1 hora.
É possível conferir o horário de atualização do dado no updated_at.

Títulos disponíveis: veja a lista.

Requer chave: sim
Requer plano: para retornar mais de um, varia de acordo com o plano

A lista é gerada apenas com os símbolo que fazem estão em nossa plataforma, veja a lista aqui.
Plano gratuito está limitado a apenas 1 símbulo por vez.

Para obter as maiores altas, informe no parâmetro symbol a opção get-high, exemplo:

https://api.hgbrasil.com/finance/stock_price?key=SUA-CHAVE&symbol=get-high


E para obter as maiores baixas, informe no parâmetro symbol a opção get-low, exemplo:

https://api.hgbrasil.com/finance/stock_price?key=SUA-CHAVE&symbol=get-low


A estrutura de dados é a mesma para o retorno de títulos do IBOVESPA.

Atenção! Exoneração de responsabilidade

Exemplo de resposta JSON
{"by":"get_high_symbols","valid_key":true,"results":{"MYPK3":{"symbol":"MYPK3","name":"Iochpe-Maxion S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":2335.0,"price":15.19,"change_percent":9.99,"updated_at":"2020-11-24 20:48:26"},"BRML3":{"symbol":"BRML3","name":"BR Malls Participações S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":8757.61,"price":10.03,"change_percent":7.5,"updated_at":"2020-11-24 20:48:26"},"MULT3":{"symbol":"MULT3","name":"Multiplan Empreendimentos Imobiliários S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":13399.3,"price":23.46,"change_percent":6.98,"updated_at":"2020-11-24 20:48:26"},"YDUQ3":{"symbol":"YDUQ3","name":"Estácio Participações S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":9754.84,"price":31.56,"change_percent":6.69,"updated_at":"2020-11-24 20:48:26"},"IGTA3":{"symbol":"IGTA3","name":"Iguatemi Empresa de Shopping Centers S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":6441.02,"price":36.47,"change_percent":6.48,"updated_at":"2020-11-24 20:48:26"},"USIM5":{"symbol":"USIM5","name":"Usinas Siderúrgicas de Minas Gerais S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":15995.0,"price":12.48,"change_percent":6.12,"updated_at":"2020-11-24 20:48:26"},"MILS3":{"symbol":"MILS3","name":"Mills Estruturas e Servicos de Engenharia S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":1642.74,"price":6.52,"change_percent":6.02,"updated_at":"2020-11-24 20:48:26"},"CSNA3":{"symbol":"CSNA3","name":"Companhia Siderúrgica Nacional","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":5827.6,"price":22.57,"change_percent":5.71,"updated_at":"2020-11-24 20:48:26"},"PETR3":{"symbol":"PETR3","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":64939.0,"price":26.81,"change_percent":5.22,"updated_at":"2020-11-24 20:48:26"},"TASA4":{"symbol":"TASA4","name":"Taurus Armas S.A.","region":"Brazil/Sao Paolo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"market_cap":931.81,"price":10.91,"change_percent":4.9,"updated_at":"2020-11-24 20:48:26"}},"execution_time":0.04,"from_cache":false}

 

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.