Criptomoedas

HG BrasilFinance
Cotação do Bitcoin e das principais criptomoedas.

Obtenha as cotações das principais criptomoedas do mercado.

Ativos

Consulte as criptomoedas disponíveis e seus respectivos tickers para utilizar na consulta abaixo.

Ativos Disponíveis

Consulte os ativos disponíveis para uso na API. Use o campo abaixo para buscar por nome ou símbolo.

Requisição

O endpoint /v2/finance/quotes retorna cotações com payload enxuto e baixa latência, ideal para atualização frequente de valor.

GET
https://api.hgbrasil.com/v2/finance/quotes?tickers=CRYPTO:BTCBRL&key=suachave
curl -X GET "https://api.hgbrasil.com/v2/finance/quotes?tickers=CRYPTO%3ABTCBRL&key=suachave"

Parâmetros

tickers
string required
Ticker do ativo no formato {fonte}:{símbolo}. Para múltiplos ativos, separe por vírgula: CRYPTO:BTCBRL.
fields
string
Filtro de campos para reduzir o payload de retorno. Ex: ticker,quote.value,quote.change_percent.

Resposta

Nos results, a API retorna os dados da seguinte forma:

{
  "metadata": {
    "key_status": "valid",
    "cached": false,
    "response_time_ms": 283.7,
    "language": "pt-br"
  },
  "results": [
    {
      "ticker": "CRYPTO:BTCBRL",
      "kind": "crypto",
      "unit": "currency",
      "currency": "BRL",
      "symbol": "BTCBRL",
      "name": "Bitcoin em Real",
      "logos": {
        "square_small": "https://assets.hgbrasil.com/finance/companies/small/btcbrl.png",
        "square_large": "https://assets.hgbrasil.com/finance/companies/big/btcbrl.png"
      },
      "quote": {
        "value": 392936,
        "change_value": -1895.19,
        "change_percent": -0.48,
        "updated_at": "2026-05-08T11:40:57-03:00"
      },
      "market": {
        "is_open": true,
        "open_time": "2026-05-08T10:000-3:00",
        "close_time": "2026-05-08T17:300-3:00",
        "previous_value": 394833,
        "close": 392936,
        "volume": 0,
        "updated_at": "2026-05-08T11:40:57-03:00"
      },
      "dividends": {
        "yield_12m_percent": 0,
        "yield_12m_cash": 0
      },
      "source": {
        "symbol": "CRYPTO",
        "name": "CRYPTO",
        "full_name": "Cryptocurrency Market",
        "url": "",
        "location": {
          "timezone": "Etc/UTC"
        }
      },
      "related": []
    }
  ]
}

Campos

Consulte a documentação completa dos campos retornados em Ações.