Entrar

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.4193,
        "sell": 5.4324,
        "variation": -0.267
      },
      "EUR": {
        "name": "Euro",
        "buy": 6.3059,
        "sell": 6.3211,
        "variation": -0.275
      },
      "GBP": {
        "name": "Pound Sterling",
        "buy": 7.2179,
        "sell": null,
        "variation": -0.291
      },
      "ARS": {
        "name": "Argentine Peso",
        "buy": 0.0035,
        "sell": null,
        "variation": 0
      },
      "CAD": {
        "name": "Canadian Dollar",
        "buy": 3.9109,
        "sell": null,
        "variation": -0.258
      },
      "AUD": {
        "name": "Australian Dollar",
        "buy": 3.5876,
        "sell": null,
        "variation": -0.264
      },
      "JPY": {
        "name": "Japanese Yen",
        "buy": 0.0346,
        "sell": null,
        "variation": -0.288
      },
      "CNY": {
        "name": "Renminbi",
        "buy": 0.7663,
        "sell": null,
        "variation": -0.26
      },
      "BTC": {
        "name": "Bitcoin",
        "buy": 518933.196,
        "sell": 518933.196,
        "variation": -0.619
      }
    }
  },
  "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