Bolsa de Valores

Finance

Cotações dos principais indicadores do mercado financeiro, além de informações detalhadas sobre ações e FIIs negociados no IBOVESPA.

Ações

Você pode obter o preço de ações e FIIs listados no IBOVESPA utilizando um endpoint específico. Essa funcionalidade é ideal para acompanhar ativos negociados na bolsa brasileira.

Requisição

A API também permite que recuperar uma lista das ações que tiveram as maiores altas ou baixas, para isso informe o parâmetro symbol com as opções get-high ou get-low.

GEThttps://api.hgbrasil.com/finance/stock_price?symbol=get-high&key=suachave

Dividendos

Você pode obter os dividendos de Ações, Fundos Imobiliários e BDRs listados no IBOVESPA.

Requisição

Os dados são obtidos a partir do símbolo, através do parâmetro symbol.

symbol

string

É possível obter vários símbolos nas mesma consulta, desde que sejam separados por vírgula.

GEThttps://api.hgbrasil.com/finance/stock_dividends?symbol=alup4,alzr11,tgar11,visc11&key=suachave

Resposta

{
  "by": "default",
  "valid_key": true,
  "results": {
    "bitcoin": {
      "blockchain_info": {
        "name": "Blockchain.info",
        "format": [
          "USD",
          "en_US"
        ],
        "last": 102941.71,
        "buy": 102941.71,
        "sell": 102941.71,
        "variation": 1.207
      },
      "bitstamp": {
        "name": "BitStamp",
        "format": [
          "USD",
          "en_US"
        ],
        "last": 102862,
        "buy": 102860,
        "sell": 102859,
        "variation": 1.138
      },
      "foxbit": {
        "name": "FoxBit",
        "format": [
          "BRL",
          "pt_BR"
        ],
        "last": 543556,
        "variation": 0.817
      },
      "mercadobitcoin": {
        "name": "Mercado Bitcoin",
        "format": [
          "BRL",
          "pt_BR"
        ],
        "last": 543358,
        "buy": 543360,
        "sell": 543740,
        "variation": 0.791
      }
    }
  },
  "execution_time": 0,
  "from_cache": true
}

Campos

Os dados dos dividendos retornam no results com os seguintes campos:

kind

string

Tipo do título.

cash para pagamento em dinheiro.
sotck para pagamento em cotas.

currency

string

Moeda.

isin_code

string

Padronização internacional na codificação de títulos financeiros.

label

string

Referência.

amount

number

Valor.

approved_in

string

Aprovado em.

traded_until

string

Para negócios até.

payment_date

string

Data do pagamento (pode ser uma data futura).

Ibovespa

Para análises mais refinadas, você pode obter dados diários detalhados do IBOVESPA, com informações de preços de abertura, fechamento, máxima, mínima e média.

Requisição

Por padrão, a API retorna os dados do pregão atual (se estiver acontecendo no momento), ou do último pregão.

GEThttps://api.hgbrasil.com/finance/ibovespa?key=suachave

Resposta

{
  "by": "last_business_day",
  "valid_key": true,
  "results": [],
  "execution_time": 0.01,
  "from_cache": false
}