HG Finance API

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

API para cotação de preço para ação Engie Brasil Energia S.A. EGIE3

Obtendo o preço de ações ou FIIs listados no IBOVESPA

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

Novidade!

Consulte também fundos imobiliários!

Com esse endpoint você pode obter o preço de uma ação listada no IBOVESPA através do símbolo desse título.
Atenção! É necessário ser membro à partir do plano Member Premium para realizar essa consulta.
Planos acima 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
Requer plano: sim, plano Member Premium ou superior

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

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


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=egie3,embr3,hglg11,itsa4
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.

  • kind - tipo do título
    • stock - ação
    • fii - fundo imobiliário
  • symbol - símbolo / ticker da ação
  • name - nome da empresa
  • company_name - razão social
  • document - documento / CNPJ da empresa
  • description - descrição da empresa
  • website - sita da empresa / relação com investidores
  • 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
  • logo - logotipo da empresa
    • small - URL para imagem em PNG 256 x 256
    • big - URL para imagem em PNG 1.280 x 1.280
  • 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":{"EGIE3":{"kind":"stock","symbol":"EGIE3","name":"Engie Brasil","company_name":"Engie Brasil Energia S.A.","document":"02.474.103/0001-19","description":"Geração E Comercialização de Energia Elétrica","website":"http://www.engie.com.br/","region":"Brazil/Sao Paulo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"logo":{"small":"https://assets.hgbrasil.com/finance/companies/small/engie-brasil.png","big":"https://assets.hgbrasil.com/finance/companies/big/engie-brasil.png"},"market_cap":33640.7,"price":41.23,"change_percent":0.88,"updated_at":"2023-04-29 20:51:16"}},"execution_time":6.72,"from_cache":false}

Confiança, qualidade e robustez, estamos há mais de 10 anos no mercado

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;

Lista das maiores altas e baixas no IBOVESPA;

Temos novidade!
Logotipo das empresas listadas;

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


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.