# HG Brasil API

> Documentação oficial das APIs de Finanças, Clima e Geolocalização da HG Brasil.

## Documentation Sets

- [HG Brasil API — documentação completa](https://hgbrasil.com/llms-full.txt): Referência completa das APIs de Finanças, Clima e Geolocalização da HG Brasil em um único documento.

## Guia

Como autenticar, formatar requisições e lidar com erros da API.

- [Documentação](https://hgbrasil.com/raw/docs/guide.md): Documentação completa das APIs da HG Brasil. Aprenda a integrar mercado financeiro, previsão do tempo e geolocalização em sua aplicação.
- [Chave de Integração](https://hgbrasil.com/raw/docs/guide/key.md): Siga este passo a passo para criar a sua chave de API e começar a integrar os serviços à sua aplicação.
- [CORS](https://hgbrasil.com/raw/docs/guide/cors.md): Configuração para permitir requisições de diferentes origens em aplicações web.
- [Respostas Formatadas](https://hgbrasil.com/raw/docs/guide/response-format.md): Suportamos diversos formatos de retorno em nossa API para melhor atender à sua aplicação.
- [Boas Práticas](https://hgbrasil.com/raw/docs/guide/best-practices.md): Recomendações para garantir uma integração eficiente, escalável e robusta.
- [Erros](https://hgbrasil.com/raw/docs/guide/erros.md): Entenda o formato de erros retornados pela API e consulte a lista completa de códigos.

## Mercado Financeiro

Moedas, criptomoedas, ações, dividendos, fundamentos e histórico.

- [Mercado Financeiro](https://hgbrasil.com/raw/docs/finance.md): Dados financeiros atualizados e precisos.
- [Demonstração de Resultados (DREs)](https://hgbrasil.com/raw/docs/finance/income-statements.md): Consulte a demonstração do resultado do exercício (DREs) de ações e outros ativos listados na B3, com dados anuais e trimestrais.
- [Fluxo de Caixa](https://hgbrasil.com/raw/docs/finance/cash-flows.md): Consulte a demonstração do fluxo de caixa de ações e outros ativos listados na B3, com dados anuais e trimestrais.
- [Indicadores Econômicos](https://hgbrasil.com/raw/docs/finance/indicators.md): Acesse IPCA, IGP-M, SELIC, CDI e outros indicadores econômicos brasileiros com séries históricas completas.
- [Cotações Históricas](https://hgbrasil.com/raw/docs/finance/history.md): Acesse o histórico de cotações de ações, fundos imobiliários, BDRs, ETFs e outros ativos negociados na B3 (Ibovespa).
- [Moedas](https://hgbrasil.com/raw/docs/finance/currencies.md): Dados das cotações de moedas.
- [Criptomoedas](https://hgbrasil.com/raw/docs/finance/crypto.md): Cotação do Bitcoin e das principais criptomoedas.
- [Bolsa de Valores](https://hgbrasil.com/raw/docs/finance/stocks.md): Cotações dos principais indicadores do mercado financeiro, além de informações detalhadas sobre ações e FIIs negociados no Ibovespa.
- [Índices](https://hgbrasil.com/raw/docs/finance/indices.md): Cotações dos principais índices do mercado financeiro.
- [Dividendos e Proventos](https://hgbrasil.com/raw/docs/finance/dividends.md): Consulte dividendos, JCP, bonificações e outros proventos de ações, fundos imobiliários e BDRs negociados na B3 (Ibovespa).
- [Grupamentos e Desdobramentos](https://hgbrasil.com/raw/docs/finance/splits.md): Consulte grupamentos e desdobramentos de ações, fundos imobiliários e BDRs negociados na B3 (Ibovespa).
- [Dados Fundamentalistas](https://hgbrasil.com/raw/docs/finance/fundamentals.md): Consulte uma visão consolidada de ações e outros ativos listados na B3, com cotação, indicadores fundamentalistas, dividendos e muito mais.
- [Balanço Patrimonial](https://hgbrasil.com/raw/docs/finance/balance-sheets.md): Consulte o balanço patrimonial de ações e outros ativos listados na B3, com dados anuais e trimestrais.

## Previsão do Tempo

Condições atuais, histórico meteorológico e localização.

- [Previsão do Tempo](https://hgbrasil.com/raw/docs/weather.md): Dados meteorológicos atualizados e precisos.
- [Localização](https://hgbrasil.com/raw/docs/weather/finding.md): Obtenha dados de previsão do tempo para uma cidade ou região específica.
- [Histórico](https://hgbrasil.com/raw/docs/weather/historical.md): Acesse dados passados de previsão do tempo, essenciais para análises de tendências e comparações de desempenho ao longo do tempo.
- [Ícones](https://hgbrasil.com/raw/docs/weather/icons.md): Ícones que representam as condições climáticas atuais e previsões do tempo.

## Localização por IP

Geolocalização a partir de endereços IPv4 e IPv6.

- [Localização por IP](https://hgbrasil.com/raw/docs/geo.md): Obtenha a localização dos usuários através do IP. Entenda o seu público e personalize a experiência da sua plataforma.
- [IPv4 / IPv6](https://hgbrasil.com/raw/docs/geo/ip.md): Localize geograficamente um endereço de IP.