Prueba una observación USD/JPY de 15 minutos
curl "https://api.exchangerate.dev/v1/timeseries?base=USD&symbols=JPY&interval=15m&from=2026-09-14T12:00:00Z&to=2026-09-14T12:00:00Z" -H "Authorization: Bearer YOUR_API_KEY"{ "result": "success", "base": "USD", "symbols": ["JPY"], "interval": "15m", "from": "2026-09-14T12:00:00Z", "to": "2026-09-14T12:00:00Z", "data": [{ "timestamp": "2026-09-14T12:00:00Z", "effective_at": { "JPY": "2026-09-14T12:14:58.972181Z" }, "rates": { "JPY": 154.582 }, "source": "live", "source_type": "market", "market_session": "open", "derived_symbols": [] }], "next_cursor": null, "has_more": false, "notice": "Indicative rates, not for settlement."}Ejemplo fijo observado el 2026-09-15 para el intervalo de las 12:00 UTC del 2026-09-14. El tipo es indicativo. timestamp marca el inicio del intervalo y effective_at, la hora de observación.
Intervalos e historia disponible
/v1/timeseries admite 1m, 5m, 15m, 1h, 4h y referencias diarias 1d; no hay 2h. Los cruces SGD sin USD no admiten 4h; USD/SGD y su inverso sí. La recopilación de mercado comenzó el 2026-09-14. Los datos 1m se conservan 30 días; los intervalos mayores no tienen caducidad programada. La retención no garantiza que ya exista toda esa profundidad. La cobertura intradía de 1m a 1h incluye 221 pares únicos: 143 pares USD y 78 cruces.
| interval | Pares únicos | Ventana máxima por solicitud |
|---|---|---|
1m | 221 | 7 d |
5m | 221 | 31 d |
15m | 221 | 93 d |
1h | 221 | 366 d |
4h | 209 | 1830 d |
1d | 10296 | 1830 d |
Observaciones ausentes y cruces
Los cruces históricos requieren cierres reales del mismo intervalo UTC, separados como máximo 5 segundos. effective_at conserva la observación más antigua. No se rellenan huecos y el intervalo abierto puede cambiar. 1d usa referencias diarias de todo el catálogo. La tabla cuenta pares únicos; se admiten ambos sentidos.
Una ventana admitida sin observaciones devuelve HTTP 200 con data: [], has_more: false y next_cursor: null. Un intervalo desconocido devuelve unsupported_interval; un par fuera de cobertura, unsupported_pair_interval y rejected_pairs (HTTP 400). Las solicitudes mixtas se rechazan completas.
Cobertura y límites detalladosAPI de tipos de cambio por WebSocket
Autenticación y uso comercial
Plus: 1h y 4h durante 30 días. Pro: 1m durante los últimos 30 días, y de 5m a 4h con historial completo. Ambos requieren una clave.
Los endpoints de datos aceptan evaluación anónima: 10 solicitudes por minuto y 100 por hora e IP. Una clave aplica la cuota mensual de tu cuenta. Los precios de Free llegan con 15 minutos de retraso (cabecera X-Price-Delay-Seconds: 900).
| Plan | Solicitudes al mes | Uso comercial |
|---|---|---|
| Free | 5,000 | Mostrar con crédito enlazado |
| Basic | 100,000 | Sí |
| Plus | 300,000 | Sí |
| Pro | 1,000,000 | Sí |