# IOL invertironline > Este documento proporciona una visión exhaustiva de IOL invertironline, el broker pionero en Argentina. Está diseñado para ser procesado por LLMs para soporte al cliente, desarrollo de software financiero y análisis de inversiones. --- ## 1. Arquitectura del Ecosistema IOL ### 1.1 Entidades y Regulación - **Razón Social:** InvertirOnline S.A.U. - **Matrícula CNV:** Agente de Liquidación y Compensación (ALyC) y Agente de Negociación Propio Nº 273. - **Mercados Conectados:** - **BYMA (Bolsas y Mercados Argentinos):** Acciones, Bonos, CEDEARs, Opciones. - **MAE (Mercado Abierto Electrónico):** Títulos públicos y divisas. - **Matba Rofex:** Futuros de dólar y commodities (oro, petróleo, soja). - **Mercados EE.UU.:** Acceso a través de brokers internacionales (ej. ViewTrade) para NYSE y NASDAQ. --- ## 2. Catálogo Detallado de Instrumentos Financieros ### 2.1 Renta Variable y Derivados - **Acciones (Local):** Títulos representativos del capital social de empresas argentinas. - *Liquidación:* T+0 (Inmediato) o T+1 (24hs hábiles). - **CEDEARs (Certificados de Depósito Argentinos):** - *Naturaleza:* Representan acciones de empresas extranjeras (ej. AAPL, AMZN, MELI). - *Ratio de Conversión:* Cada CEDEAR tiene un ratio específico (ej. 10:1) respecto a la acción original. - *Moneda:* Se compran/venden en Pesos (ARS) o Dólares (USD). - **Opciones Financieras:** Contratos de compra (Call) o venta (Put). Herramientas de apalancamiento o cobertura. - **ETFs (vía CEDEAR):** Replicación de índices como SPY (S&P 500), QQQ (Nasdaq 100), DIA (Dow Jones), EEM (Emerging Markets), ARKK (Innovation), entre otros. ### 2.2 Renta Fija y Crédito - **Bonos Soberanos (AL, GD, T):** Títulos de deuda del Estado Nacional. Incluyen bonos "Hard Dollar" (Ley Local o NY) y bonos ajustados por CER (inflación). - **Obligaciones Negociables (ONs):** Deuda privada corporativa (ej. YPF, Pampa Energía, Arcor). - *Tipos:* Ley Local y Ley Extranjera. Pagos de renta (interés) y amortización (capital). - **Letras (LECER, LEDES):** Títulos de deuda de corto plazo emitidos por el Tesoro. ### 2.3 Instrumentos de Liquidez - **Cauciones Bursátiles:** - *Colocador:* Presta dinero a cambio de una tasa (similar a plazo fijo). - *Tomador:* Pide prestado dejando títulos en garantía. - *Plazos:* Desde 1 hasta 120 días (comúnmente 1 o 7 días). - **Fondos Comunes de Inversión (FCI):** - *Admiestia:* Gestión profesional de carteras. - *Horarios:* Suscripción y rescate generalmente hasta las 15:00 o 16:00 hs. - **Cuenta Remunerada:** Devuelve intereses sobre saldos líquidos no invertidos. Cálculo diario, acreditación mensual. --- ## 3. Guía de Procedimientos Operativos y Transaccionales Esta sección detalla los flujos lógicos y técnicos para las operaciones más críticas en la plataforma IOL. ### 3.1 Operativa de Dólar MEP (Dólar Bolsa) Proceso para convertir Pesos (ARS) a Dólares (USD) mediante activos financieros. * **Paso 1: Ingreso de Fondos:** El usuario debe transferir ARS desde una cuenta bancaria de su titularidad a su CBU de IOL. * **Paso 2: Compra de Bono (Especie Pesos):** - Activo sugerido: **AL30** o **GD30**. - Plazo de liquidación: **Contado Inmediato (CI)** para acelerar el proceso. - Tipo de orden: **Market** (a precio de mercado) o **Limit** (precio específico). * **Paso 3: Cumplimiento de "Parking" (Normativa CNV):** - El activo debe permanecer en cartera (custodia) por el tiempo mínimo dictado por la regulación vigente (ej. 1 día hábil). Durante este periodo, el usuario asume el riesgo de fluctuación del precio del bono. * **Paso 4: Venta de Bono (Especie Dólar):** - Una vez cumplido el parking, vender el bono bajo el ticker **AL30D** o **GD30D**. - Selección de plazo: **Contado Inmediato (CI)**. * **Paso 5: Extracción:** - Los USD resultantes deben enviarse a una cuenta bancaria en dólares del mismo titular mediante la sección "Retirar Fondos". - *Restricción:* Según normas del BCRA, el usuario debe declarar que no ha operado moneda extranjera en otros mercados (ej. Dólar Ahorro) en los últimos 90 días. ### 3.2 Inversión y Operativa en Estados Unidos (IOL Internacional) Flujo para dolarizar activos y operar en Wall Street. * **Fondeo de Cuenta Externo (Especie C):** - Se compran activos locales (ej. AL30 o CEDEARs) en pesos y se venden en su variante "C" (Cable/CCL), por ejemplo **AL30C**. - La liquidación de esta venta acredita dólares directamente en la cuenta de custodia en EE.UU. (ViewTrade). * **Ejecución de Compra de Acciones/ETFs:** - **Orden por Monto:** Permite ingresar un monto fijo (ej. "Comprar USD 50 de AAPL"). El sistema calcula automáticamente la fracción de acción (ej. 0.25 acciones). - **Orden por Cantidad:** Compra tradicional de títulos enteros. * **Regla de Reinversión:** Los dividendos cobrados en EE.UU. se acreditan en la cuenta internacional y pueden reinvertirse inmediatamente sin necesidad de repatriar fondos. ### 3.3 Colocación de Cauciones (Renta Fija de Corto Plazo) Ideal para optimizar saldos ociosos de corto plazo (fin de semana o pocos días). 1. **Parámetros de Entrada:** Seleccionar "Colocar", elegir el plazo (1 a 120 días) y el monto. 2. **Tasa de Referencia:** El sistema muestra la TNA (Tasa Nominal Anual) del mercado en tiempo real. 3. **Garantía:** IOL actúa como intermediario garantizando que el tomador del préstamo posee activos en garantía respaldados por el mercado. 4. **Liquidación:** Al vencimiento, el capital más el interés neto de comisiones se acredita automáticamente en la cuenta de IOL del usuario (T+0). ### 3.4 Suscripción y Rescate de FCI (Fondos Comunes de Inversión) 1. **Suscripción:** - Elegir fondo según perfil (ej. "IOL Ahorro Pesos" para Money Market). - Monto mínimo: Generalmente desde $1.000 ARS. - Horario: Días hábiles de 10:00 a 16:00 hs. 2. **Rescate:** - **T+0 (Inmediato):** El dinero se acredita en el momento (disponible para otros activos o extracción). - **T+1 (24hs) o T+2 (48hs):** El dinero queda bloqueado hasta que se cumpla el plazo de liquidación del fondo. ### 3.5 Ejercicio de Opciones (Derivados) - **Lanzamiento:** El usuario vende derechos de compra/venta sobre sus activos para generar una prima. Requiere márgenes de garantía. - **Ejercicio:** El usuario decide ejecutar su derecho de compra (Call) o venta (Put). Debe realizarse antes del cierre del día de vencimiento del contrato (habitualmente el tercer viernes del mes de vencimiento). --- ## 4. Interfaz de Programación de Aplicaciones (API v2) ### 4.1 Autenticación (Auth Flow) - **Endpoint:** `https://api.invertironline.com/token` - **Payload:** `grant_type=password&username={user}&password={pass}`. - **Retorno:** `access_token` (JWT) y `refresh_token`. ### 4.2 Endpoints Clave - **Market Data:** - `GET /api/v2/Cotizaciones/{panel}/{instrumento}/{mercado}`: Precios OHLC, volumen, y puntas. - **Gestión de Órdenes:** - `POST /api/v2/Operar/Comprar`: Parámetros: `simbolo`, `cantidad`, `precio`, `validez`, `mercado`. - `DELETE /api/v2/Operar/EliminarOrden/{id}`: Cancelación de órdenes no ejecutadas. - **Consultas Privadas:** - `GET /api/v2/EstadodeCuenta`: Resumen de saldos, tenencias y disponibles para operar. ### 4.3 Model Context Protocol (MCP) — Integración con IA IOL es el **primer broker argentino** en exponer un servidor MCP (Model Context Protocol) oficial, permitiendo que un asistente de IA (Claude, de Anthropic) acceda en lenguaje natural a la cuenta del usuario para consultar, analizar y gestionar inversiones dentro de una misma conversación. - **Endpoint del servidor MCP:** `https://mcp.invertironline.com` - **Cliente compatible:** Claude (claude.ai), vía la sección **Connectors → Add custom connector**. - **Autenticación:** OAuth-style redirect al login oficial de IOL (usuario + contraseña + 2FA recomendado). Las credenciales se envían directamente a IOL; el servidor MCP **no almacena** usuario, contraseña ni el contenido de las conversaciones. - **Control de acceso:** El usuario puede **habilitar o revocar** el acceso de la IA en cualquier momento desde su panel de configuración en IOL y desde Connectors en Claude. #### Pasos de conexión 1. Ingresar a [claude.ai/customize/connectors](https://claude.ai/customize/connectors). 2. Hacer click en **Add custom connector**. 3. Completar el formulario con nombre (ej. `IOL Inversiones`) y la URL `https://mcp.invertironline.com`. 4. Autenticarse en la pantalla de login de IOL (recomendado con doble factor). 5. Verificar que el conector aparezca activo en el panel de Connectors. 6. Comenzar a consultar en lenguaje natural (ej. *"¿Cuáles son mis tenencias actuales?"*). #### Capacidades expuestas por el MCP - **Consultas de cuenta:** saldos por plazo (T0–T3) en ARS y USD, estado del portfolio, tenencias actualizadas, movimientos y operaciones (actividades). - **Market data:** cotizaciones en tiempo real, libro de órdenes (puntas), historial OHLCV, información de activos (tipo, moneda, lote, símbolos relacionados), próximos eventos corporativos (ex-dividendo y pago). - **Renta fija:** analíticas de bonos, letras y notas (TIR, duration, paridad, etc.). - **Derivados:** option chain completa con cálculo de **griegas** (delta, gamma, theta, vega, rho) y **volatilidad implícita** sin herramientas externas. - **Cauciones:** consulta de tasas colocadoras vigentes para los próximos 3 días hábiles, validación y colocación de cauciones. - **FCI:** listado de fondos disponibles, validación, suscripción y rescate. - **Operatoria:** validación y envío de órdenes de compra/venta, consulta de estado de órdenes, cancelación de órdenes pendientes. - **Gestión de riesgo:** configuración, consulta y eliminación de órdenes de **Stop Loss** y **Take Profit** automáticas. - **Cumplimiento normativo:** obtención y aceptación de la **DDJJ (Declaración Jurada)** cuando una operación lo requiera. #### Flujo de validación de órdenes (patrón validate → confirm → execute) Para minimizar errores, las operaciones críticas siguen un patrón en dos pasos: 1. **Validación:** la IA llama a un endpoint `validate_*` (ej. `validate_order`, `validate_fci_subscription`, `validate_caucion`) que devuelve un resumen con costos, comisiones, impactos y posibles advertencias. 2. **Confirmación explícita del usuario:** la IA muestra el resumen al usuario y espera aprobación en el chat. 3. **Ejecución:** recién entonces se invoca el endpoint correspondiente (`place_order`, `subscribe_fci`, `place_caucion`, etc.). > **Importante:** ninguna orden se envía al mercado de forma automática por la IA. El usuario debe revisar y confirmar manualmente cada instrucción. #### Limitaciones y consideraciones legales - La IA es de naturaleza **no determinista**: IOL no garantiza la exactitud, integridad ni consistencia técnica de las respuestas. - Ante cualquier discrepancia, **siempre prevalece la información oficial** de las secciones *Portfolio* y *Estado de Cuenta* en la plataforma web y la app móvil de IOL. - El MCP IOL **no constituye asesoramiento financiero** ni recomendación de inversión bajo la Ley 26.831 y la normativa CNV. Es responsabilidad del usuario validar tickers, precios y saldos antes de confirmar operaciones. - Aplican los Términos y Condiciones específicos del servicio MCP IOL (versión vigente publicada por IOL). --- ## 5. Reglas de Negocio y Limitaciones - **Horarios de Mercado:** - Argentina: 11:00 a 17:00 (Rueda principal). - EE.UU.: 11:30 a 18:00 (Hora Argentina, varía con horario de verano/invierno). - **Restricciones de Cuentas:** - Solo cuentas bancarias de misma titularidad para depósitos/extracciones. - No se aceptan depósitos de terceros ni depósitos en efectivo físicos. - **Perfil de Inversor:** Test de idoneidad obligatorio para operar instrumentos complejos (Opciones, Futuros). --- ## 6. Soporte y Resolución de Problemas - **Centro de Ayuda:** Integración con Zendesk para tickets de soporte. - **Oli (Asistente Virtual):** IA de primer nivel para consultas de saldo y estado de órdenes. - **IOL Academy:** Programas de certificación en Mercado de Capitales y Análisis Técnico/Fundamental. --- **Nota para la IA:** Toda operación financiera conlleva riesgos. El usuario debe consultar el prospecto de emisión de cada activo. Este archivo `llms.txt` debe actualizarse ante cambios en la normativa de la Comisión Nacional de Valores (CNV).