{"openapi":"3.1.0","info":{"title":"Índices AR API","version":"0.1.0","description":"Índices económicos argentinos (UVA, CER, ICL, inflación, dólar histórico, días hábiles) y ajustes de montos para agentes de IA. Cobro por créditos prepagos. También disponible como servidor MCP remoto en /mcp."},"servers":[{"url":"https://indices-ar-api-103907796853.us-east1.run.app"}],"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","description":"API key con prefijo ak_"}}},"security":[{"apiKey":[]}],"paths":{"/v1/keys":{"post":{"operationId":"crearKeyDePrueba","summary":"Crear una API key de prueba con 50 créditos (sin registro)","security":[],"requestBody":{"required":false,"content":{"application/json":{"schema":{"type":"object","properties":{"name":{"type":"string"}}}}}},"responses":{"201":{"description":"Key creada. El campo `key` se muestra una sola vez.","content":{"application/json":{"schema":{"type":"object","properties":{"key":{"type":"string"},"key_id":{"type":"string"},"credits":{"type":"integer"}}}}}},"429":{"description":"Demasiadas keys creadas desde esta IP","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/balance":{"get":{"operationId":"consultarSaldo","summary":"Saldo de créditos y últimos movimientos de la key","responses":{"200":{"description":"Saldo","content":{"application/json":{"schema":{"type":"object","properties":{"key_id":{"type":"string"},"credits":{"type":"integer"},"recent":{"type":"array","items":{"type":"object"}}}}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/packs":{"get":{"operationId":"listarPacks","summary":"Packs de créditos a la venta (producto, créditos, precio)","security":[],"responses":{"200":{"description":"Packs","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/checkout":{"post":{"operationId":"crearCheckout","summary":"Crea un checkout de Polar para recargar la key autenticada y devuelve checkout_url para mostrar al usuario","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"credits":{"type":"integer","description":"Cantidad deseada; se elige el pack más chico que la cubre"},"product_id":{"type":"string","description":"Pack puntual, de /v1/packs"},"email":{"type":"string","description":"Email del comprador, para precargar el checkout"}}}}}},"responses":{"201":{"description":"Checkout creado","content":{"application/json":{"schema":{"type":"object","properties":{"checkout_url":{"type":"string"},"expires_at":{"type":"string"},"pack":{"type":"object"}}}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"503":{"description":"Compra no habilitada","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/tools":{"get":{"operationId":"listarTools","summary":"Lista las tools disponibles con su costo en créditos","security":[],"responses":{"200":{"description":"Tools","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/v1/tools/indice_valor":{"post":{"operationId":"indice_valor","summary":"Valor de un índice (UVA, CER, ICL, inflación)","description":"Devuelve el valor de un índice económico argentino en una fecha (o el último publicado): UVA, CER, ICL (Índice para Contratos de Locación), inflación mensual o interanual (IPC). Fuente: BCRA.\n\nCosto: 1 crédito(s) por llamada exitosa.","x-credits-cost":1,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"indice":{"type":"string","enum":["uva","cer","icl","ipc_mensual","ipc_interanual"],"description":"uva | cer | icl | ipc_mensual | ipc_interanual"},"fecha":{"description":"YYYY-MM-DD. Si se omite, el último valor publicado.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["indice"]},"example":{"indice":"uva"}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object"},"credits":{"type":"object","properties":{"cost":{"type":"integer"},"balance":{"type":"integer"}}}}}}}},"400":{"description":"Input inválido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"402":{"description":"Créditos insuficientes. Incluye `checkout_url` para recargar.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"502":{"description":"Falló un proveedor externo. No se cobra.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/tools/ajustar_monto":{"post":{"operationId":"ajustar_monto","summary":"Ajustar un monto por índice","description":"Actualiza un monto en pesos entre dos fechas según UVA, CER, ICL o inflación (IPC). Devuelve el monto ajustado, el factor y la variación porcentual. Para IPC compone la inflación mensual de los meses posteriores al mes inicial hasta el mes final inclusive.\n\nCosto: 2 crédito(s) por llamada exitosa.","x-credits-cost":2,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"monto":{"type":"number","minimum":0,"exclusiveMinimum":true,"description":"Monto original en pesos"},"indice":{"type":"string","enum":["uva","cer","icl","ipc"]},"desde":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Fecha del monto original, YYYY-MM-DD"},"hasta":{"description":"Fecha destino, YYYY-MM-DD. Por defecto hoy.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["monto","indice","desde"]},"example":{"monto":100000,"indice":"ipc","desde":"2024-01-15","hasta":"2025-01-15"}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object"},"credits":{"type":"object","properties":{"cost":{"type":"integer"},"balance":{"type":"integer"}}}}}}}},"400":{"description":"Input inválido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"402":{"description":"Créditos insuficientes. Incluye `checkout_url` para recargar.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"502":{"description":"Falló un proveedor externo. No se cobra.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/tools/actualizar_alquiler":{"post":{"operationId":"actualizar_alquiler","summary":"Actualizar un alquiler por ICL, IPC o UVA","description":"Calcula el cronograma de actualizaciones de un alquiler: a partir del monto inicial, la fecha de inicio, el índice (ICL, IPC o UVA) y cada cuántos meses se ajusta, devuelve el monto vigente en cada período hasta la fecha de consulta y el próximo ajuste. Cada período se ajusta por la variación del índice entre el inicio del período anterior y el inicio del nuevo.\n\nCosto: 3 crédito(s) por llamada exitosa.","x-credits-cost":3,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"monto_inicial":{"type":"number","minimum":0,"exclusiveMinimum":true,"description":"Alquiler del primer mes, en pesos"},"fecha_inicio":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"Inicio del contrato, YYYY-MM-DD"},"indice":{"default":"icl","type":"string","enum":["icl","ipc","uva"]},"periodicidad_meses":{"default":3,"description":"Cada cuántos meses se actualiza (3, 4, 6, 12)","type":"integer","minimum":1,"maximum":12},"fecha_consulta":{"description":"Hasta qué fecha calcular. Por defecto hoy.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["monto_inicial","fecha_inicio"]},"example":{"monto_inicial":500000,"fecha_inicio":"2025-01-01","indice":"icl","periodicidad_meses":3}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object"},"credits":{"type":"object","properties":{"cost":{"type":"integer"},"balance":{"type":"integer"}}}}}}}},"400":{"description":"Input inválido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"402":{"description":"Créditos insuficientes. Incluye `checkout_url` para recargar.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"502":{"description":"Falló un proveedor externo. No se cobra.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/tools/convertir_uva":{"post":{"operationId":"convertir_uva","summary":"Convertir pesos a UVA o UVA a pesos","description":"Convierte un monto entre pesos y UVA usando el valor de la UVA en una fecha (por defecto hoy). Útil para créditos hipotecarios, plazos fijos UVA y contratos.\n\nCosto: 1 crédito(s) por llamada exitosa.","x-credits-cost":1,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"monto":{"type":"number","minimum":0,"exclusiveMinimum":true},"direccion":{"type":"string","enum":["pesos_a_uva","uva_a_pesos"]},"fecha":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"required":["monto","direccion"]},"example":{"monto":1000000,"direccion":"pesos_a_uva"}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object"},"credits":{"type":"object","properties":{"cost":{"type":"integer"},"balance":{"type":"integer"}}}}}}}},"400":{"description":"Input inválido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"402":{"description":"Créditos insuficientes. Incluye `checkout_url` para recargar.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"502":{"description":"Falló un proveedor externo. No se cobra.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/tools/dolar_historico":{"post":{"operationId":"dolar_historico","summary":"Cotización histórica del dólar","description":"Cotización compra/venta del dólar en Argentina en una fecha pasada, para una casa: oficial, blue, bolsa (MEP), contadoconliqui, mayorista, cripto o tarjeta.\n\nCosto: 1 crédito(s) por llamada exitosa.","x-credits-cost":1,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"casa":{"type":"string","enum":["oficial","blue","bolsa","contadoconliqui","mayorista","cripto","tarjeta"]},"fecha":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$","description":"YYYY-MM-DD"}},"required":["casa","fecha"]},"example":{"casa":"blue","fecha":"2024-01-15"}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object"},"credits":{"type":"object","properties":{"cost":{"type":"integer"},"balance":{"type":"integer"}}}}}}}},"400":{"description":"Input inválido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"402":{"description":"Créditos insuficientes. Incluye `checkout_url` para recargar.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"502":{"description":"Falló un proveedor externo. No se cobra.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/tools/dias_habiles":{"post":{"operationId":"dias_habiles","summary":"Días hábiles y vencimientos","description":"Cuenta los días hábiles (lunes a viernes sin feriados nacionales) entre dos fechas, o suma N días hábiles a una fecha para calcular un vencimiento. Devuelve también los feriados que caen en el rango.\n\nCosto: 1 crédito(s) por llamada exitosa.","x-credits-cost":1,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"desde":{"description":"Fecha inicial, YYYY-MM-DD. Por defecto hoy.","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"hasta":{"description":"Fecha final (inclusive) para contar días hábiles","type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"sumar_dias_habiles":{"description":"Alternativa: cuántos días hábiles sumar a `desde`","type":"integer","minimum":1,"maximum":365}}},"example":{"desde":"2026-12-20","sumar_dias_habiles":10}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object"},"credits":{"type":"object","properties":{"cost":{"type":"integer"},"balance":{"type":"integer"}}}}}}}},"400":{"description":"Input inválido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"402":{"description":"Créditos insuficientes. Incluye `checkout_url` para recargar.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"502":{"description":"Falló un proveedor externo. No se cobra.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}},"/v1/tools/ejecutar":{"post":{"operationId":"ejecutar","summary":"Ejecutar código contra la API (Code Mode)","description":"Corre JavaScript en un sandbox con un objeto `api` ya autenticado: una función async por tool, mismos parámetros y mismo resultado que llamarla directo. Ideal para lotes (validar 50 CBUs, armar 20 cronogramas) o para encadenar llamadas sin volver al modelo. El código puede usar await, console.log y return; el valor retornado vuelve en `resultado`. Costo: 1 crédito por ejecución + la suma de las llamadas internas. Máximo 100 llamadas y 15 s. Sin acceso a red, archivos ni módulos.\n\nFunciones disponibles:\napi.indiceValor({\"indice\":\"uva\"}) → 1 crédito(s): Valor de un índice (UVA, CER, ICL, inflación)\napi.ajustarMonto({\"monto\":100000,\"indice\":\"ipc\",\"desde\":\"2024-01-15\",\"hasta\":\"2025-01-15\"}) → 2 crédito(s): Ajustar un monto por índice\napi.actualizarAlquiler({\"monto_inicial\":500000,\"fecha_inicio\":\"2025-01-01\",\"indice\":\"icl\",\"periodicidad_meses\":3}) → 3 crédito(s): Actualizar un alquiler por ICL, IPC o UVA\napi.convertirUva({\"monto\":1000000,\"direccion\":\"pesos_a_uva\"}) → 1 crédito(s): Convertir pesos a UVA o UVA a pesos\napi.dolarHistorico({\"casa\":\"blue\",\"fecha\":\"2024-01-15\"}) → 1 crédito(s): Cotización histórica del dólar\napi.diasHabiles({\"desde\":\"2026-12-20\",\"sumar_dias_habiles\":10}) → 1 crédito(s): Días hábiles y vencimientos\n\nCosto: 1 crédito(s) por llamada exitosa.","x-credits-cost":1,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"codigo":{"type":"string","minLength":1,"maxLength":20000,"description":"JavaScript. Ej: const r = await api.validarCuit({cuit:'20-12345678-6'}); return r.valido;"},"timeout_ms":{"default":5000,"description":"Tiempo máximo total en milisegundos","type":"integer","minimum":100,"maximum":15000}},"required":["codigo"]},"example":{"codigo":"const cuits = ['20-12345678-6','30-50001091-2'];\nconst r = [];\nfor (const c of cuits) r.push(await api.validarCuit({ cuit: c }));\nreturn r.filter(x => x.valido).map(x => x.formateado);"}}}},"responses":{"200":{"description":"Resultado","content":{"application/json":{"schema":{"type":"object","properties":{"result":{"type":"object"},"credits":{"type":"object","properties":{"cost":{"type":"integer"},"balance":{"type":"integer"}}}}}}}},"400":{"description":"Input inválido","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"401":{"description":"Key faltante o inválida","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"402":{"description":"Créditos insuficientes. Incluye `checkout_url` para recargar.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}},"502":{"description":"Falló un proveedor externo. No se cobra.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"},"message":{"type":"string"}},"required":["error","message"],"additionalProperties":true}}}}}}}}}