Como escolher uma API de preços de metais preciosos: 12 perguntas a fazer

Por que um checklist ajuda

A maioria das APIs de preços de metais preciosos parece igual nas páginas iniciais: ouro e prata em tempo real, muitas moedas, respostas em JSON e um plano gratuito. As diferenças que importam aparecem depois, quando um painel mostra um preço desatualizado no fim de semana, um cliente pergunta por que o seu preço por grama é diferente do de uma loja, a cota mensal acaba no dia 20 ou o seu jurídico pergunta se vocês podem mesmo mostrar os dados aos clientes.

Este checklist reúne doze perguntas que vale a pena responder antes de se comprometer. Elas se aplicam a qualquer fornecedor e servem tanto para um projeto de fim de semana quanto para um processo formal de compras. Mais abaixo, você encontra um modelo de comparação para copiar e uma lista curta de testes práticos. Como este artigo é publicado pela MetalAPI, a última seção traz as nossas próprias respostas; tudo o que vem antes foi pensado para ser útil qualquer que seja o fornecedor escolhido.

Dados: fontes, atualidade e histórico

1. De onde vêm os preços? Os preços dos metais preciosos podem vir de vários tipos de fonte: cotações de bancos e provedores de liquidez no mercado à vista de balcão (OTC), contratos futuros negociados em bolsa, como o ouro da COMEX, benchmarks oficiais, como os preços dos leilões da LBMA, ou outro agregador. Nenhuma delas está errada, mas são números diferentes. Pergunte qual fonte alimenta cada símbolo, se várias fontes são combinadas e de que forma, e como os ticks claramente errados são filtrados. Se um fornecedor não consegue dizer o que o seu preço do ouro representa (preço médio à vista, futuro ou benchmark), você também não vai conseguir explicá-lo aos seus usuários.

2. Quão recentes são os dados no plano que você realmente vai pagar? “Tempo real” na página inicial muitas vezes descreve o plano mais alto. Verifique o intervalo de atualização de cada plano e confira se toda resposta traz o timestamp dos próprios dados, e não apenas da sua requisição. Pergunte o que acontece fora do horário de mercado: os metais à vista param de ser negociados da noite de sexta-feira à noite de domingo, no horário de Nova York, e uma boa API deixa claro que o preço do fim de semana é o fechamento de sexta-feira.

3. Qual é a profundidade do histórico, e do que ele é feito? Verifique a data inicial de cada classe de ativos, se você recebe apenas fechamentos diários ou abertura, máxima, mínima e fechamento, e como o “fechamento” é definido (qual fuso horário, qual fonte). Pergunte se o histórico mais antigo vem de uma fonte diferente da dos preços atuais, como liquidações de contratos futuros antes de determinada data, porque isso pode criar pequenas descontinuidades em um gráfico longo. Por fim, verifique quantos dias uma única requisição de intervalo pode abranger.

Adequação: unidades, moedas e bid/ask

4. Quais unidades e moedas são suportadas? Os metais preciosos são negociados por onça troy, mas os seus usuários podem pensar em gramas ou quilogramas, e na própria moeda. Um parâmetro de unidade poupa você de fazer todas as conversões; verifique como a API nomeia as unidades, porque a onça troy (31,103 g) e a onça avoirdupois (28,35 g) diferem em quase 10%. Se você precisa de taxas cruzadas, como ouro em liras turcas ou prata em ienes, verifique se elas são calculadas a partir de um único snapshot consistente. Casos de uso de joalheria também podem exigir preços por quilate.

5. Você precisa de bid e ask, ou o preço médio basta? Gráficos e avaliações normalmente usam o preço médio. Vitrines de revendedores, calculadoras de recompra e ferramentas de trading geralmente precisam dos dois lados da cotação. Pergunte se bid e ask são oferecidos, para quais símbolos e em quais planos, e se vêm do mesmo snapshot que o preço médio. Se os termos são novos para você, o nosso artigo sobre spot, bid, ask e spread explica cada um deles.

Operação: confiabilidade, limites e erros

6. Quão confiável ela é, e como você saberia? Procure uma página de status pública que cubra as fontes de dados, além da API, e algum histórico de incidentes. Pergunte o que acontece quando uma fonte upstream falha: o fornecedor recorre a outra fonte, marca os dados como desatualizados ou continua servindo o último preço sem avisar? Se a disponibilidade importa para você contratualmente, verifique quais planos incluem um acordo de nível de serviço (SLA) e o que exatamente ele cobre.

7. Quais são os limites de requisições e as cotas, e o que conta? A maioria dos fornecedores combina uma cota mensal de requisições com um limite por minuto ou por segundo. Os detalhes mudam a conta mais do que os números em destaque. Uma requisição de vinte símbolos conta como uma chamada ou como vinte? Requisições com falha são cobradas? Alguns endpoints são gratuitos? O que acontece no limite: bloqueio total até o próximo período, cobrança automática de excedente ou redução de velocidade? Simule o seu uso real em cada plano; uma requisição por minuto, 24 horas por dia, dá cerca de 43.200 requisições por mês.

8. Como os erros são informados? Uma boa API retorna um status HTTP significativo junto com um código de erro legível por máquina e uma mensagem legível por humanos, documenta todos os códigos e diz quando tentar de novo, por exemplo com um cabeçalho Retry-After nos limites de requisições. Verifique se o formato de erro é o mesmo em todos os endpoints e se há uma especificação legível por máquina, como OpenAPI, para gerar clientes e testes.

Comercial: preços, segurança e termos

9. O modelo de preços combina com o seu uso? Compare planos mensais fixos, cobrança por chamada e contratos personalizados usando o seu próprio volume esperado, e não os exemplos do fornecedor. Verifique o que o plano gratuito realmente inclui (intervalo de atualização, endpoints), se a cobrança anual muda o preço, se há impostos adicionais e como funciona o cancelamento. Saltos grandes entre os planos importam se o seu uso fica perto de um limite.

10. Como as chaves de API são protegidas? Pergunte se as chaves podem ser enviadas em um cabeçalho, e não apenas na URL, já que URLs acabam em logs. Verifique se você pode ter várias chaves e rotacioná-las sem indisponibilidade, e se o fornecedor armazena as chaves como hash. Se você precisa de preços no navegador, procure chaves restritas por domínio ou um widget incorporável que evite expor qualquer chave: uma chave em JavaScript público pode ser copiada por qualquer pessoa.

11. O que os termos permitem? Leia a licença de dados antes de desenvolver. Você pode exibir os preços para os seus próprios clientes? Pode armazenar o histórico no seu banco de dados? A redistribuição, como oferecer os dados pela sua própria API, é permitida e, se não for, existe uma licença para isso? É obrigatório citar a fonte? Benchmarks oficiais, como os preços da LBMA, são geridos por administradores de benchmarks e geralmente licenciados à parte, então pergunte se um feed contém dados de benchmark e o que isso significa para você. Confira também o aviso legal: dados de preços normalmente são fornecidos como informação, e não como oferta de negociação.

Preparando-se para o futuro: suporte a IA e MCP

12. Assistentes e agentes de IA conseguem usá-la? Cada vez mais análises acontecem em assistentes de chat e agentes de programação. O Model Context Protocol (MCP) é um padrão aberto para conectá-los a ferramentas e dados, e um fornecedor com servidor MCP permite que um assistente busque preços reais em vez de adivinhar a partir dos dados de treinamento. Perguntas a fazer:

• Existe um servidor MCP hospedado, e quais transportes e clientes ele suporta?
• Como ele autentica: login OAuth para apps de chat, uma chave de API para ferramentas de desenvolvimento, ou os dois?
• Quais ferramentas são somente leitura, e as que alteram algo pedem confirmação antes?
• As chamadas do assistente contam na mesma cota, e o servidor pode fazer alguma cobrança por conta própria?
• Há documentação escrita para modelos de linguagem, como um arquivo llms.txt ou uma especificação OpenAPI, para que um assistente de programação consiga escrever a sua integração corretamente?

Mesmo que você não use ferramentas de IA hoje, as respostas dizem algo sobre o quão atualizada e bem documentada é uma API.

Um modelo de comparação para preencher

Copie esta tabela para uma planilha ou documento e preencha uma coluna por fornecedor. Anote de onde veio cada resposta (página da documentação, resposta do suporte ou teste próprio), para poder conferi-la de novo mais tarde.

Respostas no papel são um começo, mas um teste prático rápido resolve a maioria delas. Com uma chave gratuita ou de avaliação de cada candidato:

1. Solicite os mesmos símbolos no mesmo momento a cada fornecedor e compare valores, timestamps e unidades.
2. Repita a requisição em um sábado e veja como cada API representa um mercado fechado.
3. Provoque erros de propósito (uma chave errada, um símbolo desconhecido, uma data futura) e verifique os códigos de status e as mensagens.
4. Solicite um ano de histórico diário e procure lacunas, picos e uma mudança visível de nível onde uma fonte possa ter sido trocada.
5. Meça a latência a partir de onde os seus servidores rodam, e não do seu notebook.

Este pequeno script ajuda com o primeiro e o último pontos. Ajuste a URL, o cabeçalho de autenticação e o campo de timestamp de acordo com a documentação de cada fornecedor, e lembre-se de que cada chamada consome cota:

// Chama um endpoint algumas vezes e registra o status HTTP, a latência e a idade dos dados.
const TARGET = process.env.PRICE_API_URL;
const HEADERS = { Authorization: "Bearer " + process.env.PRICE_API_KEY };

for (let i = 0; i < 5; i++) {
  const started = Date.now();
  const res = await fetch(TARGET, { headers: HEADERS });
  const body = await res.json().catch(() => ({}));
  const latencyMs = Date.now() - started;

  // Muitas APIs retornam segundos Unix; adapte esta linha ao campo do fornecedor.
  const dataTime = typeof body.timestamp === "number" ? body.timestamp * 1000 : null;
  const dataAgeSeconds = dataTime ? Math.round((Date.now() - dataTime) / 1000) : "n/a";

  console.log({ status: res.status, latencyMs, dataAgeSeconds });
  await new Promise((resolve) => setTimeout(resolve, 2000));
}

Como a MetalAPI responde a essas perguntas

Para completar, aqui estão as nossas próprias respostas, limitadas a fatos que você pode conferir na nossa documentação. Exija de nós o mesmo padrão que de todos os outros.

1. Fontes: metais preciosos à vista e as principais moedas a partir de feeds interbancários de bid/ask; metais industriais e energia a partir dos contratos futuros de vencimento mais próximo da COMEX, NYMEX e ICE; cripto da Kraken e da Binance; taxas de referência do Banco Central Europeu para câmbio. Várias fontes são combinadas pela mediana e verificadas contra ticks errados.
2. Atualidade: diária no Free, a cada 30 minutos no Lite, 10 minutos no Standard, 1 minuto no Advanced e no Pro, 15 segundos no Ultra e no Business e 5 segundos no Enterprise. Toda resposta traz o timestamp dos dados; no fim de semana, os preços de metais, moedas e futuros ficam no fechamento de sexta-feira.
3. Histórico: abertura, máxima, mínima e fechamento diários para moedas desde 1999, metais e energia desde 2000 e cripto desde 2014. O histórico de metais anterior a outubro de 2026 se baseia nas liquidações dos contratos futuros de vencimento mais próximo. Uma requisição de intervalo abrange até 30 dias no Free e 365 dias nos planos pagos.
4. Unidades e moedas: sete unidades de massa, do grama à tonelada curta, 57 moedas e qualquer símbolo como base, com taxas cruzadas de um único snapshot. Preços do ouro por quilate nos planos pagos.
5. Bid/ask: símbolos no estilo XAU-BID e XAU-ASK a partir do Standard, para metais preciosos e as principais moedas, do mesmo snapshot que o preço médio.
6. Confiabilidade: uma página de status pública que mostra fontes de dados, latência e volume da API, inclusive quando fontes de reserva estão em uso; SLA de disponibilidade nos planos Business e Enterprise.
7. Limites: uma cota mensal mais um limite por minuto em todos os planos. Uma requisição conta uma vez, não importa quantos símbolos retorne; /symbols e /usage são gratuitos; requisições rejeitadas por limite de requisições, restrição de plano, verificação de origem ou erro de servidor não são cobradas. Ao atingir a cota, as requisições retornam o erro 105 até o dia 1º do mês (UTC) ou até um upgrade; não há cobrança automática de excedente.
8. Erros: um status HTTP mais um code numérico, um type e uma mensagem info em JSON, Retry-After nos limites de requisições, uma lista documentada de códigos e uma especificação OpenAPI 3.1.
9. Preços: planos fixos, do Free (US$ 0, 100 requisições por mês), passando por Lite (US$ 4,99), Standard (US$ 11,99), Advanced (US$ 24,99), Pro (US$ 49,99), Ultra (US$ 99,99) e Business (US$ 149,99), até o Enterprise (US$ 299,99, 1,5 milhão de requisições), com cobrança mensal ou anual e cancelamento pela página de faturamento. Detalhes na página de preços.
10. Segurança: as chaves são armazenadas apenas como hash e podem ser enviadas em um cabeçalho; dependendo do plano, você pode ter várias chaves, substituí-las ou revogá-las e restringi-las aos seus próprios domínios. Os widgets incorporáveis mostram preços sem expor nenhuma chave.
11. Termos: você pode usar os dados nos seus próprios sites, apps, sistemas internos e relatórios, inclusive para mostrar preços aos seus usuários; redistribuir o feed bruto, por exemplo como a sua própria API, exige um acordo por escrito à parte. Os dados são fornecidos a título informativo e não constituem recomendação de investimento. Veja os termos.
12. IA e MCP: um servidor MCP hospedado em https://metalapi.com/mcp (Streamable HTTP, OAuth 2.1 ou chave de API) com 13 ferramentas, 11 delas somente leitura; as duas que alteram algo pedem confirmação antes, e o servidor nunca faz nenhuma cobrança. Ele está listado no MCP Registry oficial, e o llms.txt e a especificação OpenAPI são publicados. Veja IA e MCP.

Seja qual for o fornecedor escolhido, faça os testes práticos acima com os seus próprios símbolos e padrão de uso. Se a MetalAPI estiver na sua lista, uma conta grátis basta para a maioria deles, e a documentação da API cobre o resto.