API de preço da platina: cotações XPT e XPD ao vivo e históricas

Preços da platina e do paládio via API

Uma API de preço da platina entrega o preço atual e o histórico da platina como dados estruturados, geralmente JSON via HTTPS, para que a ferramenta de cotação de um reciclador, a tabela de preços de um joalheiro ou o acompanhamento de carteira de um investidor possa usá-los sem copiar números de um site. O paládio, o parente mais próximo da platina, geralmente vem junto. A MetalAPI cota os dois pelos mesmos endpoints e com o mesmo formato de resposta do ouro e da prata.

A platina e o paládio pertencem aos seis metais do grupo da platina (PGMs, na sigla em inglês), junto com o ródio, o rutênio, o irídio e o ósmio. A MetalAPI cobre a platina e o paládio; os outros quatro não estão na sua lista de símbolos.

XPT e XPD são os códigos ISO 4217 para uma onça troy de cada metal, da mesma família que XAU para o ouro. O preço ao vivo é o preço à vista (spot): o ponto médio entre as cotações interbancárias de compra (bid) e de venda (ask). Todos os planos incluem os dois símbolos, inclusive o Free.

Preço da platina por onça via API

Assim como o ouro e a prata, a platina e o paládio são cotados por onça troy (31,1034768 g) no mercado de atacado, e essa é a unidade padrão da API. Solicite os dois metais em /latest, mais o ouro se quiser comparar. Uma requisição custa o mesmo, não importa quantos símbolos ela retorne:

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPD,XAU" \
  -H "X-API-Key: $METALAPI_KEY"

Cada metal aparece duas vezes. USDXPT é o preço de uma onça troy de platina em dólares americanos, o número a exibir; XPT é o seu inverso, onças troy por dólar, mantido por compatibilidade com APIs no estilo forex. Estes são os valores de exemplo da documentação, não preços ao vivo:

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "rates": {
    "XPT": 0.000620212733,
    "USDXPT": 1612.35,
    "XPD": 0.0006775985906,
    "USDXPD": 1475.8,
    "XAU": 0.0002501319446,
    "USDXAU": 3997.89
  }
}

Para outra moeda, defina base: base=EUR retorna EURXPT e EURXPD. Com a taxa de exemplo da documentação, de 1,1642 USD por euro, a platina fica em 1.384,94 EUR e o paládio em 1.267,65 EUR por onça troy. Todas as 57 moedas aceitas funcionam, e o preço do metal e a taxa de câmbio sempre vêm do mesmo snapshot.

Preço da platina e do paládio por grama

Joalheiros e recicladores costumam trabalhar em gramas, compradores industriais muitas vezes em quilos. unit faz a conversão no servidor e aceita gram, kilogram, ounce, pound, metric_ton e short_ton, além do padrão troy_oz:

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPD&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

{
  "success": true,
  "timestamp": 1792713600,
  "date": "2026-10-23",
  "base": "USD",
  "unit": "gram",
  "rates": {
    "XPT": 0.01929077235,
    "USDXPT": 51.83825623,
    "XPD": 0.02107567204,
    "USDXPD": 47.44807179
  }
}

Isso dá 51,84 USD por grama de platina e 47,45 USD por grama de paládio, ou 51.838,26 e 47.448,07 USD por quilo. unit vale para todos os metais da requisição, e ounce significa a onça avoirdupois de 28,35 gramas, então omita unit, ou passe troy_oz, para a onça usada no mercado de metais preciosos.

Preços de compra e venda (bid e ask) da platina e do paládio

A partir do plano Standard, adicione os símbolos -BID e -ASK a currencies para receber os dois lados da cotação ao lado do preço médio, em chaves como USDXPT-BID e USDXPT-ASK:

curl "https://metalapi.com/api/v1/latest?currencies=XPT,XPT-BID,XPT-ASK,XPD,XPD-BID,XPD-ASK" \
  -H "X-API-Key: $METALAPI_KEY"

A platina e o paládio são negociados em volumes muito menores que o ouro, então seus spreads costumam ser maiores em termos percentuais. Se você cota preços de compra e venda, baseie-os no bid e no ask reais, e não no preço médio mais uma margem fixa. Bid e ask fazem parte apenas da cotação mais recente; os endpoints históricos retornam preços médios. Spot, bid, ask e spread explica como os revendedores montam cotações a partir deles.

Preços históricos da platina e do paládio

O histórico diário dos dois metais vai até 2000, e todos os planos podem consultá-lo inteiro. Quatro endpoints cobrem o trabalho com histórico:

• /historical, ou a data no caminho, para os preços de fechamento de um dia.
• /timeframe para fechamentos diários em um período: até 30 dias por requisição no Free e 365 dias nos planos pagos.
• /change para o preço inicial, o preço final e a variação absoluta e percentual entre duas datas.
• /ohlc para a abertura, a máxima, a mínima e o fechamento de um dia.

Para orçamentos e contratos de fornecimento, uma média costuma ser mais útil que um único dia. Nos planos pagos, uma requisição a /timeframe retorna até 365 fechamentos diários, o suficiente para uma média mensal ou trimestral em uma só chamada.

# Preços de fechamento de um dia, por grama
curl "https://metalapi.com/api/v1/2024-01-15?currencies=XPT,XPD&unit=gram" \
  -H "X-API-Key: $METALAPI_KEY"

# Variação desde o início do ano (um período de mais de 30 dias exige um plano pago)
curl "https://metalapi.com/api/v1/change?currencies=XPT,XPD&start_date=2026-01-02&end_date=2026-10-23" \
  -H "X-API-Key: $METALAPI_KEY"

Fins de semana e feriados do mercado não têm preço de fechamento e podem faltar em uma série, então não presuma uma entrada por dia do calendário. Para históricos mais longos, percorra o período ano a ano. Os preços dos metais anteriores a outubro de 2026 são derivados de contratos futuros de primeiro vencimento, então podem diferir ligeiramente do preço spot do mesmo dia. O guia de dados históricos cobre em detalhes períodos, barras OHLC e paginação.

Comparando platina e paládio com o ouro

As relações de preço são a forma mais simples de comparar os metais: divida um preço por onça por outro. Quando os dois preços vêm da mesma resposta, a relação é a mesma em qualquer moeda e unidade. Com os preços de exemplo da documentação:

A esses preços, uma onça de ouro compra cerca de 2,48 onças de platina, e a platina custa cerca de 40% do ouro por onça. Essas relações não são estáveis: ao longo do histórico disponível na API, a ordem dos três metais mudou mais de uma vez. Não fixe no código suposições como "a platina é mais barata que o ouro" na lógica de preços; busque a série e confira. As relações também são uma verificação barata dos dados: uma relação muito fora da sua faixa recente geralmente indica dois preços em unidades ou moedas diferentes, e não um evento de mercado.

Este script busca 30 dias de fechamentos diários, o que cabe no limite de período do plano Free, e imprime as três relações para cada dia de negociação:

const url = new URL("https://metalapi.com/api/v1/timeframe");
url.search = new URLSearchParams({
  currencies: "XAU,XPT,XPD",
  start_date: "2026-09-24",
  end_date: "2026-10-23", // 30 dias: dentro do limite de período do plano Free
});

const res = await fetch(url, { headers: { "X-API-Key": process.env.METALAPI_KEY } });
const data = await res.json();
if (!data.success) throw new Error(`${data.error.code}: ${data.error.info}`);

const ratio = (a, b) => (a / b).toFixed(3);
for (const [date, r] of Object.entries(data.rates)) {
  if (!r.USDXAU || !r.USDXPT || !r.USDXPD) continue; // pula dias incompletos
  console.log(date, "Au/Pt", ratio(r.USDXAU, r.USDXPT), "Au/Pd", ratio(r.USDXAU, r.USDXPD), "Pt/Pd", ratio(r.USDXPT, r.USDXPD));
}
// Com os preços de exemplo: Au/Pt 2.480, Au/Pd 2.709, Pt/Pd 1.093

Rode o mesmo cálculo sobre vários anos de dados de /timeframe e você terá um gráfico das relações. A relação ouro/prata aplica a mesma ideia à prata.

Quem usa uma API de preços de platina e paládio

Recicladores de catalisadores automotivos. Os catalisadores de escapamento de veículos são um dos principais usos da platina e do paládio, e os catalisadores usados são uma fonte importante de PGMs reciclados. O valor de um catalisador depende de quanta platina, paládio e ródio o seu substrato contém, o que varia por modelo, então os recicladores dependem de análises laboratoriais e pagam uma parte do valor do metal depois dos custos de refino e processamento. Uma API de preços fornece o lado do metal nesse cálculo. A MetalAPI não cota o ródio, então obtenha-o de outra fonte se o seu modelo precisar dele:

import os
from decimal import Decimal

import requests

# Teor de PGMs de um lote segundo a análise, em gramas, e a parte do valor do metal que você paga.
# Valores de exemplo: use os resultados das suas análises e os termos do seu contrato de refino.
LOT_GRAMS = {"XPT": Decimal("120"), "XPD": Decimal("310")}
PAYABLE = Decimal("0.80")

resp = requests.get(
    "https://metalapi.com/api/v1/latest",
    params={"currencies": ",".join(LOT_GRAMS), "unit": "gram", "base": "EUR"},
    headers={"X-API-Key": os.environ["METALAPI_KEY"]},
    timeout=10,
)
data = resp.json(parse_float=Decimal)
if not data["success"]:
    raise RuntimeError(data["error"])

total = Decimal("0")
for symbol, grams in LOT_GRAMS.items():
    price = data["rates"]["EUR" + symbol]  # EUR por grama
    value = grams * price * PAYABLE
    total += value
    print(f"{symbol}: {grams} g x {price:.4f} EUR/g x {PAYABLE} = {value:.2f} EUR")

print(f"Payable Pt + Pd: {total:.2f} EUR at prices of {data['date']} (rhodium priced separately)")

Com os preços e a taxa do euro de exemplo da documentação, o lote fictício chega a 14.382,06 EUR. As quantidades e a parte paga são ilustrações; as suas vêm das análises e do seu contrato de refino.

Joalheiros. As joias de platina costumam ser feitas com alto teor, como 950 partes por mil, e o paládio é usado tanto em joias próprias quanto como metal de liga no ouro branco. O endpoint /carat é só para o ouro, então precifique a platina pelo teor você mesmo: valor do metal por grama = preço por grama × teor ÷ 1.000. Ao preço de exemplo, a platina 950 vale 49,25 USD por grama em metal, antes dos custos de fabricação e dos impostos.

Compradores industriais. Além dos catalisadores automotivos, a platina e o paládio são usados em catalisadores químicos e de refino, na produção de vidro, em eletrônicos, ligas odontológicas e células de combustível. Equipes de compras usam /change para as variações de um período e médias de /timeframe para orçamentos e verificação de contratos. Os alertas de preço, disponíveis nos planos pagos para qualquer símbolo, inclusive XPT e XPD, avisam quando um preço cruza um nível; a entrega por webhook começa no plano Advanced.

Investidores. Moedas, barras e produtos negociados em bolsa de platina e paládio são avaliados a partir do mesmo preço spot. /convert?from=XPT&to=EUR&amount=10 avalia dez onças troy em uma chamada, base coloca a carteira na moeda do seu dono e, a partir do plano Pro, o stream em tempo real envia as atualizações sem que você precise fazer polling.

Dicas práticas

• Agrupe os metais. currencies=XAU,XAG,XPT,XPD custa uma requisição; quatro chamadas separadas custam quatro.
• Faça polling no intervalo do seu plano. O Free atualiza diariamente, o Lite a cada 30 minutos, o Standard a cada 10 minutos, o Advanced e o Pro a cada 60 segundos, o Ultra e o Business a cada 15 segundos e o Enterprise a cada 5 segundos. Requisições feitas entre uma atualização e outra retornam o mesmo snapshot e continuam contando.
• Respeite o horário do mercado. Os metais preciosos à vista fecham na sexta-feira às 17:00, horário de Nova York, e reabrem no domingo às 17:00. No fim de semana, a API continua retornando o último preço.
• Guarde o contexto de cada preço: símbolo, unidade, moeda base e timestamp. Um número sem a sua unidade não pode ser reutilizado com segurança.
• Verifique se as chaves existem. Se um lado bid ou ask não estiver disponível, ele fica de fora de rates em vez de vir como zero.
• Sem código para um painel de preços público. Um widget incorporável exibe preços ao vivo de platina e paládio em um site sem expor a sua chave de API, e o plano Free inclui um.

Comece a usar os preços da platina e do paládio

Cadastre-se para obter uma chave gratuita e solicite currencies=XPT,XPD para ver os dois metais em poucos minutos. O plano Free inclui 100 requisições por mês com atualização diária e o histórico completo. Quando você precisar de preços mais recentes, bid e ask, alertas ou streaming, a página de preços mostra o que cada plano inclui, e a página de símbolos lista os preços ao vivo de todos os metais, moedas e criptomoedas que a API cobre.

Perguntas frequentes

Quais são os símbolos da platina e do paládio?

XPT para a platina e XPD para o paládio, os códigos ISO 4217 para uma onça troy de cada metal. Nas respostas, USDXPT e USDXPD trazem os preços em dólares americanos por onça troy.

Posso obter o preço da platina por grama?

Sim. Adicione unit=gram a /latest ou a qualquer endpoint histórico. Ao preço de exemplo de 1.612,35 USD por onça troy, isso dá 51,84 USD por grama. kilogram e as outras unidades funcionam da mesma forma.

Até quando vão os dados históricos da platina e do paládio?

Os preços de fechamento diários vão até 2000 em todos os planos. Uma única requisição a /timeframe cobre até 30 dias no Free e 365 dias nos planos pagos, então percorra períodos mais longos em várias requisições.

A MetalAPI fornece preços do ródio?

Não. Entre os metais do grupo da platina, a MetalAPI cota apenas a platina e o paládio. O endpoint /api/v1/symbols retorna a lista atual de símbolos e não conta para a sua cota.

A platina está incluída no plano Free?

Sim. Todos os planos incluem todos os símbolos e o histórico completo. Os planos pagos acrescentam atualizações mais frequentes, períodos mais longos por requisição e preços do ouro por quilate e, a partir do Standard, preços de compra e venda (bid e ask).