DOC-003: Glosario de opciones y volatilidad
Estado
Accepted — 2026-09-08
Producto: IVPrior · Visión: DOC-001 · SaaS B2C: DOC-002
Glosario operativo (agentes/código): .cursor/rules/seed-domain.mdc
Este documento explica en lenguaje claro los términos que aparecen en el nombre del producto, en apps/cli/main.py / apps/cli/options.py y en el resto de la documentación. No es consejo financiero.
1. Por qué existe este doc
La marca IVPrior usa la sigla IV. Quien lea visión, UI o código debe poder responder sin ambigüedad:
Si un término nuevo entra al producto, actualizar este DOC y seed-domain.mdc en el mismo cambio.
2. Volatilidad (núcleo de IVPrior)
| Sigla | Inglés (código) | Español | Definición en una frase |
|---|---|---|---|
| IV | Implied Volatility | Volatilidad implícita | Lo “cara o barata” que el mercado cotiza la opción; está embebida en el precio de la prima. |
| HV | Historical Volatility | Volatilidad histórica | Qué tanto se movió de verdad el precio del activo en el pasado reciente (se calcula desde precios). |
| — | IV rank / IV regime | Rango o régimen de IV | Clasificación de si la IV actual está alta, baja o neutra respecto a un referente (p. ej. HV o historial de IV). |
2.1 IV — volatilidad implícita
- No es una predicción mágica del futuro: es lo que el precio de la opción implica sobre incertidumbre futura.
- IV alta → primas caras → en la lógica actual del CLI suele favorecer vender prima (cobrar theta).
- IV baja → primas baratas → suele favorecer comprar opciones (call/put o débitos).
- Fuente: cadena de opciones del proveedor (Yahoo, Tradier, Tastytrade, …). Yahoo gratis suele ser poco fiable (sobre todo con mercado cerrado); documentar siempre la fuente.
2.2 HV — volatilidad histórica
- Se calcula desde la serie de precios (en el CLI: tipicamente ventana ~20 días de trading, anualizada).
- Sirve de vara de comparación cuando no hay IV histórica buena y barata.
- En
apps/cli/options.py: se usa el ratio aproximadoIV_actual / HVpara hablar de primas caras vs baratas (umbrales orientativos del código, no ley universal).
2.3 Ratio IV / HV (orientativo)
| Situación (heurística del CLI) | Lectura informal |
|---|---|
| Ratio ≳ 1.2 | Primas caras vs movimiento histórico reciente |
| Ratio ≲ 0.9 | Primas baratas |
| Entre medio | Régimen neutro / sin sesgo claro de prima |
Estos umbrales son del motor actual; si cambian, actualizar este DOC y los tests.
2.4 Régimen de IV (IvRegime)
Clasificación de producto: cara · barata · neutra (nombres exactos en código pueden variar; el concepto es este).
Junto con la dirección de la señal (alcista / bajista / neutral) determina la sugerencia de estrategia (comprar vs vender prima, tipo de spread, etc.).
3. Instrumentos y cadena
| Término | Definición |
|---|---|
| Underlying / spot | Activo subyacente y su precio actual. |
| Call | Opción de compra (derecho a comprar el subyacente al strike). |
| Put | Opción de venta (derecho a vender al strike). |
| Strike | Precio de ejercicio del contrato. |
| Expiration / DTE | Fecha de vencimiento / days to expiration. El CLI apunta ~35 días y evita menos de 7 días. |
| Premium / prima | Precio que se paga o cobra por el contrato (mid ≈ (bid+ask)/2 cuando hay mercado). |
| Bid / Ask / Mid | Compra, venta y punto medio; spread bid-ask ancho = mala liquidez. |
| Open interest (OI) | Contratos abiertos; filtro de liquidez en el CLI (p. ej. OI ≥ 100). |
| Volume | Contratos negociados en la sesión; se resetea; el CLI no lo usa como filtro duro fuera de horario. |
| Option chain | Tabla de calls/puts por strikes y vencimientos. |
| ATM / ITM / OTM | At / in / out of the money respecto al spot. |
| Leg / pata | Una pierna de un spread (short o long). |
| Spread | Estrategia de dos (o más) patas; strikes distintos y orden correcto. |
| Credit / debit | Se cobra prima neta (crédito) o se paga (débito). |
| Delta | Sensibilidad al precio del subyacente; a veces se usa para elegir strikes por probabilidad. |
| Theta | Decaimiento de la prima con el paso del tiempo (a favor del vendedor de prima). |
| Vega | Sensibilidad de la prima a cambios de IV. |
| Prob ITM | Probabilidad aproximada (modelo) de terminar in-the-money; en el CLI vía Black-Scholes simplificado — orientativa. |
4. Señales y producto IVPrior
| Término | Definición | No confundir con |
|---|---|---|
| Signal | Lectura direccional del análisis (alcista / bajista / neutral). | Orden en el broker |
| Opportunity | Ticker + señal + contexto (régimen IV, earnings, score) que pasa filtros. | “Pick garantizado” |
| StrategySuggestion | Tipo de jugada que encaja (ej. credit put spread). | Ejecución automática |
| Watchlist | Lista corta diaria del usuario. | Universo completo |
| Universe | Lista amplia para escaneos. | Watchlist |
| Backtest | Probar reglas en histórico. | Rentabilidad futura asegurada |
| Screener | Filtro por fundamentales (barata/buena). | Señal de opciones |
| Paper diary | Registro CSV de ideas para seguimiento. | Cuenta real del broker |
5. Reglas de redacción (copy y docs)
- La primera vez que aparezca IV en un doc de producto o UI visible: escribir IV (Implied Volatility / volatilidad implícita) y enlazar este DOC.
- No usar IV como sinónimo de “señal de compra”.
- No afirmar que una IV alta/baja “garantiza” ganancia.
- Preferir “herramienta de investigación / priorización” frente a “consejos de inversión”.
6. Referencias de implementación
apps/cli/options.py— ratio IV/HV, liquidez, sugerencias de estrategia, Black-Scholes approx.apps/cli/main.py— modos CLI (--opciones,--oportunidades, …) y banner de fuente de datos.- Glosario corto para agentes:
.cursor/rules/seed-domain.mdc
Historial
| Fecha | Cambio |
|---|---|
| 2026-09-08 | Creación al cerrar naming IVPrior; documentar IV/HV y vocabulario base. |