Obtenha dados de Previsão do Tempo, Cotações de Moedas, IBOVESPA e Geolocalização

Esta biblioteca visa facilitar as requisições dos dados da api da www.hgbrasil.com

Em casos de dúvida consulte a documentação oficial da HGBrasil.

Avisos

Esta não é uma biblioteca oficial da HGBrasil.
Informações como cotações de moedas e BOVESPA podem ser retornados com atrasos entre 15 minutos e 1 hora. Você pode conferir o horário da última atualização dos dados no updated_at.

Instalando

npm i brazuka-hgbrasil

yarn add brazuka-hgbrasil

Importando

const brazuka = require("brazuka-hgbrasil")

Previsão do Tempo (Weather)

Retorna os dados de previsão do tempo e condições climáticas atuais para uma cidade.

const brazuka = require("brazuka-hgbrasil")

var key = "11ad1a1f" //key gerada na www.hgbrasil.com
var city = "Frecheirinha"
var state = "CE"

brazuka.weather(key, city, state).then(function (res) {
    console.log(res.results)
})

Exemplo de Resposta

{
  "temp": 30,
  "date": "04/07/2021",
  "time": "16:51",
  "condition_code": "28",
  "description": "Tempo nublado", 
  "currently": "dia",
  "cid": "",
  "city": "Frecheirinha, CE",     
  "img_id": "28",
  "humidity": 48,
  "wind_speedy": "1.16 km/h",     
  "sunrise": "05:50 am",
  "sunset": "05:44 pm",
  "condition_slug": "cloudly_day",
  "city_name": "Frecheirinha",    
  "forecast": [
    {
      "date": "04/07",
      "weekday": "Dom",
      "max": 33,
      "min": 21,
      "description": "Parcialmente nublado",
      "condition": "cloudly_day"
    },
    {
      "date": "05/07",
      "weekday": "Seg",
      "max": 33,
      "min": 21,
      "description": "Tempo limpo",
      "condition": "clear_day"
    },
    {
      "date": "06/07",
      "weekday": "Ter",
      "max": 34,
      "min": 21,
      "description": "Chuvas esparsas",
      "condition": "rain"
    },
    {
      "date": "07/07",
      "weekday": "Qua",
      "max": 34,
      "min": 21,
      "description": "Chuva",
      "condition": "rain"
    },
    {
      "date": "08/07",
      "weekday": "Qui",
      "max": 33,
      "min": 21,
      "description": "Chuvas esparsas",
      "condition": "rain"
    },
    {
      "date": "09/07",
      "weekday": "Sex",
      "max": 33,
      "min": 21,
      "description": "Tempo nublado",
      "condition": "cloudly_day"
    },
    {
      "date": "10/07",
      "weekday": "Sáb",
      "max": 33,
      "min": 21,
      "description": "Parcialmente nublado",
      "condition": "cloudly_day"
    },
    {
      "date": "11/07",
      "weekday": "Dom",
      "max": 32,
      "min": 22,
      "description": "Tempo nublado",
      "condition": "cloudly_day"
    },
    {
      "date": "12/07",
      "weekday": "Seg",
      "max": 34,
      "min": 22,
      "description": "Parcialmente nublado",
      "condition": "cloudly_day"
    },
    {
      "date": "13/07",
      "weekday": "Ter",
      "max": 32,
      "min": 21,
      "description": "Tempo nublado",
      "condition": "cloudly_day"
    }
  ]
}

Cotação das Moedas (Dolar, Pesos Argentinos, Bitcoin entre outras)

Retorna a cotação de diversas moedas.

const brazuka = require("brazuka-hgbrasil")

var key = "11ad1a1f" //key gerada na www.hgbrasil.com

brazuka.financeCurrency(key).then(function (res) {
    console.log(res.results)
})

Exemplo de Resposta

{
    "by": "default",
    "valid_key": true,
    "results": {
        "currencies": {
            "source": "BRL",
            "USD": {
                "name": "Dollar",
                "buy": 5.053,
                "sell": 5.0586,
                "variation": 0.16
            },
            "EUR": {
                "name": "Euro",
                "buy": 5.996,
                "sell": 6.0024,
                "variation": 0.32
            },
            "GBP": {
                "name": "Pound Sterling",
                "buy": 6.992,
                "sell": null,
                "variation": 0.66
            },
            "ARS": {
                "name": "Argentine Peso",
                "buy": 0.053,
                "sell": null,
                "variation": 0.13
            },
            "CAD": {
                "name": "Canadian Dollar",
                "buy": 4.1044,
                "sell": null,
                "variation": 0.0
            },
            "AUD": {
                "name": "Australian Dollar",
                "buy": 3.8098,
                "sell": null,
                "variation": -0.001
            },
            "JPY": {
                "name": "Japanese Yen",
                "buy": 0.0456,
                "sell": null,
                "variation": -0.104
            },
            "CNY": {
                "name": "Renminbi",
                "buy": 0.7818,
                "sell": null,
                "variation": 0.002
            },
            "BTC": {
                "name": "Bitcoin",
                "buy": 186052.001,
                "sell": 186052.001,
                "variation": 4.301
            }
        },
        "stocks": {
            "IBOVESPA": {
                "name": "BM&F BOVESPA",
                "location": "Sao Paulo, Brazil",
                "points": 127621.65,
                "variation": 1.56
            },
            "NASDAQ": {
                "name": "NASDAQ Stock Market",
                "location": "New York City, United States",
                "points": 14639.33,
                "variation": 0.81
            },
            "CAC": {
                "name": "CAC 40",
                "location": "Paris, French",
                "variation": 1.77
            },
            "NIKKEI": {
                "name": "Nikkei 225",
                "location": "Tokyo, Japan",
                "variation": 0.92
            }
        },
        "available_sources": [
            "BRL"
        ],
        "bitcoin": {
            "blockchain_info": {
                "name": "Blockchain.info",
                "format": [
                    "USD",
                    "en_US"
                ],
                "last": 34735.95,
                "buy": 34735.95,
                "sell": 34735.95,
                "variation": 4.301
            },
            "coinbase": {
                "name": "Coinbase",
                "format": [
                    "USD",
                    "en_US"
                ],
                "last": 34835.95,
                "variation": 4.46
            },
            "bitstamp": {
                "name": "BitStamp",
                "format": [
                    "USD",
                    "en_US"
                ],
                "last": 34679.93,
                "buy": 34716.66,
                "sell": 34693.73,
                "variation": 4.112
            },
            "foxbit": {
                "name": "FoxBit",
                "format": [
                    "BRL",
                    "pt_BR"
                ],
                "last": 176300.0,
                "variation": 3.71
            },
            "mercadobitcoin": {
                "name": "Mercado Bitcoin",
                "format": [
                    "BRL",
                    "pt_BR"
                ],
                "last": 176379.31957,
                "buy": 176355.0,
                "sell": 176379.31945,
                "variation": 3.765
            }
        },
        "taxes": [
            {
                "date": "2021-07-01",
                "cdi": 4.25,
                "selic": 4.25,
                "daily_factor": 1.00016137,
                "selic_daily": 4.15,
                "cdi_daily": 4.15
            }
        ]
    },
    "execution_time": 0.0,
    "from_cache": true
}

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

Retorna o preço de ações na bolsa de valores BOVESPA!

Títulos disponíveis (symbols): veja a lista

const brazuka = require("brazuka-hgbrasil")

var key = "11ad1a1f" //key gerada na www.hgbrasil.com
var symbol = "bidi4" //No plano pago é aceito passar mais de 1, ex: bidi4,petr4,qual3

brazuka.financeIbovespa(key, symbol).then(function (res) {
    console.log(res.results)
})

Exemplo de Resposta

{
    "by": "symbol",
    "valid_key": true,
    "results": {
        "BIDI4": {
            "symbol": "BIDI4",
            "name": "Banco Inter",
            "company_name": "Banco Inter S.A.",
            "document": "00.416.968/0001-01",
            "description": "Banco Múltiplo Com Carteira de Crédito. Financiamento. Investimento E Câmbio.",
            "website": "http://ri.bancointer.com.br/",
            "region": "Brazil/Sao Paulo",
            "currency": "BRL",
            "market_time": {
                "open": "10:00",
                "close": "17:30",
                "timezone": -3
            },
            "market_cap": 67679.7,
            "price": 26.21,
            "change_percent": 1.55,
            "updated_at": "2021-07-04 20:50:28"
        }
    },
    "execution_time": 0.0,
    "from_cache": true
}

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

Retorna a lista de títulos que estão em maiores altas ou baixas na BOVESPA.

Títulos disponíveis (symbols): veja a lista

Obtem as maiores altas

const brazuka = require("brazuka-hgbrasil")

var key = "11ad1a1f" //key gerada na www.hgbrasil.com
var symbol = "get-high" //Obtem as maiores altas

brazuka.financeIbovespa(key, symbol).then(function (res) {
    console.log(res.results)
})

Obtem as maiores Baixas

const brazuka = require("brazuka-hgbrasil")

var key = "11ad1a1f" //key gerada na www.hgbrasil.com
var symbol = "get-low" //Obtem as maiores baixas

brazuka.financeIbovespa(key, symbol).then(function (res) {
    console.log(res.results)
})

Exemplo de Resposta

{
    "by": "get_low_symbols",
    "valid_key": true,
    "results": {
        "OSXB3": {
            "symbol": "OSXB3",
            "name": "Osx Brasil",
            "company_name": "Osx Brasil S.A.",
            "document": "09.112.685/0001-32",
            "description": "Equipamentos E Serviços Para A Indústria Offshore de Petróleo E Gás Natural.",
            "website": "http://www.osx.com.br/",
            "region": "Brazil/Sao Paulo",
            "currency": "BRL",
            "market_time": {
                "open": "10:00",
                "close": "17:30",
                "timezone": -3
            },
            "market_cap": 34.63,
            "price": 11.0,
            "change_percent": -9.61,
            "updated_at": "2021-07-03 20:52:51"
        }
    },
    "execution_time": 0.04,
    "from_cache": false
}

Obtendo os dados de geolocalização via IP

address - Pode ser passado o IP de seu usuário exemplo 000.000.000.000 ou remote para o sistema obter o IP com base no cliente. Por padrão o valor é remote

const brazuka = require("brazuka-hgbrasil")

var key = "11ad1a1f" //key gerada na www.hgbrasil.com
var address = "remote" //Por padrão é remote

brazuka.geoIP(key, address).then(function (res) {
    console.log(res.results)
})

Exemplo de Resposta

{
    "by": "address_standard",
    "valid_key": true,
    "results": {
        "address": "54.86.50.139",
        "type": "ipv4",
        "city": "Ashburn",
        "region": "Virginia",
        "country_name": "United States",
        "continent": "América do Norte",
        "continent_code": "NA",
        "region_code": "VA",
        "country": {
            "name": "United States",
            "code": "US",
            "capital": null,
            "flag": {
                "svg": "https://assets.hgbrasil.com/geoip/flags/svg/us.svg",
                "png_16": "https://assets.hgbrasil.com/geoip/flags/16/us.png"
            },
            "calling_code": null
        },
        "latitude": 39.0481,
        "longitude": -77.4728,
        "woeid": null
    },
    "execution_time": 0.04,
    "from_cache": false
}

🚀 Contribuição

As contribuições tornam a comunidade de código aberto um lugar incrível para aprender, inspirar e criar. Qualquer contribuição que você fizer será muito bem-vinda.

brazuka-hgbrasil

Obtenha dados de Previsão do Tempo, Cotações de Moedas, IBOVESPA e Geolocalização

Avisos

Instalando

Importando

Previsão do Tempo (Weather)

Exemplo de Resposta

Cotação das Moedas (Dolar, Pesos Argentinos, Bitcoin entre outras)

Exemplo de Resposta

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

Exemplo de Resposta

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

Obtem as maiores altas

Obtem as maiores Baixas

Exemplo de Resposta

Obtendo os dados de geolocalização via IP

Exemplo de Resposta

🚀 Contribuição

✔️ License

Readme

Keywords

Package Sidebar

Install

Repository

Homepage

Weekly Downloads

Version

License

Unpacked Size

Total Files

Last publish

Collaborators

brazuka-hgbrasil

Obtenha dados de Previsão do Tempo, Cotações de Moedas, IBOVESPA e Geolocalização

Avisos

Instalando

Importando

Previsão do Tempo (Weather)

Exemplo de Resposta

Cotação das Moedas (Dolar, Pesos Argentinos, Bitcoin entre outras)

Exemplo de Resposta

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

Exemplo de Resposta

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

Obtem as maiores altas

Obtem as maiores Baixas

Exemplo de Resposta

Obtendo os dados de geolocalização via IP

Exemplo de Resposta

🚀 Contribuição

✔️ License

Readme

Keywords

Package Sidebar

Install

Repository

Homepage

DownloadsWeekly Downloads

Version

License

Unpacked Size

Total Files

Last publish

Collaborators

Weekly Downloads