La API de Tipo de Cambio
Si estás construyendo algo y te sirven nuestros datos, están abiertos. Puedes leer las series del dólar (TRM) y de los TES, y el catálogo de lo que publicamos, en JSON. Sin registrarte, sin llave y con CORS: llámala desde tu servidor o desde el navegador.
Lo esencial
- Base:
https://tipodecambio.co/api/v1 - Solo lectura (métodos
GET) y siempre JSON. - Abierta y con CORS (
Access-Control-Allow-Origin: *). No hay llaves ni cuentas. - Fechas en epoch Unix (segundos), tanto en los filtros como en las respuestas.
- Versionada: hoy es
v1. Si algo cambia de forma incompatible, será en otra versión;v1se mantiene.
Endpoints
| Método | Ruta | Qué devuelve |
|---|---|---|
| GET | /api/v1/meta | Qué ofrece la API y dónde está cada cosa. |
| GET | /api/v1/health | Latido del servicio. |
| GET | /api/v1/sections | Secciones de la región. |
| GET | /api/v1/tags | Temas con su conteo de artículos. |
| GET | /api/v1/articles | Artículos publicados (metadatos + resumen). |
| GET | /api/v1/articles/{slug} | Un artículo, con sus fuentes y preguntas. |
| GET | /api/v1/tes | Series TES cero cupón del Banco de la República. |
| GET | /api/v1/trm | TRM: el precio oficial del dólar. |
El contrato completo, campo por campo, está en formato OpenAPI: /api/v1/openapi.json.
Regiones
El contenido cambia según el país (moneda, ejemplos, instituciones). Elige la edición con
?region= — hoy co y us . Si lo omites, usamos la región por defecto (co).
Filtros de fecha (TES y TRM)
Filtra por rango con from y to (ambos epoch Unix, inclusivos), o
por un solo día con date (atajo de from=to; no se combina con
ellos). Sin filtro, obtienes toda la historia. Las fechas se interpretan en UTC, y cada
punto de la serie vuelve como [epoch, valor].
Ejemplos
# El precio del dólar (TRM), toda la historia
curl "https://tipodecambio.co/api/v1/trm"
# Series TES a 1, 5 y 10 años desde el 2026-01-01 (epoch 1767225600)
curl "https://tipodecambio.co/api/v1/tes?series=pesos_1a,pesos_5a,pesos_10a&from=1767225600"
# La TRM de un solo día (2026-03-16)
curl "https://tipodecambio.co/api/v1/trm?date=1773619200"
# Últimos 10 artículos de la edición de EE. UU.
curl "https://tipodecambio.co/api/v1/articles?region=us&limit=10"
# Un artículo por su slug, con fuentes y preguntas
curl "https://tipodecambio.co/api/v1/articles/mi-articulo"Sobre los artículos
La API entrega los metadatos y el resumen de cada nota (título, sección,
temas, el TLDR de "qué pasó / cómo te afecta", fuentes con su peso real). El
texto completo no viaja en JSON: nuestras notas llevan gráficas y
componentes que son código, no datos. Por eso cada artículo trae su url —
ahí está la pieza completa. Los borradores nunca aparecen.
Caché y uso justo
Las respuestas traen Cache-Control: los datos de mercado se refrescan una vez
al día; el contenido, cuando publicamos. Respeta esos tiempos y no repitas llamadas de más.
Es de uso libre y educativo; si publicas algo con estos datos, agradecemos que cites a Tipo de Cambio. Los datos de mercado son de referencia, con
retraso, y no constituyen asesoría.
¿Dudas?
Escríbenos a contacto@tipodecambio.co si algo no cuadra o si necesitas un dato que aún no exponemos.