Estas respostas abrangem perguntas técnicas comuns sobre a integração com a API de dados de moedas. Para ver todos os endpoints e parâmetros, consulte a documentação da API. Para uma visão geral das nossas taxas, consulte Como funciona a API de dados de moedas?

Neste artigo

• Qual endpoint devo usar para cada tipo de taxa?
• Como obtenho a lista completa de moedas?
• Quais pares de moedas o endpoint de compra e venda abrange?
• Como a API lida com moedas obsoletas?
• Como obtenho taxas de compra e venda de um banco central?
• Por que uma taxa de banco central parece ser do dia anterior?
• Posso armazenar em cache as taxas da API?
• Como obtenho a taxa de um dia anterior no horário de fixação da minha conta?
• Como encontro o certificado SSL da API?
• Por que estou recebendo timeouts ou erros 500?
• Preciso permitir endereços IP?
• Por que estou recebendo erros 401 ou 403?

Qual endpoint devo usar para cada tipo de taxa?

As taxas de criptomoedas vêm das nossas taxas de mercado médio, portanto, você deve solicitá-las por meio dos endpoints de mercado médio. Adicione crypto=true à sua solicitação para incluí-las.

Como obtenho a lista completa de moedas?

Use o endpoint /v2/currencies. Para cada moeda, ele mostra:

• se ela tem um código ISO 4217
• a data em que foi introduzida e, se estiver obsoleta, a data em que foi retirada
• as datas de início e término das nossas taxas para ela
• a moeda que a substituiu e qualquer indexação

Por padrão, a lista inclui moedas ativas e obsoletas. Para alterar isso:

• adicione obsolete=true para mostrar apenas as moedas obsoletas para as quais temos dados históricos
• adicione obsolete=false para substituir as moedas obsoletas pela moeda que as substituiu

Quais pares de moedas o endpoint de compra e venda abrange?

O endpoint /v1/bid_ask abrange AUD, BRL, CAD, CHF, CNH, DKK, EUR, GBP, JPY, NOK, NZD, PLN, SEK e USD.

Você pode solicitar qualquer par em qualquer direção, exceto os seguintes pares com CNH (yuan chinês offshore):

• CNH não está disponível com BRL, DKK ou PLN, em nenhuma direção.
• CNH só está disponível como moeda de destino com NOK e SEK. Por exemplo, você pode solicitar from=NOK&to=CNH, mas não from=CNH&to=NOK.

Como a API lida com moedas obsoletas?

Às vezes, as moedas são renomeadas, redenominadas ou retiradas. Por padrão, a API responde na moeda usada atualmente; portanto, se você solicitar um código retirado, receberá as taxas da moeda que o substituiu. Para obter as taxas do próprio código retirado, adicione obsolete=true à sua solicitação.

Calculamos as taxas de uma moeda obsoleta após a data de retirada com base na sua indexação fixa à moeda que a substituiu. Isso mantém os históricos longos consistentes, mas essas não são taxas de mercado.

Para obter mais detalhes, incluindo como calculamos médias e estatísticas durante uma mudança de moeda, consulte Taxas históricas e moedas obsoletas na documentação da API.

Como obtenho taxas de compra e venda de um banco central?

Adicione fields=mid,bid,ask à sua solicitação para /v1/central_bank_rate. Sem isso, você receberá apenas a taxa média.

• Você só receberá taxas de compra e venda de bancos centrais que as publiquem. 37 dos 100 bancos centrais fazem isso, incluindo o Banco do Japão, a Autoridade Monetária de Hong Kong, o Banco Central do Brasil e o Banco da Tailândia. O Banco Central Europeu, o Banco da Inglaterra e o Federal Reserve Bank de Nova York publicam apenas taxas de referência. A coluna Bid/Ask na documentação da API mostra quais bancos as publicam.
• As taxas de compra e venda estão disponíveis apenas para taxas atuais. Se você adicionar uma date à sua solicitação, receberá apenas taxas médias.
• Essas são as taxas publicadas por cada banco central. Elas são diferentes das próprias taxas de compra e venda da Xe no endpoint /v1/bid_ask.

Por que uma taxa de banco central parece ser do dia anterior?

Se você não informar uma data, /v1/central_bank_rate retornará um timestamp em UTC. Quando você o converte para o seu horário local, a taxa pode parecer ser do dia anterior.

Para obter a própria data local do banco, adicione use_bank_date=true à sua solicitação. Por exemplo, para o Banco Central Europeu, você obteria 2026-08-17 em vez de 2026-08-16T22:00:00Z. Isso funciona para respostas JSON, XML e CSV.

Posso armazenar em cache as taxas da API?

Sim, por tempo limitado. O armazenamento em cache ajuda sua integração a funcionar mais rapidamente e reduz o número de solicitações feitas. Remova as taxas armazenadas em cache quando elas estiverem desatualizadas. Armazenar em cache significa manter as taxas temporariamente. Não significa armazená-las permanentemente.

Como obtenho a taxa de um dia anterior no horário de fixação da minha conta?

Chame /v1/historic_rate com date=YYYY-MM-DD e use_lock_in_time=true. Você obterá a taxa como ela estava no horário diário de fixação da sua conta naquele dia. Por exemplo, você pode usar isso para obter a taxa de sexta-feira durante a semana seguinte.

Seu horário de fixação não afeta as taxas de bancos centrais. Elas seguem o próprio cronograma de publicação de cada banco.

Como encontro o certificado SSL da API?

Você pode baixar o certificado pelo navegador, usando o Chrome ou o Edge.

No Chrome

1. Abra o Chrome e acesse https://dfs.xe.com/dfs ou https://xecdapi.xe.com/v1.

2. Selecione o ícone de informações do site à esquerda da barra de endereço.

   

3. Selecione A conexão é segura e, em seguida, selecione O certificado é válido.

   

4. Na janela de detalhes do certificado, acesse a guia Detalhes.

   

5. Selecione Exportar para baixar o certificado para o sistema.

   

No Edge

1. Acesse https://dfs.xe.com/dfs ou https://xecdapi.xe.com/v1.

2. Selecione o ícone de cadeado na barra de endereço.

   

3. Selecione A conexão é segura.
4. Selecione o ícone de certificado no canto superior direito do pop-up.

5. Na janela do certificado, abra a guia Detalhes.

   

6. Selecione Exportar para baixar o certificado.
   
   

Por que estou recebendo timeouts ou erros 500?

A maioria dos timeouts intermitentes e dos erros 5xx começa na rede ou no gateway entre o seu sistema e o nosso. Antes de entrar em contato conosco, verifique:

• Gateways e middleware: se você chama a API por meio de uma plataforma de integração ou gateway de API, verifique primeiro os respectivos logs. Os erros criados por eles podem parecer erros da nossa API.
• DNS: não codifique nem armazene em cache nosso endereço IP. Resolva xecdapi.xe.com normalmente e respeite os TTLs do DNS, pois o endereço IP associado a ele pode mudar.
• Timeouts e pools de conexão: certifique-se de que as configurações do seu cliente comportem o volume de solicitações. Distribua grandes lotes em vez de enviá-los todos de uma vez.
• TLS: seu cliente deve ser compatível com TLS 1.2 ou posterior, usando conjuntos de cifras modernos (GCM). Pilhas mais antigas, como Java 7 ou .NET legado, podem oferecer apenas cifras CBC, que estamos descontinuando. Você pode testar seu cliente em https://xecd-rates-api-test.xe.com/, que aceita apenas TLS 1.3 e TLS 1.2 com GCM.

Se os erros continuarem, envie um e-mail para data@xe.com com o ID da sua conta, o endpoint e os parâmetros, os horários UTC das falhas e a resposta de erro completa.

Preciso permitir endereços IP?

Não. A API de dados de moedas não restringe os chamadores por endereço IP. Você pode chamar https://xecdapi.xe.com de qualquer IP público e não precisa registrar o seu conosco.

Se o firewall permitir tráfego de saída apenas para endereços IP fixos, use nosso endpoint de IP estático, xecd-proxy.xe.com, e adicione o endereço IP dele à sua lista de permissões. para obter o IP atual. Enviamos um e-mail a todos que usam esse endpoint antes de alterar o IP e antes de manutenções planejadas.

• Use xecd-proxy.xe.com somente se precisar de um IP fixo. Caso contrário, chame xecdapi.xe.com diretamente.
• Se as solicitações começarem a falhar após uma mudança de rede do seu lado, verifique se a lista de permissões do firewall ainda inclui nosso IP estático.

Se você usa o Datafeed (DFS) legado

O DFS aceita solicitações apenas de IPs incluídos na lista de permissões. Se os IPs do seu escritório ou servidor mudarem, envie-nos os novos endereços. Se você migrar para a API, não precisará permitir IPs.

Por que estou recebendo erros 401 ou 403?

• 401 Credenciais inválidas: verifique o ID da conta e a chave de API enviados pela sua integração. Ambos diferenciam maiúsculas de minúsculas.
• 403 "exceeded max number of access attempts": após 3 tentativas de autenticação malsucedidas, bloqueamos a conta por até 5 minutos. O bloqueio se aplica a todas as integrações da conta, inclusive às que usam as credenciais corretas. Normalmente, isso significa que outro sistema, como um servidor antigo ou um script de teste, ainda está enviando uma chave desatualizada.

Para corrigir um erro 403:

1. Encontre o sistema que está enviando a chave antiga e atualize-o ou desligue-o.
2. Aguarde 5 minutos e tente novamente.