exchangerate.dev1. Clases de fuentes
El campo público source describe una clase de datos, no un proveedor. live corresponde a datos indicativos del mercado al contado que pueden actualizarse a intervalos cortos durante la semana de negociación interbancaria. ecb_daily es una tasa de referencia del Banco Central Europeo, que normalmente se publica una vez por día hábil. market_daily almacena el cierre diario del flujo de datos de mercado para las monedas sin una fijación del ECB.
Una respuesta con varias monedas incluye un mapa sources para cada moneda cotizada. Su campo source de nivel superior es conservador: indica la clase menos reciente presente en esa respuesta.
Referencia: tasas de cambio de referencia del euro del ECB.
2. Tiempo y estado del mercado
data_updated_at es el momento en que se escribió por última vez la observación subyacente. timestamp indica cuándo se generó la respuesta de la API. Usa el primero para calcular la antigüedad de los datos y el segundo para auditar el momento de la solicitud.
market_session es open durante la semana interbancaria, weekend desde el cierre del viernes a las 17:00 de Nueva York hasta el domingo a las 17:00 de Nueva York, o interbank_closed para un cierre conocido fuera del fin de semana. Una respuesta de fin de semana puede contener la última observación de la semana de negociación; la etiqueta no implica una cotización nueva durante el fin de semana.
3. Cambio de moneda base y tasas cruzadas derivadas
Las tasas se normalizan para que quienes llaman a la API puedan solicitar cualquier moneda base compatible. Cuando un par no se observa directamente, la API lo triangula a través de los pares componentes disponibles. Los valores derivados se identifican en derived_symbols; las respuestas de un solo par también exponen derived y un límite derivation_bps_max cuando corresponde.
Una tasa cruzada hereda la fuente menos reciente de sus pares componentes. Las aplicaciones que no puedan aceptar una tasa derivada deben comprobar los campos de derivación en lugar de deducirlo a partir del par de monedas.
4. Observaciones históricas
El historial diario combina fijaciones y cierres de mercado. Los datos de las principales monedas se remontan a 1999; unas 30 usan fijaciones del ECB y las otras 113, cierres de mercado, y las fechas de inicio varían según el par. En un fin de semana o festivo sin una nueva fijación, puede arrastrarse una observación anterior y se etiqueta con is_forward_filled: true. La API no inventa una fijación que no se haya publicado.
5. Validación y publicación
- Los identificadores de moneda se normalizan a códigos en mayúsculas de estilo ISO antes de calcular las tasas.
- Los campos de fuente y hora de actualización acompañan a la observación, en lugar de que el cliente los deduzca.
- Cuando faltan observaciones en vivo o son demasiado antiguas, se recurre a una clase de referencia diaria disponible en lugar de etiquetarlas como datos en vivo.
- Todos los planes usan la misma fuente; quienes usan Free y quienes llaman sin clave reciben tasas en vivo con 15 minutos de retraso.
- Las investigaciones publicadas deben incluir su ventana de medición, número de muestras, método y limitaciones.
6. Limitaciones
Estas son tasas de referencia indicativas, no cotizaciones de compra y venta ejecutables. No incluyen el margen ni las comisiones de bancos, emisores de tarjetas, intermediarios, proveedores de pagos ni operadores de cambio en efectivo. No deben usarse para liquidaciones, ejecución de pagos, negociación regulada ni como fuente de registro oficial. La cobertura y la actualidad de los datos pueden variar según la moneda, la disponibilidad de las fuentes, los cierres de mercado y el calendario de publicación de la institución de referencia.
7. Estándar de evaluación de la actualidad de los datos
Publicamos el protocolo antes de publicar una clasificación. La evaluación reproducible de la actualidad de los datos de las API de tasas de cambio define la ventana de observación, los requisitos de las marcas de tiempo, las métricas, las exclusiones y el tamaño mínimo de la muestra. Su protocolo legible por máquina no contiene actualmente resultados de proveedores; los resultados solo se añadirán cuando se alcance el umbral de evidencia establecido.
Historial de revisiones
1.1 · 9 de octubre de 2026: Se aclararon el retraso de Free y los cierres diarios de mercado.
1.0 · 16 de julio de 2026: Metodología pública inicial, significado de las fuentes, reglas de las sesiones de mercado, política de derivación, comportamiento de los datos históricos, limitaciones y estándar de publicación de evaluaciones comparativas.
Correcciones: hello@exchangerate.dev