Documentación de la API

egenio FX ofrece los tipos de cambio oficiales diarios de bancos centrales y autoridades tributarias de América Latina, y del BCE, a través de una sola API HTTPS con JSON uniforme.

Autenticación

Envíe su clave en el encabezado X-API-Key:

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

Para una prueba rápida en el navegador puede agregar ?api_key=… a la dirección; en integraciones prefiera el encabezado, porque las direcciones pueden quedar en registros y en el historial del navegador. Mantenga sus claves en secreto: cualquiera que tenga su clave puede usar su cuota. Por ahora las nuevas claves de prueba gratis están pausadas; las claves que ya tiene siguen funcionando.

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

Pruébela

Ingrese su clave de API, elija un endpoint y sus opciones, y envíe una solicitud real. Su clave se queda en esta página: solo se envía a api.egenio.net en el encabezado X-API-Key y no se guarda en ningún lugar. Cada solicitud cuenta para su límite. ¿No tiene clave? Deje el campo vacío para usar el acceso sin clave.

Tipos del día y últimos

Todos los tipos de un día: para cada moneda, el tipo oficial más reciente en o 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 es el día para el que se publicó el tipo. Puede ser anterior a date en fines de semana y feriados (vea más abajo).

Algunas monedas: último tipo o una fecha específica

Agregue currencies con un código, o varios separados por comas (currencies=MXN,BRL,COP). Omita date para obtener el último tipo, o agréguelo para el tipo vigente ese día (en fin de semana o feriado, el del día hábil anterior).

# Último tipo USD→MXN
curl -H "X-API-Key: fx_su_clave_aqui" \
  "https://api.egenio.net/v1/rates?currencies=MXN"

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

# Peso mexicano, real brasileño y peso colombiano del 28 de septiembre de 2026
curl -H "X-API-Key: fx_su_clave_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" }
  ]
}

Con una moneda, el tipo está en rates[0].rate; con varias, rates tiene una entrada por moneda, en orden alfabético. Otros ejemplos: euro a real brasileño con base=EUR&currencies=BRL; para verlo rápido en el navegador, https://api.egenio.net/v1/rates?currencies=MXN&api_key=fx_su_clave_aqui.

En Power Automate: una acción HTTP con método GET, la dirección anterior y el encabezado X-API-Key; luego use la expresión body('HTTP')?['rates']?[0]?['rate'] donde necesite el tipo (envuélvala en float(…) para hacer cálculos).

En Excel: Datos → Desde la web → Avanzado, ingrese la dirección y agregue el encabezado X-API-Key; Power Query convierte la respuesta en una tabla.

Historial

Una moneda, un tipo por cada día publicado, del más antiguo al más reciente.

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

Filas con los nombres de la entidad de datos Tipos de cambio (ExchangeRates). EndDate se omite: F&O lo calcula a partir de la fecha de inicio del siguiente tipo.

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"
  }]
}

Con Power Automate

Descargue nuestra solución de ejemplo e impórtela en el entorno de Power Platform vinculado a F&O. Contiene un flujo de nube que se ejecuta dos veces al día, lee los tipos de los últimos 7 días desde egenio FX, omite los que F&O ya tiene y crea el resto en la entidad ExchangeRates. Inicia sesión en F&O con el conector estándar Fin & Ops Apps, así que no necesita un registro de aplicación en Azure. Si una ejecución falla, le envía un correo con el paso que falló y el motivo; mientras hace pruebas, también puede enviarle un resumen después de cada ejecución correcta.

Descargar solución de ejemplo (.zip)

Antes de importar

1. Obtenga una clave de API de egenio FX (para empezar sirve una clave de prueba gratis).
2. Elija la cuenta de F&O con la que trabajará el flujo: un usuario (idealmente una cuenta de servicio) que pueda mantener tipos de cambio.
3. Asegúrese de que el tipo de cambio (p. ej. Default) y las monedas existan en F&O.
4. Elija el buzón de Office 365 que enviará los correos del flujo (un buzón compartido o de servicio funciona bien).

Importar

1. En Power Apps → Soluciones → Importar solución, elija el zip descargado.
2. Cuando se le pidan las conexiones, cree o elija una conexión de Fin & Ops Apps (Dynamics 365), con la sesión de esa cuenta de F&O, y una conexión de Office 365 Outlook para ese buzón.
3. Complete las variables de entorno cuando se le pidan:

   Variable	Ejemplo
   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] (varios: sepárelos con ;)
   Email on success	Sí durante las pruebas, No después (los errores siempre se envían)

4. Abra el flujo egenio FX - Import exchange rates into FO, ejecútelo una vez con Probar → Manualmente y luego actívelo. Se importa desactivado.

El flujo usa la acción premium HTTP y el conector premium Fin & Ops Apps, por lo que su propietario necesita una licencia premium de Power Automate. ¿Prefiere crearlo usted mismo? Los pasos son: Periodicidad → HTTP GET /v1/fo/exchange-rates con el encabezado X-API-Key → Analizar JSON → Aplicar a cada uno sobre value → Crear registro de Fin & Ops Apps en ExchangeRates.

Con Administración de datos (CSV)

1. Descargue /v1/fo/exchange-rates?from=…&to=…&format=csv.
2. En F&O: Administración de datos → Importar, entidad Tipos de cambio, formato de origen CSV. Las columnas se asignan automáticamente.
3. Las fechas son AAAA-MM-DD; si su formato de datos de origen espera otro formato de fecha, ajústelo allí.

Pruebe siempre la importación primero en un sandbox.

Fuentes y convenciones

Las fuentes se consultan cada hora; los días recientes se vuelven a revisar para incorporar correcciones. Los tipos nunca se calculan ni se invierten: recibe exactamente lo que publicó la autoridad.

Fines de semana y feriados

La mayoría de las autoridades no publica en fines de semana y feriados. /v1/rates devuelve entonces el tipo más reciente de cada moneda (con un máximo de 10 días de antigüedad) e indica su rate_date. Así se sigue la regla habitual (p. ej. la de SUNAT) de usar el tipo del día hábil anterior. Los endpoints de historial y de F&O listan solo los días publicados; F&O mantiene cada tipo vigente hasta el siguiente.

Direcciones del servicio

Dos direcciones públicas que no requieren clave de API, ambas en texto o JSON para herramientas, no páginas para leer:

Errores

Los errores devuelven JSON: {"error": "explicación"}. La explicación está en inglés.

Límites

El acceso es gratuito durante las pruebas. Cada clave tiene un nivel de acceso con un límite mensual de solicitudes y una ventana de historial:

Cada respuesta incluye X-RateLimit-Limit y X-RateLimit-Remaining para el mes (para el día, sin clave). Además, cada dirección cliente puede hacer hasta 300 solicitudes por minuto, y las direcciones que envían muchas claves inválidas se pausan durante un minuto.

Preguntas frecuentes