Moedas

Finance

Cotações de moedas internacionais em relação ao Real (BRL) e outros pares globais.

Você pode consultar a cotação de diversas moedas internacionais em relação ao Real (BRL), além de outros pares globais.

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.

Libras Esterlinas em Real

GBPBRL

R$ 6,76

1,03%

Peso Argentino em Real

ARSBRL

R$ 0,00

3,03%

Dólar Canadense em Real

CADBRL

R$ 3,69

1,40%

Dólar Australiano em Real

Requisição

Para consultar um ou mais pares, informe os tickers no formato {fonte}:{símbolo} separados por vírgula. Por exemplo, para consultar Dólar e Euro contra o Real:

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

Lista de pares no formato {fonte}:{símbolo} separados por vírgula. Ex.: FOREX:USDBRL,FOREX:EURBRL.

sort

string

Ordena os resultados com base em um campo de retorno. Aceita: value:asc, value:desc, volume:asc, volume:desc, change_percent:asc, change_percent:desc.

fields

string

Filtro de campos para reduzir o payload de retorno. Ex.: ticker,quote.value,quote.change_percent. Em breve.

Resposta

Nos results, a API retorna os dados da seguinte forma:

{
  "metadata": {
    "key_status": "valid",
    "cached": true,
    "response_time_ms": 0,
    "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": 5.0693,
        "change_value": 0.08,
        "change_percent": 1.5994,
        "updated_at": "2026-05-15T19:59:00-03:00"
      },
      "market": {
        "is_open": false,
        "open_time": "2026-05-17T10:000-3:00",
        "close_time": "2026-05-17T17:300-3:00",
        "previous_value": 4.9895,
        "open": 4.98,
        "close": 5.0693,
        "high": 5.08,
        "low": 4.98,
        "volume": 0,
        "updated_at": "2026-05-15T19:59:00-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.8938,
        "change_value": 0.07,
        "change_percent": 1.2193,
        "updated_at": "2026-05-15T19:59:00-03:00"
      },
      "market": {
        "is_open": false,
        "open_time": "2026-05-17T10:000-3:00",
        "close_time": "2026-05-17T17:300-3:00",
        "previous_value": 5.8228,
        "open": 5.81,
        "close": 5.8938,
        "high": 5.9,
        "low": 5.8,
        "volume": 0,
        "updated_at": "2026-05-15T19:59:00-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

Os dados do ativo retornam dentro da lista results com os seguintes campos:

Ativo

Campo	Descrição
`ticker`	Identificador completo no formato `{source}:{symbol}`
`kind`	Tipo do ativo: `stock`, `bdr`, `etf`, `fund`, `index`, `crypto`, `forex`
`unit`	Unidade dos valores (`currency`, `points` etc.)
`currency`	Moeda principal
`symbol`	Código de negociação
`name`	Nome simplificado
`full_name`	Nome completo ou razão social
`tax_id`	Documento fiscal do emissor (ex.: CNPJ)
`isin`	Código ISIN do ativo
`shares_outstanding`	Quantidade de ações em circulação
`classification.sector`	Setor de atuação
`classification.subsector`	Subsetor de atuação
`classification.segment`	Segmento de atuação
`logos.square_small`	URL do logotipo quadrado em tamanho pequeno
`logos.square_large`	URL do logotipo quadrado em tamanho grande
`related`	Lista de tickers relacionados no formato `{source}:{symbol}`

Quote

Campo	Descrição
`quote.value`	Último valor negociado (moeda, pontos etc.)
`quote.change_value`	Variação absoluta no dia
`quote.change_percent`	Variação percentual no dia
`quote.market_cap`	Valor de mercado com base na cotação atual
`quote.updated_at`	Timestamp da cotação (ISO 8601)

Market

Campo	Descrição
`market.is_open`	Indica se o mercado está aberto
`market.open_time`	Horário de abertura do mercado (ISO 8601)
`market.close_time`	Horário de fechamento do mercado (ISO 8601)
`market.previous_value`	Valor de referência anterior (ex.: fechamento anterior)
`market.open`	Valor de abertura do dia
`market.high`	Máxima do dia
`market.low`	Mínima do dia
`market.close`	Valor de fechamento do dia
`market.volume`	Volume negociado
`market.updated_at`	Timestamp da sessão (ISO 8601)

Dividends

Campo	Descrição
`dividends.yield_12m_percent`	Dividend yield dos últimos 12 meses em percentual
`dividends.yield_12m_cash`	Dividend yield dos últimos 12 meses em valor absoluto (moeda)

Fonte

Campo	Descrição
`source.symbol`	Código da fonte
`source.name`	Nome da fonte
`source.full_name`	Nome completo da fonte
`source.url`	Site oficial
`source.location.timezone`	Fuso horário

Cotações Históricas

Acesse o histórico de cotações de ações, fundos imobiliários, BDRs, ETFs e outros ativos negociados na B3 (Ibovespa).

Criptomoedas

Cotações do Bitcoin, Ethereum e das principais criptomoedas do mercado.