invertironline.com

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