Cómo obtener el tipo de cambio dolar Banxico con una API

El tipo de cambio dolar Banxico es la tasa de referencia oficial publicada por el Banco de México a través del Sistema de Información Económica (SIE). En este artículo te explicamos cómo acceder a este dato mediante una API REST y cómo integrarlo en tu aplicación para conversiones, contabilidad, pagos transfronterizos y procesos de cumplimiento.

¿Qué es el tipo de cambio dólar Banxico y por qué es la referencia oficial?

El tipo de cambio que publica Banxico (conocido como tipo de cambio FIX) es el valor del dólar estadounidense frente al peso mexicano determinado por el Banco de México cada día hábil. Se calcula con base en las cotizaciones del mercado interbancario y se publica después del cierre de operaciones. Esta tasa es la que utilizan el SAT, la CNBV y otras autoridades para fines fiscales, contables y regulatorios.

Diferencia entre el tipo de cambio Banxico y el interbancario

El tipo de cambio interbancario es la tasa a la que los bancos comerciales negocian entre sí en tiempo real durante la jornada. El tipo de cambio FIX de Banxico, en cambio, es un promedio ponderado del mercado al cierre, y se publica una sola vez al día. No es una tasa en tiempo real, sino un valor oficial de referencia. Para aplicaciones que requieren la tasa exacta para liquidar impuestos, contratos o reportes regulatorios, el tipo de cambio oficial es el que debe usarse.

¿Quién publica los datos? (Banxico, SIE)

El Banco de México pone a disposición del público los indicadores económicos a través del Sistema de Información Económica (SIE). Desde 2018, Banxico ofrece una API REST que permite consultar series de tiempo como el tipo de cambio USD/MXN, TIIE, UDIS, entre otros. La documentación de esta API se encuentra en el sitio oficial del banco central.

¿Cómo funciona la API de Banxico para obtener el tipo de cambio?

La API de Banxico es un servicio REST que devuelve datos en formato JSON. Para consumirla necesitas registrarte y obtener un token de acceso. Con ese token puedes hacer solicitudes a la serie correspondiente al tipo de cambio FIX (por ejemplo, la serie SF43718 o SF60653, que corresponden a diferentes versiones). La respuesta incluye el valor, la fecha y metadatos de la serie.

Lo que envías y lo que recibes (conceptualmente)

Envías una solicitud GET a la URL de la serie indicando el token de autenticación. Puedes especificar parámetros de fecha (inicio, fin) o pedir el último dato disponible. Recibes un objeto JSON con la estructura:

• series: contiene el identificador de la serie.
• datos: un arreglo con objetos que incluyen fecha y dato (el valor numérico).

No inventamos rutas ni parámetros exactos; consulta la documentación oficial de Banxico para los detalles precisos de la llamada.

Autenticación y frecuencia de actualización

La API requiere una llave (API key) que se obtiene llenando un formulario en el sitio de Banxico. Una vez que la tienes, puedes realizar hasta 100 solicitudes por minuto sin costo. La actualización de la tasa ocurre una vez al día hábil, alrededor de las 14:00 horas (hora del centro de México). En días no hábiles no se publica cambio.

Integración práctica de la API de Banxico en tu aplicación

Para integrar la tasa en tu sistema, el flujo recomendado es:

1. Obtén la tasa una vez al día mediante una llamada programada (cron job, scheduler).
2. Almacena el valor en una base de datos o caché (por ejemplo, Redis).
3. Utiliza la tasa almacenada para todas las conversiones del día.
4. Configura un webhook o una tarea automática para actualizar al día siguiente.

Ejemplo de flujo de solicitud (sin código real, solo concepto)

Tu servidor hace una petición GET a la URL de la serie con tu token. La respuesta JSON contiene el último dato. Extraes el campo dato y lo conviertes a número. Luego guardas ese valor con la fecha correspondiente. Es importante validar que la respuesta sea exitosa (código 200) y que el dato no sea nulo.

Manejo de errores y actualizaciones diarias

La API de Banxico puede devolver errores temporales o datos vacíos si la consulta se hace antes de la publicación. Por eso, programa tu tarea para después de las 14:00 horas. Además, implementa reintentos con backoff exponencial. Si falla después de varios intentos, puedes usar la última tasa válida almacenada.

Casos de uso reales para el tipo de cambio Banxico

Procesamiento de pagos transfronterizos (ACH)

Cuando realizas una transferencia ACH de Estados Unidos a México, el banco receptor utiliza el tipo de cambio oficial para convertir el monto a pesos. Tener acceso a la tasa Banxico te permite estimar el monto exacto que recibirá tu usuario antes de que la transacción se liquide.

Cálculo de impuestos y contabilidad

El SAT exige que las operaciones en moneda extranjera se conviertan al tipo de cambio oficial publicado en el Diario Oficial de la Federación (DOF). Este tipo de cambio es el mismo que publica Banxico. Integrar la API te permite automatizar la conversión en facturas y declaraciones.

Conversión en cajeros automáticos (ATM)

Los bancos usan el tipo de cambio Banxico como referencia para mostrar el monto en pesos cuando retiras dólares en un cajero. Aunque pueden aplicar un spread, la tasa base es la oficial.

Valuación de portafolios de AFORE

Las Administradoras de Fondos para el Retiro (AFORE) deben valuar sus inversiones en dólares al tipo de cambio oficial. La API de Banxico les proporciona la tasa diaria de forma confiable y auditable.

AML y cumplimiento

En procesos de prevención de lavado de dinero, las instituciones financieras deben reportar operaciones en divisas. La tasa oficial de Banxico es la referencia aceptada por la CNBV para detectar inconsistencias entre el monto reportado y el tipo de cambio aplicado.

¿Cuándo NO usar la API de Banxico?

La API de Banxico es excelente para obtener la tasa oficial diaria, pero no es adecuada para todos los escenarios:

• Tasas en tiempo real: Si necesitas cotizaciones intradía para trading o plataformas de forex, la API de Banxico no es la herramienta correcta. Para eso existen fuentes como Bloomberg, Reuters o APIs de terceros que ofrecen datos en tiempo real.
• Tasas de mercado paralelo: La tasa oficial puede diferir de la tasa de mercado abierto o del tipo de cambio que ofrecen las casas de cambio. Para aplicaciones que requieren la tasa de venta al público, considera otras fuentes.
• Datos históricos profundos: Aunque la API permite consultar series históricas, para análisis masivos puede ser más eficiente usar bases de datos locales o servicios especializados.

En resumen, usa la API de Banxico cuando necesites la tasa oficial de referencia; no la uses para operaciones intradía o cuando necesites spreads de compra/venta.

Consideraciones de cumplimiento y precisión de datos

Uso en procesos AML/KYC

Las instituciones reguladas por la CNBV deben utilizar el tipo de cambio oficial para reportar operaciones en divisas. La API de Banxico proporciona datos firmados (o al menos con metadatos que permiten verificar su origen) para cumplir con los requisitos de integridad. Asegúrate de almacenar la respuesta completa (incluyendo la fecha y la serie) en tus registros de auditoría.

Validación de integridad de datos

Aunque no inventamos detalles técnicos, la respuesta de la API incluye identificadores de serie y fechas que permiten cruzar la información con el DOF. Puedes implementar una verificación periódica contra la publicación oficial en el Diario Oficial de la Federación para garantizar que no haya discrepancias.

Relación con AML

En el ámbito de AML, el uso de la tasa oficial ayuda a detectar operaciones inusuales. Por ejemplo, si una transacción reporta un tipo de cambio significativamente diferente al oficial, podría ser un indicio de lavado de dinero. La API de Banxico te permite automatizar esa validación.

Próximos pasos con la API de Banxico de API Pull

En API Pull hemos simplificado el acceso a la API de Banxico a través de nuestro API Hub. Ofrecemos un sandbox con datos de prueba para que puedas simular la integración sin consumir llamadas reales. Nuestra documentación incluye ejemplos de solicitudes y respuestas, así como guías de manejo de errores. Además, tenemos artículos complementarios sobre cómo acceder a otras tasas e indicadores y cómo usar la API de Banxico para datos financieros.

Si estás listo para integrar el tipo de cambio oficial en tu aplicación, te invitamos a probar nuestra API de forma gratuita. No hay compromiso: solo regístrate y obtén tu token de sandbox para empezar a hacer pruebas hoy mismo.

Para más información sobre cumplimiento y AML, consulta nuestra guía de CURP Compliance API y AML API Mexico.