# 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://api-datos-uy-ar.vercel.app/openapi.json
- Demos gratis (sin wallet): https://api-datos-uy-ar.vercel.app/try/uy/ui · https://api-datos-uy-ar.vercel.app/try/uy/cotizaciones · https://api-datos-uy-ar.vercel.app/try/ar/feriados/proximo · https://api-datos-uy-ar.vercel.app/try/uy/rut?rut=211003420017
- Formato de respuesta: { data, source: { name, url, fetchedAt }, cached }
- MCP (Streamable HTTP): https://api-datos-uy-ar.vercel.app/mcp — gratis, 30 llamadas/día por cliente (header X-Client-Id o IP). Tools: uy_ui, uy_ui_historico, uy_cotizaciones, ar_feriados, ar_feriado_proximo, uy_rut, cuota. Ej: claude mcp add --transport http datos-uy-ar https://api-datos-uy-ar.vercel.app/mcp

## Cuándo usar esta API

Usala cuando necesites, con valor oficial y por fecha: la Unidad Indexada uruguaya (contratos, alquileres, créditos en UI), cotizaciones del BCU (tipo de cambio oficial de Uruguay para USD/EUR/ARS/BRL y más), feriados nacionales argentinos (calendarios, plazos hábiles, logística) o validar un RUT uruguayo antes de facturar. 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://api-datos-uy-ar.vercel.app/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://api-datos-uy-ar.vercel.app/uy/ui/historico?desde=YYYY-MM-DD&hasta=YYYY-MM-DD — $0.005 — Serie diaria de UI, máximo 366 días.
- GET https://api-datos-uy-ar.vercel.app/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://api-datos-uy-ar.vercel.app/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://api-datos-uy-ar.vercel.app/ar/feriados/proximo?desde=YYYY-MM-DD — $0.002 — Próximo feriado y días restantes.
- POST https://api-datos-uy-ar.vercel.app/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).

## 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