A melhor API de finanças

API de ações, dividendos, cotação de moedas, índices e dados históricos.

Desde 2009 no ar, com suporte, qualidade e facilidade de uso.

Confiado por esses, e mais 50 mil clientes verificados.

Logo da empresa Nic.br
Logo da empresa Me Poupe
Logo da empresa Iguatemi
Logo da empresa Istoé

Simplicidade para implementar

Documentação objetiva, com qualidade nos retornos e segurança.

Serviço 100% brasileiro

Foco no mercado nacional, com cobrança em real sem surpresas e atendimento em português.

Desde 2009 no mercado

Confiança e qualidade de quem já está há anos no mercado de fornecimento de dados.

Índice IBOVESPA agora


Tudo que você precisa

No menor número de requisições possível.

Cotação de moedas para o Real;

Bitcoin nas principais corretoras;

Índice das principais bolsas de valores do mundo;

Cotação de ações na IBOVESPA;

Fundos imobiliários;

Preço de BDRs;

API para obter dividendos;

Lista das maiores altas e baixas no IBOVESPA;

Temos novidade!
Logotipo das empresas listadas;

Taxa SELIC e CDI;

Veja a documentação completa

Veja na prática tudo que você pode consumir, clicando nos ativos abaixo

Desenvolvido de programador para programador

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
Exemplo de retorno de dados



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 dos principais índices como IBOVESPA, IFIX, NASDAQ, Dow Jones, 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:

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.0329,"sell":5.0329,"variation":0.0},"EUR":{"name":"Euro","buy":5.3281,"sell":5.3281,"variation":-0.0},"GBP":{"name":"Pound Sterling","buy":6.1399,"sell":null,"variation":-0.0},"ARS":{"name":"Argentine Peso","buy":0.0144,"sell":null,"variation":-0.228},"CAD":{"name":"Canadian Dollar","buy":3.7046,"sell":null,"variation":0.038},"AUD":{"name":"Australian Dollar","buy":3.2351,"sell":null,"variation":0.001},"JPY":{"name":"Japanese Yen","buy":0.0337,"sell":null,"variation":-0.021},"CNY":{"name":"Renminbi","buy":0.6899,"sell":null,"variation":-0.001},"BTC":{"name":"Bitcoin","buy":149668.45,"sell":149668.45,"variation":4.274}},"stocks":{"IBOVESPA":{"name":"BM\u0026F BOVESPA","location":"Sao Paulo, Brazil","points":116565.17,"variation":0.72},"IFIX":{"name":"Índice de Fundos de Investimentos Imobiliários B3","location":"Sao Paulo, Brazil","points":3219.28,"variation":0.82},"NASDAQ":{"name":"NASDAQ Stock Market","location":"New York City, United States","points":13219.32,"variation":0.14},"DOWJONES":{"name":"Dow Jones Industrial Average","location":"New York City, United States","points":33507.5,"variation":-0.47},"CAC":{"name":"CAC 40","location":"Paris, French","points":7135.06,"variation":0.26},"NIKKEI":{"name":"Nikkei 225","location":"Tokyo, Japan","points":31857.62,"variation":-0.05}},"available_sources":["BRL"],"bitcoin":{"blockchain_info":{"name":"Blockchain.info","format":["USD","en_US"],"last":28054.73,"buy":28054.73,"sell":28054.73,"variation":4.274},"coinbase":{"name":"Coinbase","format":["USD","en_US"],"last":28060.54,"variation":4.261},"bitstamp":{"name":"BitStamp","format":["USD","en_US"],"last":28057.0,"buy":28056.0,"sell":28055.0,"variation":4.231},"foxbit":{"name":"FoxBit","format":["BRL","pt_BR"],"last":141354.0,"variation":3.966},"mercadobitcoin":{"name":"Mercado Bitcoin","format":["BRL","pt_BR"],"last":140929.00005,"buy":140934.0,"sell":141151.21085162,"variation":3.759}},"taxes":[{"date":"2023-09-28","cdi":12.75,"selic":12.75,"daily_factor":1.00047279,"selic_daily":12.65,"cdi_daily":12.65}]},"execution_time":0.0,"from_cache":true}

Obtendo o preço de ações e 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.



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

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
  • sector - setor de atuação da empresa ou fundo
  • financials
    • equity - valor patrimonial (somente FIIs)
    • quota_count - cotas emitidas (FIIs / ordinária / preferencial)
    • equity_per_share - valor patrimonial por cota (somente FIIs)
    • price_to_book_ratio - preço sobre valor patrimonial
    • dividends - informações sobre dividendos
      • yield_12m - percentual yield últ. 12 meses
      • yield_12m_sum - soma últ. 12 meses em reais
  • 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
  • change_price - variação do dia em valor
  • updated_at - última atualização

Atenção! Exoneração de responsabilidade

Exemplo de resposta JSON
{"by":"symbol","valid_key":true,"results":{"EMBR3":{"kind":"stock","symbol":"EMBR3","name":"Embraer","company_name":"Embraer S.A.","document":"07.689.002/0001-89","description":"Projeto. Desenvolvimento. Fabricação. Comercialização de Aeronaves E Sistemas E Fornecimento de Suporte E Serviços de Pós-venda.","website":"http://www.embraer.com.br/","sector":"Bens Industriais / Material de Transporte / Material Aeronáutico e de Defesa","financials":{"quota_count":740465044,"dividends":{"yield_12m":0.0,"yield_12m_sum":0.0}},"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/embraer.png","big":"https://assets.hgbrasil.com/finance/companies/big/embraer.png"},"market_cap":12750.8,"price":17.22,"change_percent":0.41,"change_price":0.07,"updated_at":"2023-10-01 20:53:15"},"HGLG11":{"kind":"fii","symbol":"HGLG11","name":"FII CSHG Log","company_name":"CSHG Logstica Fundo Investimento Imobiliario FII","document":"11.728.688/0001-47","description":"Financeiro e Outros/Fundos/Fundos Imobiliários","website":"https://www.cshg.com.br/","sector":"Imóveis Industriais e Logísticos","financials":{"equity":5176423292,"quota_count":33787575,"equity_per_share":153.205,"price_to_book_ratio":1.054,"dividends":{"yield_12m":9.103,"yield_12m_sum":14.7}},"region":"Brazil/Sao Paulo","currency":"BRL","market_time":{"open":"10:00","close":"17:30","timezone":-3},"logo":null,"market_cap":5456.02,"price":161.48,"change_percent":0.61,"change_price":0.98,"updated_at":"2023-10-01 20:53:15"},"ITSA4":{"kind":"stock","symbol":"ITSA4","name":"Itaúsa","company_name":"ItauSA S.A.","document":"61.532.644/0001-15","description":"Gestão de Participações Societárias (holding)","website":"http://www.itausa.com.br/","sector":"Financeiro / Intermediários Financeiros / Bancos","financials":{"quota_count":0,"dividends":{"yield_12m":null,"yield_12m_sum":null}},"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/itausa.png","big":"https://assets.hgbrasil.com/finance/companies/big/itausa.png"},"market_cap":89188.4,"price":9.05,"change_percent":0.33,"change_price":0.03,"updated_at":"2023-10-01 20:53:15"}},"execution_time":0.02,"from_cache":false}

Estamos aqui para tirar suas dúvidas

Colocamos aqui algumas dúvidas frequentes que recebemos. Para mais
informações, por favor entre em contato conosco.

Contato por e-mail Abrir um chamado de suporte
Q.

Funciona na minha liguagem de programação?

Sim! Nossa API pode ser implementada em qualquer linguagem de programação. Utilizamos padrão de mercado, com documentação completa e objetiva.

Q.

O que acontece quando utilizo todo o meu limite?

Quando seu limite é excedido, novas consultas não serão mais permitidas dentro do período. Mas não se preocupe, caso venha a ocorrer, você receberá um e-mail notificando.

Q.

Como funciona o plano gratuito?

Quase todos os retornos estão presentes no plano gratuito, salvo algumas exceções. O que muda é o volume de consultas que você pode fazer. Saiba mais em nossos planos.

Q.

Existe período de testes?

Não, mas caso venha a contratar um de nossos planos, e o serviço não lhe atenda, dentro dos 7 primeiros dias fazemos o reembolso integral do valor pago.