# API de datos UY/AR

> Datos oficiales de Uruguay y Argentina (BCU, Jefatura de Gabinete, DGI) con pago por llamada vía x402 (USDC en Base, red eip155:8453). Sin cuentas ni API keys: el servidor responde 402 con el precio, el cliente firma el pago con su wallet y reintenta.

- OpenAPI: https://datosuyar.dev/openapi.json
- Demos gratis (sin wallet): https://datosuyar.dev/try/uy/ui · https://datosuyar.dev/try/uy/cotizaciones · https://datosuyar.dev/try/ar/feriados/proximo · https://datosuyar.dev/try/uy/feriados/proximo · https://datosuyar.dev/try/feriados/hoy · https://datosuyar.dev/try/ar/uva · https://datosuyar.dev/try/ar/dolar · https://datosuyar.dev/try/uy/rut?rut=211003420017 · https://datosuyar.dev/try/ar/cuit?cuit=20-12345678-6
- Formato de respuesta: { data, source: { name, url, fetchedAt }, cached }
- MCP (Streamable HTTP): https://datosuyar.dev/mcp — gratis, 30 llamadas/día por cliente (header X-Client-Id o IP). Tools: uy_ui, uy_ui_historico, uy_ui_convertir, uy_cotizaciones, ar_feriados, ar_feriado_proximo, uy_feriados, uy_feriado_proximo, es_feriado, dias_habiles, uy_rut, ar_cuit, ar_uva, ar_uva_convertir, ar_dolar, ar_cer, ar_inflacion, ar_tasas, cuota. Ej: claude mcp add --transport http datos-uy-ar https://datosuyar.dev/mcp

## Cuándo usar esta API

Usala cuando necesites, con valor oficial y por fecha: la Unidad Indexada uruguaya o la UVA/CER argentinas (contratos, alquileres, créditos indexados), cotizaciones del BCU y del BCRA (tipo de cambio oficial), inflación argentina, tasas del BCRA, feriados y días hábiles de ambos países (plazos, vencimientos, logística) o validar un RUT uruguayo o CUIT argentino antes de facturar. Preferí las respuestas calculadas (dias-habiles, convertir, feriados/hoy) cuando la pregunta es concreta: ahorran llamadas y tokens. No la uses para cotizaciones de mercado intradía ni para confirmar que un RUT existe en DGI (solo valida formato y dígito).
Cómo llamarla: GET/POST normales; si no pagás, recibís 402 con el precio; con un cliente x402 el pago es automático. Para probar sin pagar: /try/*. Para agentes: el MCP de abajo.

## Versionado y estabilidad

Versión actual: 1 (header X-API-Version en cada respuesta). Los campos existentes no cambian de nombre ni de tipo; se agregan campos nuevos sin aviso. Un cambio incompatible saldría bajo /v2 con al menos 90 días de convivencia y header Deprecation/Sunset en /v1.
Esta página y la raíz responden Markdown con Accept: text/markdown, HTML a navegadores y JSON al resto.

## Endpoints pagos

- GET https://datosuyar.dev/uy/ui?fecha=YYYY-MM-DD — $0.002 — Unidad Indexada (BCU, código 9800). Default: hoy. La UI existe todos los días y se publica ~1 mes adelante.
- GET https://datosuyar.dev/uy/ui/historico?desde=YYYY-MM-DD&hasta=YYYY-MM-DD — $0.005 — Serie diaria de UI, máximo 366 días.
- GET https://datosuyar.dev/uy/cotizaciones?moneda=USD,EUR&fecha=YYYY-MM-DD — $0.003 — Cotizaciones BCU (compra/venta en UYU). Sin fecha: último cierre. Monedas: UI, UP, UR, USD, USD_CABLE, USD_INTERBANCARIO, EUR, ARS, ARS_INTERBANCARIO, BRL, BRL_INTERBANCARIO, CLP, PYG, GBP, JPY, CHF, MXN, COP, PEN, CNY.
- GET https://datosuyar.dev/ar/feriados/{anio}?tipo=&mes= — $0.002 — Feriados nacionales de Argentina. Años disponibles: 2025, 2026. Tipos: inamovible, trasladable, no_laborable (comunidades religiosas), turistico (puentes), especial.
- GET https://datosuyar.dev/ar/feriados/proximo?desde=YYYY-MM-DD — $0.002 — Próximo feriado y días restantes.
- GET https://datosuyar.dev/uy/feriados/{anio}?tipo=&mes= — $0.002 — Feriados nacionales de Uruguay calculados desde la Ley 16.805: traslados al lunes del 19/4, 18/5 y 12/10, Carnaval, Semana de Turismo. tipo: pago (no laborable) o laborable. Cualquier año desde 1997.
- GET https://datosuyar.dev/uy/feriados/proximo?desde=YYYY-MM-DD — $0.002 — Próximo feriado uruguayo y días restantes.
- POST https://datosuyar.dev/uy/rut  body {"rut":"21-100342-001-7"} — $0.001 — Valida formato y dígito verificador del RUT. No consulta a DGI (no confirma existencia ni vigencia).
- POST https://datosuyar.dev/ar/cuit  body {"cuit":"20-12345678-6"} — $0.001 — Valida formato y dígito verificador de CUIT/CUIL. No consulta a AFIP/ARCA.

## Respuestas calculadas (una llamada, respuesta final)

- GET https://datosuyar.dev/uy/feriados/hoy?fecha= y https://datosuyar.dev/ar/feriados/hoy?fecha= — $0.001 — ¿Es feriado? ¿Es día hábil? Por qué.
- GET https://datosuyar.dev/uy/dias-habiles?desde=&hasta= y https://datosuyar.dev/ar/dias-habiles — $0.003 — Días hábiles entre fechas (descuenta fines de semana y feriados). Con sumar=N en vez de hasta: fecha resultante de sumar N días hábiles (negativo resta).
- GET https://datosuyar.dev/feriados/proximos?n=5&pais=uy,ar&desde= — $0.002 — Próximos N feriados de ambos países, ordenados.
- GET https://datosuyar.dev/uy/ui/convertir?monto=&de=UI|UYU&fecha= — $0.002 — Convierte entre UI y pesos uruguayos.
- GET https://datosuyar.dev/ar/uva/convertir?monto=&de=UVA|ARS&fecha= — $0.002 — Convierte entre UVA y pesos argentinos.
- POST https://datosuyar.dev/batch  body {"requests":[{"method":"GET","path":"/uy/ui"},{"method":"POST","path":"/uy/rut","body":{"rut":"..."}}]} — $0.010 — Hasta 10 consultas a rutas de datos en una llamada y un solo pago.
- Parámetro compact=1 en /uy/cotizaciones, /uy/feriados/{anio} y /ar/feriados/{anio}: respuesta mínima (menos tokens).

## Argentina: BCRA

- GET https://datosuyar.dev/ar/uva?fecha= — $0.002 — UVA del día (diaria, incluye fines de semana).
- GET https://datosuyar.dev/ar/uva/historico?desde=&hasta= — $0.005 — Serie diaria de UVA, máx. 366 días.
- GET https://datosuyar.dev/ar/cer?fecha= — $0.002 — CER del día.
- GET https://datosuyar.dev/ar/dolar?fecha= — $0.002 — Dólar oficial: mayorista (Com. A 3500) y minorista promedio vendedor. Días hábiles; con fecha no hábil devuelve el último anterior.
- GET https://datosuyar.dev/ar/inflacion?meses=12 — $0.003 — Inflación mensual e interanual del IPC (INDEC vía BCRA).
- GET https://datosuyar.dev/ar/tasas — $0.003 — Política monetaria, BADLAR y TAMAR vigentes.

## Cómo pagar (x402)

1. Hacé la request normal. Si no hay pago, respondé 402 con header PAYMENT-REQUIRED (precio, red, wallet destino, asset USDC).
2. Firmá la autorización con una wallet que tenga USDC en eip155:8453 y reintentá con header PAYMENT-SIGNATURE.
3. Clientes listos: @x402/fetch (JS), x402 (Python), o cualquier agente compatible con x402.

## Fuentes

- BCU: https://cotizaciones.bcu.gub.uy/wscotizaciones/servlet/awsbcucotizaciones (SOAP público)
- Feriados AR: https://www.argentina.gob.ar/sites/default/files/holidays-{anio}-es.json (CC BY 4.0, dataset feriados-nacionales en datos.gob.ar)
- RUT: algoritmo oficial de dígito verificador (DGI), validación local