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.5203,
        "sell": 5.5208,
        "variation": -1.305
      },
      "EUR": {
        "name": "Euro",
        "buy": 6.5117,
        "sell": 6.5147,
        "variation": -0.907
      },
      "GBP": {
        "name": "Pound Sterling",
        "buy": 7.4631,
        "sell": null,
        "variation": -0.775
      },
      "ARS": {
        "name": "Argentine Peso",
        "buy": 0.0036,
        "sell": null,
        "variation": 0
      },
      "CAD": {
        "name": "Canadian Dollar",
        "buy": 4.0317,
        "sell": null,
        "variation": -0.8
      },
      "AUD": {
        "name": "Australian Dollar",
        "buy": 3.6979,
        "sell": null,
        "variation": -0.559
      },
      "JPY": {
        "name": "Japanese Yen",
        "buy": 0.0352,
        "sell": null,
        "variation": -0.845
      },
      "CNY": {
        "name": "Renminbi",
        "buy": 0.7854,
        "sell": null,
        "variation": -1.108
      },
      "BTC": {
        "name": "Bitcoin",
        "buy": 512705.443,
        "sell": 512705.443,
        "variation": -0.876
      }
    }
  },
  "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