{"openapi":"3.1.0","info":{"title":"MonedAPI","version":"2.1.0","description":"API REST pública de cotizaciones del mercado cambiario argentino en tiempo real: dólar (Blue, Oficial, BNA, MEP/Bolsa, CCL, Cripto, Tarjeta, Mayorista, Futuro), euro, real, peso chileno, peso uruguayo, e índices argentinos (Riesgo País, CER, UVA). Las lecturas de cotizaciones son públicas y no requieren API key. Real-time exchange rates for the Argentine FX market — public, no API key needed for quotes.","contact":{"name":"Soporte MonedAPI","email":"soporte@monedapi.ar","url":"https://monedapi.ar"},"license":{"name":"Uso público","url":"https://monedapi.ar/docs"}},"servers":[{"url":"https://monedapi.ar","description":"Producción"}],"externalDocs":{"description":"Documentación completa","url":"https://monedapi.ar/docs"},"tags":[{"name":"Cotizaciones v2","description":"API actual (campos en inglés). Recomendada."},{"name":"Cotizaciones v1","description":"API legada (campos en español). Estable."},{"name":"Historial","description":"Series históricas. Requiere API key."}],"paths":{"/api/v2/{currency}":{"get":{"operationId":"getCurrencyQuotes","summary":"Todas las cotizaciones de una moneda","description":"Devuelve un array con las últimas cotizaciones de una moneda, una por cada origen (ej. para `usd`: Blue, Oficial, BNA, MEP, CCL, etc.). Público, sin API key.","tags":["Cotizaciones v2"],"parameters":[{"name":"currency","in":"path","required":true,"description":"Código de la moneda.","schema":{"type":"string","enum":["usd","eur","brl","clp","uyu","arg"]},"example":"usd"}],"responses":{"200":{"description":"Lista de cotizaciones","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyQuote"}}}}}}}},"/api/v2/{currency}/{origin}":{"get":{"operationId":"getCurrencyQuote","summary":"Cotización puntual (moneda + origen)","description":"Devuelve un único objeto con la cotización de una moneda para un origen específico. Ej.: `GET /api/v2/usd/blue` para el dólar blue. Público, sin API key.","tags":["Cotizaciones v2"],"parameters":[{"name":"currency","in":"path","required":true,"description":"Código de la moneda.","schema":{"type":"string","enum":["usd","eur","brl","clp","uyu","arg"]},"example":"usd"},{"name":"origin","in":"path","required":true,"description":"Código del origen/tipo de cotización.","schema":{"type":"string","enum":["oficial","bna","blue","mayorista","bolsa","ccl","cripto","tarjeta","futuro","riesgo","cer","uva"]},"example":"blue"}],"responses":{"200":{"description":"Cotización","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrencyQuote"}}}},"404":{"description":"Cotización no encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v2/{currency}/{origin}/history":{"get":{"operationId":"getCurrencyHistory","summary":"Historial de una cotización","description":"Serie histórica de precios de una cotización. Requiere API key (`Authorization: Bearer <API_KEY>`). Obtené tu clave en https://monedapi.ar/cuenta.","tags":["Historial"],"security":[{"apiKey":[]}],"parameters":[{"name":"currency","in":"path","required":true,"schema":{"type":"string","enum":["usd","eur","brl","clp","uyu","arg"]},"example":"usd"},{"name":"origin","in":"path","required":true,"schema":{"type":"string","enum":["oficial","bna","blue","mayorista","bolsa","ccl","cripto","tarjeta","futuro","riesgo","cer","uva"]},"example":"blue"},{"name":"from","in":"query","required":false,"description":"Fecha desde (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"to","in":"query","required":false,"description":"Fecha hasta (YYYY-MM-DD).","schema":{"type":"string","format":"date"}},{"name":"limit","in":"query","required":false,"description":"Máximo de puntos a devolver (tope 500).","schema":{"type":"integer","default":100,"maximum":500}}],"responses":{"200":{"description":"Serie histórica","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/HistoryPoint"}}}}},"401":{"description":"API key faltante o inválida","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/{currency}":{"get":{"operationId":"getCurrencyQuotesLegacy","summary":"[v1] Todas las cotizaciones de una moneda (campos en español)","description":"Igual que `/api/v2/{currency}` pero con nombres de campo en español. Público.","tags":["Cotizaciones v1"],"parameters":[{"name":"currency","in":"path","required":true,"schema":{"type":"string","enum":["usd","eur","brl","clp","uyu","arg"]},"example":"usd"}],"responses":{"200":{"description":"Lista de cotizaciones (español)","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/CurrencyQuoteLegacy"}}}}}}}},"/api/{currency}/{origin}":{"get":{"operationId":"getCurrencyQuoteLegacy","summary":"[v1] Cotización puntual (campos en español)","description":"Igual que `/api/v2/{currency}/{origin}` pero con campos en español. Público.","tags":["Cotizaciones v1"],"parameters":[{"name":"currency","in":"path","required":true,"schema":{"type":"string","enum":["usd","eur","brl","clp","uyu","arg"]},"example":"usd"},{"name":"origin","in":"path","required":true,"schema":{"type":"string","enum":["oficial","bna","blue","mayorista","bolsa","ccl","cripto","tarjeta","futuro","riesgo","cer","uva"]},"example":"blue"}],"responses":{"200":{"description":"Cotización (español)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CurrencyQuoteLegacy"}}}},"404":{"description":"Cotización no encontrada","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"API key de MonedAPI. Obtenela en https://monedapi.ar/cuenta."}},"schemas":{"CurrencyQuote":{"type":"object","description":"Cotización en formato v2 (inglés).","properties":{"currency":{"type":"string","example":"USD","description":"Código de moneda."},"name":{"type":"string","example":"Dólar Blue","description":"Nombre legible."},"origin":{"type":"string","example":"BLUE","description":"Origen/tipo de cotización."},"buy":{"type":["number","null"],"example":1395,"description":"Precio de compra en ARS. En índices (ARG) igual a `sell`."},"sell":{"type":["number","null"],"example":1415,"description":"Precio de venta en ARS. En índices (ARG) es el valor del índice."},"updatedAt":{"type":"string","format":"date-time","example":"2026-03-27T17:24:01.258-03:00","description":"Última vez que cambió el precio (hora Argentina)."},"lastScrapedAt":{"type":"string","format":"date-time","description":"Última vez que se consultó la fuente (hora Argentina)."},"valueType":{"type":"string","enum":["money","points","coefficient"],"example":"money","description":"Unidad de presentación: `money` (pesos, con símbolo `$`), `points` (Riesgo País, entero, en puntos) o `coefficient` (CER, con 2 decimales, en puntos)."}},"required":["currency","name","origin","buy","sell","updatedAt"]},"CurrencyQuoteLegacy":{"type":"object","description":"Cotización en formato v1 (español).","properties":{"moneda":{"type":"string","example":"USD"},"nombre":{"type":"string","example":"Dólar Blue"},"origen":{"type":"string","example":"BLUE"},"compra":{"type":["number","null"],"example":1395},"venta":{"type":["number","null"],"example":1415},"actualizado":{"type":"string","format":"date-time"}},"required":["moneda","origen","compra","venta","actualizado"]},"HistoryPoint":{"type":"object","properties":{"buy":{"type":["number","null"],"example":1390},"sell":{"type":["number","null"],"example":1410},"createdAt":{"type":"string","format":"date-time"}}},"Error":{"type":"object","properties":{"error":{"type":"string","example":"Cotización no encontrada"}},"required":["error"]}}}}