API de cotizaciones de la región

El pedido, y qué no vas a leer acá

El mensaje llegó por correo desde casillas institucionales de UTEC. Publicamos qué se pidió —cobertura de divisas regionales en una API pública— y qué hicimos. No publicamos nombres, direcciones de correo, la carrera, la cátedra ni ningún dato que permita identificar a quienes escribieron: ni acá, ni en el repositorio, ni en el historial de commits. Una casilla de correo es un dato personal en los términos del artículo 4 de la Ley Nº 18.331 y difundirla exige un consentimiento que nadie da al mandar una consulta técnica. El razonamiento completo, con los artículos, está en la página del endpoint intradía, que salió del mismo modo.

Los ocho endpoints

Todos son GET, públicos, sin autenticación, sobre HTTPS y con CORS abierto. Base: https://api.cambio-uruguay.com

Una respuesta de verdad, de hace un rato

Esto no es un ejemplo escrito a mano: es una cotización del tablero de este momento (hace 6 min), servida por el mismo endpoint.

{
  "id": "AR:blue:USDARS",
  "country": "AR",
  "market": "blue",
  "label": "Dólar blue",
  "kind": "parallel",
  "base": "USD",
  "quote": "ARS",
  "buy": 1530,
  "sell": 1550,
  "avg": 1540,
  "spreadPct": 1.3072,
  "high": null,
  "low": null,
  "variationPct": 0,
  "updatedAt": "2026-08-22T22:31:15.000Z",
  "source": "ar_criptoya",
  "sourceUrl": "https://criptoya.com/api/dolar",
  "corroboratedBy": [
    "ar_dolarapi",
    "ar_bluelytics",
    "ar_dolarhoy",
    "ar_ambito"
  ],
  "disagreementPct": 0.4221
}

Qué historia hay, y desde cuándo

Inventario en vivo de GET /regional/series. Las series largas son las que publica el propio emisor; las de un solo día empezaron cuando este tablero salió, porque nadie publica su historia y la estamos construyendo un día por vez.

Hay 40 series más, todas de mercados que ningún tercero publica en forma histórica (Paraguay, Bolivia, el mostrador uruguayo, los cruces). Se pueden listar todas con GET /regional/series.

Las fuentes, y a quién citar

Salvo la fila de Uruguay, ningún dato es nuestro: somos un intermediario que normaliza. Si publicás un número tomado de acá, citá a quien lo publica —el catálogo está en GET /regional/sources y trae la URL de cada original—. Si además nos mencionás, mejor, pero lo importante es lo primero.

Límites, y qué NO garantiza

Tres llamadas para empezar

# El tablero completo de la región
curl -s "https://api.cambio-uruguay.com/regional" | jq '.board[] | {country, oficial: .official.avg}'

# La serie diaria del dólar blue desde 2011
curl -s "https://api.cambio-uruguay.com/regional/history?country=AR&market=blue&base=USD&quote=ARS&from=2011-01-01" \
  | jq '.count, .points[0], .points[-1]'

# Cuántos pesos uruguayos son 10.000 pesos argentinos al blue
curl -s "https://api.cambio-uruguay.com/regional/convert?from=ARS&to=UYU&amount=10000&market=blue" | jq

Para series largas conviene filtrar por country + market + base + quote: sin filtros el endpoint devuelve todas las series mezcladas, que es casi nunca lo que se quiere.