Documentação da API

O egenio FX oferece as taxas de câmbio oficiais diárias de bancos centrais e autoridades fiscais da América Latina, e do BCE, por meio de uma única API HTTPS com JSON consistente.

Autenticação

Envie sua chave no cabeçalho X-API-Key:

curl -H "X-API-Key: fx_sua_chave_aqui" https://api.egenio.net/v1/rates

Para um teste rápido no navegador, você pode adicionar ?api_key=… ao endereço; em integrações, prefira o cabeçalho, porque endereços podem acabar em logs e no histórico do navegador. Mantenha as chaves em segredo: quem tiver a sua chave pode usar a sua cota. As novas chaves de teste grátis estão pausadas por enquanto; as chaves que você já tem continuam funcionando.

curl https://api.egenio.net/v1/rates?currencies=MXN,BRL

Experimente

Digite sua chave de API, escolha um endpoint e as opções e envie uma requisição real. Sua chave fica nesta página: é enviada apenas para api.egenio.net no cabeçalho X-API-Key e não é salva em lugar nenhum. Cada requisição conta para o seu limite. Não tem chave? Deixe o campo vazio para usar o acesso sem chave.

Taxas do dia e últimas

Todas as taxas de um dia: para cada moeda, a taxa oficial mais recente em ou antes de date.

GET /v1/rates?date=2026-09-28

{
  "date": "2026-09-28",
  "base": "USD",
  "rates": [
    { "currency": "BRL", "rate": "5.30160", "rate_date": "2026-09-28", "source": "BCB" },
    { "currency": "MXN", "rate": "17.7100",  "rate_date": "2026-09-28", "source": "Banxico" }
  ]
}

rate_date é o dia para o qual a taxa foi publicada. Pode ser anterior a date em fins de semana e feriados (veja abaixo).

Algumas moedas: última taxa ou uma data específica

Adicione currencies com um código, ou vários separados por vírgulas (currencies=MXN,BRL,COP). Deixe date de fora para a última taxa, ou inclua para a taxa vigente naquele dia (em fim de semana ou feriado, a do dia útil anterior).

# Última taxa USD→BRL
curl -H "X-API-Key: fx_sua_chave_aqui" \
  "https://api.egenio.net/v1/rates?currencies=BRL"

# Taxa USD→MXN de 28 de setembro de 2026
curl -H "X-API-Key: fx_sua_chave_aqui" \
  "https://api.egenio.net/v1/rates?currencies=MXN&date=2026-09-28"

# Peso mexicano, real e peso colombiano de 28 de setembro de 2026
curl -H "X-API-Key: fx_sua_chave_aqui" \
  "https://api.egenio.net/v1/rates?currencies=MXN,BRL,COP&date=2026-09-28"

{
  "date": "2026-09-28",
  "base": "USD",
  "rates": [
    { "currency": "MXN", "rate": "17.7100", "rate_date": "2026-09-28", "source": "Banxico" }
  ]
}

Com uma moeda, a taxa está em rates[0].rate; com várias, rates tem uma entrada por moeda, em ordem alfabética. Outros exemplos: euro para real com base=EUR&currencies=BRL; para ver rapidamente no navegador, https://api.egenio.net/v1/rates?currencies=BRL&api_key=fx_sua_chave_aqui.

No Power Automate: uma ação HTTP com método GET, o endereço acima e o cabeçalho X-API-Key; depois use a expressão body('HTTP')?['rates']?[0]?['rate'] onde precisar da taxa (envolva em float(…) para cálculos).

No Excel: Dados → Da Web → Avançado, digite o endereço e adicione o cabeçalho X-API-Key; o Power Query transforma a resposta em uma tabela.

Histórico

Uma moeda, uma taxa por dia publicado, da mais antiga para a mais recente.

GET /v1/rates/MXN?from=2026-09-24&to=2026-09-30

{
  "base": "USD", "currency": "MXN", "from": "2026-09-24", "to": "2026-09-30",
  "rates": [
    { "date": "2026-09-24", "rate": "17.5030", "source": "Banxico" },
    …
  ]
}

Dynamics 365 Finance & Operations

Linhas com os nomes da entidade de dados Taxas de câmbio (ExchangeRates). EndDate é omitido: o F&O o calcula a partir da data de início da taxa seguinte.

GET /v1/fo/exchange-rates?from=2026-09-28&to=2026-09-28&currencies=MXN&rate_type=Default

{
  "value": [{
    "RateTypeName": "Default", "FromCurrency": "USD", "ToCurrency": "MXN",
    "StartDate": "2026-09-28T00:00:00Z", "Rate": "17.7100", "ConversionFactor": "One"
  }]
}

Com o Power Automate

Baixe a nossa solução de exemplo e importe-a no ambiente do Power Platform vinculado ao F&O. Ela contém um fluxo de nuvem que roda duas vezes por dia, lê as taxas dos últimos 7 dias no egenio FX, ignora as que o F&O já tem e cria o restante na entidade ExchangeRates. Ele entra no F&O com o conector padrão Fin & Ops Apps, então não é preciso um registro de aplicativo no Azure. Se uma execução falhar, ele envia um e-mail dizendo qual etapa falhou e por quê; durante os testes, também pode enviar um resumo após cada execução bem-sucedida.

Baixar solução de exemplo (.zip)

Antes de importar

1. Obtenha uma chave de API do egenio FX (para começar, uma chave de teste grátis serve).
2. Escolha a conta do F&O com a qual o fluxo vai trabalhar: um usuário (de preferência uma conta de serviço) que possa manter taxas de câmbio.
3. Garanta que o tipo de taxa de câmbio (ex.: Default) e as moedas existam no F&O.
4. Escolha a caixa de correio do Office 365 que enviará os e-mails do fluxo (uma caixa compartilhada ou de serviço funciona bem).

Importar

1. Em Power Apps → Soluções → Importar solução, escolha o zip baixado.
2. Quando forem pedidas as conexões, crie ou escolha uma conexão do Fin & Ops Apps (Dynamics 365), entrando com essa conta do F&O, e uma conexão do Office 365 Outlook para essa caixa de correio.
3. Preencha as variáveis de ambiente quando solicitado:

   Variável	Exemplo
   egenio FX API key	fx_…
   FO environment URL	https://contoso.operations.dynamics.com
   Exchange rate type	Default
   Currencies	MXN,BRL,ARS,CLP,COP,PEN
   Notification email	[email protected] (vários: separe com ;)
   Email on success	Sim durante os testes, Não depois (falhas são sempre enviadas)

4. Abra o fluxo egenio FX - Import exchange rates into FO, execute-o uma vez com Testar → Manualmente e depois ative-o. Ele é importado desativado.

O fluxo usa a ação premium HTTP e o conector premium Fin & Ops Apps, então o proprietário precisa de uma licença premium do Power Automate. Prefere montar você mesmo? Os passos são: Recorrência → HTTP GET /v1/fo/exchange-rates com o cabeçalho X-API-Key → Analisar JSON → Aplicar a cada sobre value → Criar registro do Fin & Ops Apps em ExchangeRates.

Com o Gerenciamento de dados (CSV)

1. Baixe /v1/fo/exchange-rates?from=…&to=…&format=csv.
2. No F&O: Gerenciamento de dados → Importar, entidade Taxas de câmbio, formato de origem CSV. As colunas são mapeadas automaticamente.
3. As datas são AAAA-MM-DD; se o seu formato de dados de origem espera outro formato de data, ajuste-o lá.

Sempre teste a importação primeiro em um sandbox.

Fontes e convenções

As fontes são consultadas a cada hora; os dias recentes são verificados de novo para incorporar correções. As taxas nunca são calculadas nem invertidas: você recebe exatamente o que a autoridade publicou.

Fins de semana e feriados

A maioria das autoridades não publica em fins de semana e feriados. /v1/rates então devolve a taxa mais recente de cada moeda (com no máximo 10 dias) e mostra a sua rate_date. Isso segue a regra usual (ex.: a da SUNAT) de usar a taxa do dia útil anterior. Os endpoints de histórico e do F&O listam apenas os dias publicados; o F&O mantém cada taxa em vigor até a próxima.

Endereços do serviço

Dois endereços públicos que não precisam de chave de API, ambos em texto ou JSON para ferramentas, não páginas para leitura:

Erros

Os erros devolvem JSON: {"error": "explicação"}. A explicação vem em inglês.

Limites

O acesso é gratuito durante os testes. Cada chave tem um nível de acesso com um limite mensal de requisições e uma janela de histórico:

Toda resposta inclui X-RateLimit-Limit e X-RateLimit-Remaining para o mês (para o dia, sem chave). Além disso, cada endereço cliente pode fazer até 300 requisições por minuto, e endereços que enviam muitas chaves inválidas ficam pausados por um minuto.

Perguntas frequentes