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.1893,
        "sell": 5.1911,
        "variation": -0.409
      },
      "EUR": {
        "name": "Euro",
        "buy": 6.1115,
        "sell": 6.1125,
        "variation": -0.375
      },
      "GBP": {
        "name": "Pound Sterling",
        "buy": 6.9992,
        "sell": null,
        "variation": -0.242
      },
      "ARS": {
        "name": "Argentine Peso",
        "buy": 0.0035,
        "sell": null,
        "variation": 0
      },
      "CAD": {
        "name": "Canadian Dollar",
        "buy": 3.7914,
        "sell": null,
        "variation": -0.376
      },
      "AUD": {
        "name": "Australian Dollar",
        "buy": 3.668,
        "sell": null,
        "variation": -0.245
      },
      "JPY": {
        "name": "Japanese Yen",
        "buy": 0.0333,
        "sell": null,
        "variation": -0.597
      },
      "CNY": {
        "name": "Renminbi",
        "buy": 0.7512,
        "sell": null,
        "variation": -0.687
      },
      "BTC": {
        "name": "Bitcoin",
        "buy": 369949.009,
        "sell": 369949.009,
        "variation": 0.377
      }
    }
  },
  "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