



















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.




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.
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 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;

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.
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 moedassource
- moeda base de cotação-
ISO da moeda
name
- nome da moedabuy
- valor para comprasell
- 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 índicelocation
- localização do mercadopoints
- 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âmbio0 - ISO da moeda
1 - idioma da moeda
last
- última posiçãobuy
- 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 Brasildate
- data de referênciacdi
- taxa CDI em percentualselic
- taxa Selic em percentualdaily_factor
- fator diárioselic_daily
- taxa Selic diária em percentualcdi_daily
- taxa CDI diária em percentual
Você pode personalizar o resultado da consulta omitindo alguns dados veja como.
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ítulostock
- açãofii
- fundo imobiliário
symbol
- símbolo / ticker da açãoname
- nome da empresacompany_name
- razão socialdocument
- documento / CNPJ da empresadescription
- descrição da empresawebsite
- sita da empresa / relação com investidoressector
- 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 dividendosyield_12m
- percentual yield últ. 12 mesesyield_12m_sum
- soma últ. 12 meses em reais
region
- região de operação da bolsacurrency
- moeda base-
market_time
- horário de negociaçãoopen
- horário de aberturaclose
- horário de fechamentotimezone
- fuso horário
-
logo
- logotipo da empresasmall
- URL para imagem em PNG 256 x 256big
- URL para imagem em PNG 1.280 x 1.280
market_cap
- valor de mercado (em milhões)price
- preço por açãochange_percent
- percentual de mudança do diachange_price
- variação do dia em valorupdated_at
- última atualização
Atenção! Exoneração de responsabilidade
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.
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.
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.
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.
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.