Moedas
Finance
Dados das cotações de moedas.
Você pode consultar a cotação de diversas moedas internacionais em relação ao Real (BRL).
Requisição
GEThttps://api.hgbrasil.com/finance?fields=currencies&key=suachave
curl -X GET "https://api.hgbrasil.com/finance?fields=currencies&key=suachave"
const url = new URL("/finance", "https://api.hgbrasil.com")
url.searchParams.set("fields", "currencies")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/finance';
$queryString = http_build_query([
'fields' => 'currencies',
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/finance'
params = {
'fields': 'currencies',
'key': 'suachave'
}
response = requests.get(url, params=params)
data = response.json()
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.hgbrasil.com/finance')
uri.query = URI.encode_www_form({
fields: 'currencies',
key: 'suachave'
})
response = Net::HTTP.get(uri)
data = JSON.parse(response, symbolize_names: true)
import java.net.URI;
import java.net.http.*;
var url = "https://api.hgbrasil.com/finance?fields=currencies&key=suachave";
var client = HttpClient.newHttpClient();
var request = HttpRequest.newBuilder()
.uri(URI.create(url))
.GET()
.build();
var response = client.send(request, HttpResponse.BodyHandlers.ofString());
var data = response.body();
using System.Net.Http;
using System.Text.Json;
using System.Web;
var client = new HttpClient();
var baseUrl = "https://api.hgbrasil.com/finance";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["fields"] = "currencies";
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
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:
| Campo | Tipo | Descrição | Exemplo |
|---|---|---|---|
source | string | Código ISO da moeda base da cotação. | BRL |
[iso] | object | Código ISO da moeda destino (USD, EUR, GBP, etc.). | USD |
[iso].name | string | Nome da moeda. | Dollar |
[iso].buy | number | Valor de compra. | 5.3138 |
[iso].sell | number | Valor de venda (pode ser null para algumas moedas). | 5.3321 |
[iso].variation | number | Variação em percentual referente à última hora útil anterior. | -0.339 |