Saltar al contenido principal
GET
Obtener tipos de cambio
Los comercios que venden a través de fronteras necesitan una única tasa de referencia para fijar precios en una moneda y conciliar en otra. Este endpoint devuelve la tasa de cambio diaria oficial de Yuno, la misma referencia que Yuno usa en sus propios reportes, expresada como unidades de la moneda por 1 USD. Se publican alrededor de 161 monedas por día. USD se publica con una tasa de 1.
Habilitado por organizaciónEsta API requiere activación para tu organización. Contacta a tu Key Account Manager (KAM) para habilitarla.

Qué es y qué no es

Esta es una tasa de referencia, publicada una vez por día para un día cerrado. Yuno no se compromete a procesar ni liquidar a esta tasa.
  • Es de solo lectura: sin cotizaciones, sin bloqueo de tasa, sin conversión aplicada a un pago.
  • No es una tasa en vivo ni intradía. El valor de un día es final una vez que se cierra la carga diaria.
  • Para convertir una transacción real en el checkout, usa Conversion Rate. Es un producto distinto: una cotización de un proveedor para una transacción.

Elegir qué solicitas

Todos los parámetros son opcionales, y la forma de la respuesta depende de lo que envíes: end_date es el único parámetro con un complemento: no se puede usar sin start_date. Todo lo demás funciona por sí solo. Límites del rango: hasta 31 días cuando se omite currency, y hasta 366 días cuando solicitas una sola moneda.

El último día disponible

Sin fechas, obtienes el día publicado más reciente en lugar de una fecha que tengas que calcular. El día actual nunca se entrega, porque su valor no es final hasta que se cierra la carga diaria, así que el día más nuevo que puedes recibir es ayer (UTC). Si una carga diaria se retrasa, esta también es la forma segura de consultar: recibes el día más nuevo que realmente existe en lugar de una respuesta vacía para un día que nunca se publicó.

Cómo leer la respuesta

Tres reglas se cumplen en toda respuesta:
  1. Ordenada por fx_date y luego por currency.
  2. Un valor por moneda por día. Cuando existe más de una fuente para un día, el desempate ocurre dentro de Yuno y no forma parte de este contrato.
  3. Lo que no existe simplemente está ausente. Un día o una moneda sin tasa publicada no aparece en rates, y un rango sin nada publicado devuelve 200 con un arreglo vacío, no un error. Trata un rates vacío como “no hay nada publicado para lo que pediste”, nunca como una falla.
Interpreta rate con un tipo decimal.Las tasas tienen hasta 15 decimales. 3306.859716727782946 leído como double se convierte en 3306.859716727783, y la diferencia aparecerá en la conciliación. Usa el tipo decimal o de números grandes de tu lenguaje, no un float: BigDecimal en Java, decimal.Decimal en Python, shopspring/decimal en Go, una librería decimal en JavaScript en lugar de solo JSON.parse.

Códigos de moneda

Los códigos son en su mayoría ISO 4217, pero el conjunto publicado también incluye códigos que no son monedas fiduciarias, como BTC, XAU (oro) y XAG (plata). Un código bien formado que Yuno no publica no es un error: se devuelve como un arreglo rates vacío.

Almacenamiento en caché

Un día publicado nunca cambia, por lo que una respuesta de un día pasado se puede almacenar en caché indefinidamente. Consultar sin fechas es la única solicitud cuya respuesta cambia, una vez por día.

Errores

Los errores devuelven un code y un arreglo messages. El mensaje nombra el parámetro con el problema.

Encabezados

PUBLIC-API-KEY
string

Tu clave de API pública.

PRIVATE-SECRET-KEY
string

Tu clave secreta privada. Nunca la expongas del lado del cliente.

Parámetros de consulta

start_date
string<date>

Primer día del rango, inclusive, como YYYY-MM-DD. Omítelo para obtener el último día disponible.

Ejemplo:

"2026-09-28"

end_date
string<date>

Último día del rango, inclusive, como YYYY-MM-DD. Solo es válido junto con start_date, toma ese valor por defecto y no puede ser posterior a ayer (UTC).

Ejemplo:

"2026-09-30"

currency
string

Un código de moneda de 3 letras. Omítelo para obtener todas las monedas publicadas en esos días.

Required string length: 3
Ejemplo:

"COP"

Respuesta

OK: los tipos de cambio publicados para los días solicitados.

base_currency
string

Siempre USD en esta versión. Es explícito para que la lectura no sea ambigua.

Ejemplo:

"USD"

rates
object[]