Moedas

HG BrasilFinance
Dados das cotações de moedas.

Você pode consultar a cotação de diversas moedas internacionais em relação ao Real (BRL).

Requisição

GET
https://api.hgbrasil.com/finance?fields=currencies&key=suachave
curl -X GET "https://api.hgbrasil.com/finance?fields=currencies&key=suachave"

Resposta

No objeto currencies, a API retorna:

{
  "by": "default",
  "valid_key": true,
  "results": {
    "currencies": {
      "source": "BRL",
      "USD": {
        "name": "Dollar",
        "buy": 5.2558,
        "sell": 5.2656,
        "variation": -0.154
      },
      "EUR": {
        "name": "Euro",
        "buy": 6.1023,
        "sell": 6.1125,
        "variation": -0.106
      },
      "GBP": {
        "name": "Pound Sterling",
        "buy": 7.0396,
        "sell": null,
        "variation": 0.117
      },
      "ARS": {
        "name": "Argentine Peso",
        "buy": 0.0035,
        "sell": null,
        "variation": 0
      },
      "CAD": {
        "name": "Canadian Dollar",
        "buy": 3.868,
        "sell": null,
        "variation": 0.46
      },
      "AUD": {
        "name": "Australian Dollar",
        "buy": 3.6914,
        "sell": null,
        "variation": 0.079
      },
      "JPY": {
        "name": "Japanese Yen",
        "buy": 0.0332,
        "sell": null,
        "variation": -0.3
      },
      "CNY": {
        "name": "Renminbi",
        "buy": 0.7648,
        "sell": null,
        "variation": 0.131
      },
      "BTC": {
        "name": "Bitcoin",
        "buy": 381060.061,
        "sell": 381060.061,
        "variation": -4.333
      }
    }
  },
  "execution_time": 0,
  "from_cache": true
}

Campos

Os dados das moedas retornam dentro de results.currencies com os seguintes campos:

CampoTipoDescriçãoExemplo
sourcestringCódigo ISO da moeda base da cotação.BRL
[iso]objectCódigo ISO da moeda destino (USD, EUR, GBP, etc.).USD
[iso].namestringNome da moeda.Dollar
[iso].buynumberValor de compra.5.3138
[iso].sellnumberValor de venda (pode ser null para algumas moedas).5.3321
[iso].variationnumberVariação em percentual referente à última hora útil anterior.-0.339