Moedas
Finance
Dados das cotações de moedas.
Você pode consultar a cotação de diversas moedas internacionais em relação ao Real (BRL).
Ativos
Consulte as moedas disponíveis e seus respectivos tickers para utilizar na consulta abaixo.
Ativos Disponíveis
Consulte os ativos disponíveis para uso na API. Use o campo abaixo para buscar por nome ou símbolo.
Requisição
O endpoint /v2/finance/quotes retorna cotações com payload enxuto e baixa latência, ideal para atualização frequente de valor.
GEThttps://api.hgbrasil.com/v2/finance/quotes?tickers=FOREX:USDBRL,FOREX:EURBRL&key=suachave
curl -X GET "https://api.hgbrasil.com/v2/finance/quotes?tickers=FOREX%3AUSDBRL%2CFOREX%3AEURBRL&key=suachave"
const url = new URL("/v2/finance/quotes", "https://api.hgbrasil.com")
url.searchParams.set("tickers", "FOREX:USDBRL,FOREX:EURBRL")
url.searchParams.set("key", "suachave")
const response = await fetch(url.href)
const data = await response.json()
$url = 'https://api.hgbrasil.com/v2/finance/quotes';
$queryString = http_build_query([
'tickers' => 'FOREX:USDBRL,FOREX:EURBRL',
'key' => 'suachave'
]);
$response = file_get_contents($url . '?' . $queryString);
$data = json_decode($response, true);
import requests
url = 'https://api.hgbrasil.com/v2/finance/quotes'
params = {
'tickers': 'FOREX:USDBRL,FOREX:EURBRL',
'key': 'suachave'
}
response = requests.get(url, params=params)
data = response.json()
require 'net/http'
require 'uri'
require 'json'
uri = URI('https://api.hgbrasil.com/v2/finance/quotes')
uri.query = URI.encode_www_form({
tickers: 'FOREX:USDBRL,FOREX:EURBRL',
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/v2/finance/quotes?tickers=FOREX%3AUSDBRL%2CFOREX%3AEURBRL&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/v2/finance/quotes";
var queryParams = HttpUtility.ParseQueryString(string.Empty);
queryParams["tickers"] = "FOREX:USDBRL,FOREX:EURBRL";
queryParams["key"] = "suachave";
var url = $"{baseUrl}?{queryParams}";
var response = await client.GetStringAsync(url);
var data = JsonSerializer.Deserialize<dynamic>(response);
Parâmetros
tickers
string required
Ticker do ativo no formato
{fonte}:{símbolo}. Para múltiplos ativos, separe por vírgula: FOREX:USDBRL,FOREX:EURBRL.fields
string
Filtro de campos para reduzir o payload de retorno. Ex:
ticker,quote.value,quote.change_percent.Resposta
Nos results, a API retorna os dados da seguinte forma:
{
"metadata": {
"key_status": "valid",
"cached": false,
"response_time_ms": 49.6,
"language": "pt-br"
},
"results": [
{
"ticker": "FOREX:USDBRL",
"kind": "currency",
"unit": "currency",
"currency": "BRL",
"symbol": "USDBRL",
"name": "Dólar em Real",
"logos": {
"square_small": "https://assets.hgbrasil.com/finance/companies/small/usdbrl.png",
"square_large": "https://assets.hgbrasil.com/finance/companies/big/usdbrl.png"
},
"quote": {
"value": 4.8961,
"change_value": -0.03,
"change_percent": -0.5323,
"updated_at": "2026-05-08T11:33:25-03:00"
},
"market": {
"is_open": true,
"open_time": "2026-05-08T10:000-3:00",
"close_time": "2026-05-08T17:300-3:00",
"previous_value": 4.9223,
"open": 4.93,
"close": 4.8961,
"high": 4.93,
"low": 4.89,
"volume": 0,
"updated_at": "2026-05-08T11:33:25-03:00"
},
"dividends": {
"yield_12m_percent": 0,
"yield_12m_cash": 0
},
"source": {
"symbol": "FOREX",
"name": "FOREX",
"full_name": "Foreign Exchange Market",
"url": "",
"location": {
"timezone": "Etc/UTC"
}
},
"related": [
"FOREX:ARSBRL",
"FOREX:AUDBRL",
"FOREX:CADBRL",
"FOREX:CNYBRL",
"FOREX:EURBRL"
]
},
{
"ticker": "FOREX:EURBRL",
"kind": "currency",
"unit": "currency",
"currency": "BRL",
"symbol": "EURBRL",
"name": "Euro em Real",
"logos": {
"square_small": "https://assets.hgbrasil.com/finance/companies/small/eurbrl.png",
"square_large": "https://assets.hgbrasil.com/finance/companies/big/eurbrl.png"
},
"quote": {
"value": 5.7634,
"change_value": -0.01,
"change_percent": -0.1594,
"updated_at": "2026-05-08T11:30:15-03:00"
},
"market": {
"is_open": true,
"open_time": "2026-05-08T10:000-3:00",
"close_time": "2026-05-08T17:300-3:00",
"previous_value": 5.7726,
"open": 5.78,
"close": 5.7634,
"high": 5.8,
"low": 5.76,
"volume": 0,
"updated_at": "2026-05-08T11:30:15-03:00"
},
"dividends": {
"yield_12m_percent": 0,
"yield_12m_cash": 0
},
"source": {
"symbol": "FOREX",
"name": "FOREX",
"full_name": "Foreign Exchange Market",
"url": "",
"location": {
"timezone": "Etc/UTC"
}
},
"related": [
"FOREX:ARSBRL",
"FOREX:AUDBRL",
"FOREX:CADBRL",
"FOREX:CNYBRL",
"FOREX:GBPBRL"
]
}
]
}
Campos
Consulte a documentação completa dos campos retornados em Ações.