Pourquoi c'est la priorité absolue
"Tu trades des options. IV Rank, term structure, skew sont les paramètres fondamentaux de valorisation d'une option. Sans eux, une bonne thèse géopolitique peut quand même produire un mauvais trade : si l'IV est déjà au 95e percentile, tu paies 3× trop cher pour la convexité." — Audit expert
Livrables
- Endpoint
GET /api/options/iv/{ticker} retournant IV actuelle, IV Rank, IV Percentile (52 semaines)
- Service
iv_engine.py : récupère les options chains yfinance, calcule IV par Black-Scholes inverse (ou utilise la mid-price des ATM options)
- Table DB
iv_history : stockage journalier de l'IV par underlying (pour calculer Rank/Percentile)
- Affichage dans Journal de Bord : badge "IV Rank 78%" coloré (vert <25%, orange 25–75%, rouge >75%)
- Affichage dans Cockpit : section "Options Atmosphere" avec IV des actifs clés
Pourquoi ces choix
- IV Rank = (IV actuelle − IV min 52s) / (IV max 52s − IV min 52s) → signal cheap/cher universel
- IV Percentile = % jours où IV était inférieure → plus robuste aux pics extrêmes
- yfinance donne accès aux options chains gratuitement sur les actions US et ETFs
- Stockage journalier nécessaire : sans historique, pas de Rank/Percentile
Contraintes
- yfinance : données options limitées aux actions US/ETF (pas les futures)
- Calcul BS inverse peut être instable sur les options très OTM — utiliser uniquement les ATM proches
Livrables
- Term structure : IV à 30j, 60j, 90j, 180j — affiché comme courbe dans une nouvelle page "Options Lab"
- Indicateur contango/backwardation :
structure = "contango" | "backwardation" | "flat"
- Put/Call skew : IV put 25-delta − IV call 25-delta (proxy de protection de marché)
- Injection dans le prompt de scoring : "IV Rank=78%, structure=backwardation, skew=+4pts → IV élevée, marché achète des puts"
- Règle dans le prompt : si IV Rank > 80%, pénaliser les stratégies acheteuses de vol (long straddle, long call)
Pourquoi ces choix
- Contango (IV court terme < long terme) = marché calme, bon pour vendre de la vol courte
- Backwardation (IV court terme > long terme) = stress, bon pour acheter de la protection courte
- Skew positif (puts plus chers que calls) = marché se protège → biais baissier implicite
- Injecter dans le scoring change concrètement les recommandations de stratégie d'option
Lié à
- Sprint 1.1 (infrastructure IV)
- Modifie le prompt de scoring (étape 4 du cycle)
Livrables
- Calcul du Put/Call Open Interest Ratio par underlying (via yfinance options chains)
- Détection des strikes avec OI inhabituel (OI > 2σ de la moyenne sur 20j)
- Indicateur "Dealer Gamma" simplifié : net gamma des market makers estimé depuis l'OI puts/calls ATM
- Signal injecté dans le prompt : "OI puts/calls = 1.8 → smart money défensif" ou "gros OI call sur strike 550 → mur de résistance potentiel"
Pourquoi ces choix
- Options flow = ce que font réellement les institutionnels, pas ce qu'ils disent
- Gamma exposure élevée des dealers → ils vont hedger → amortit les mouvements de prix
- yfinance permet d'accéder à l'OI sans abonnement premium (limité aux US)
Contraintes
- Gamma dealer exact nécessite des données tick-by-tick (abonnement SpotGamma ~$50/mois si souhaité plus tard)
- Proxy OI est une approximation — le labeler "estimation" dans l'UI