Criptomoedas
Finance
Cotação do Bitcoin e das principais criptomoedas.
Obtenha as cotações das principais criptomoedas do mercado.
Ativos
Consulte as criptomoedas 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=CRYPTO:BTCBRL&key=suachave
curl -X GET "https://api.hgbrasil.com/v2/finance/quotes?tickers=CRYPTO%3ABTCBRL&key=suachave"
const url = new URL("/v2/finance/quotes", "https://api.hgbrasil.com")
url.searchParams.set("tickers", "CRYPTO:BTCBRL")
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' => 'CRYPTO:BTCBRL',
'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': 'CRYPTO:BTCBRL',
'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: 'CRYPTO:BTCBRL',
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=CRYPTO%3ABTCBRL&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"] = "CRYPTO:BTCBRL";
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: CRYPTO:BTCBRL.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": 283.7,
"language": "pt-br"
},
"results": [
{
"ticker": "CRYPTO:BTCBRL",
"kind": "crypto",
"unit": "currency",
"currency": "BRL",
"symbol": "BTCBRL",
"name": "Bitcoin em Real",
"logos": {
"square_small": "https://assets.hgbrasil.com/finance/companies/small/btcbrl.png",
"square_large": "https://assets.hgbrasil.com/finance/companies/big/btcbrl.png"
},
"quote": {
"value": 392936,
"change_value": -1895.19,
"change_percent": -0.48,
"updated_at": "2026-05-08T11:40:57-03:00"
},
"market": {
"is_open": true,
"open_time": "2026-05-08T10:000-3:00",
"close_time": "2026-05-08T17:300-3:00",
"previous_value": 394833,
"close": 392936,
"volume": 0,
"updated_at": "2026-05-08T11:40:57-03:00"
},
"dividends": {
"yield_12m_percent": 0,
"yield_12m_cash": 0
},
"source": {
"symbol": "CRYPTO",
"name": "CRYPTO",
"full_name": "Cryptocurrency Market",
"url": "",
"location": {
"timezone": "Etc/UTC"
}
},
"related": []
}
]
}
Campos
Consulte a documentação completa dos campos retornados em Ações.