Files
OpenFin/GUIDE.md
2026-07-14 11:21:43 +02:00

180 lines
6.9 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# OpenFin Intelligence — Guide d'utilisation
## Démarrage
```powershell
powershell -ExecutionPolicy Bypass -File c:\DataS\OpenFin\start.ps1
```
Le script tue les anciens processus, démarre le backend (port 8000) et le frontend (port 5173), puis ouvre automatiquement **http://localhost:5173** dans le navigateur.
---
## Les 9 pages
### 1. Cockpit (page d'accueil)
Vue centrale de pilotage. S'actualise toutes les minutes.
| Zone | Ce qu'elle montre |
|---|---|
| **Risque Géopolitique** | Score 0100 calculé depuis les flux RSS en temps réel |
| **Cartographie risques** | Radar par catégorie (énergie, métaux, agriculture…) |
| **Patterns actifs** | Top 3 patterns déclenchés avec leur score de similarité |
| **Catalyseurs** | Prochains événements économiques importants |
| **Top 10 idées** | Idées de trades générées automatiquement (≈1000€, horizon 3 mois) |
| **Marchés** | Prix en direct : énergie, métaux, indices, forex |
**Ajouter un trade depuis une idée** : cliquer sur **"+ Ajouter au portefeuille"** sur une carte idée. La position est créée automatiquement avec le prix Black-Scholes du moment comme référence d'entrée.
**Top 10 IA** (bouton bleu, requiert clé OpenAI) : envoie le contexte géopolitique live à GPT-4o qui génère et classe les 10 meilleures opportunités du moment.
---
### 2. Radar Géopolitique
Analyse des flux d'information géopolitique.
- **Flux RSS** : actualités classées par catégorie (conflit, énergie, santé, politique)
- **Patterns déclenchés** : liste complète avec score, actif ciblé et direction suggérée
- **Score de risque détaillé** : décomposition par sous-catégorie
---
### 3. Marchés & Prix
Cotations temps réel (délai 15 min via Yahoo Finance) pour les 28 instruments du watchlist :
- Énergie : USO, XLE, UNG, BNO, OIL
- Métaux : GLD, SLV, COPX, PPLT, GDX
- Agriculture : WEAT, CORN, SOYB, JO, NIB
- Indices : SPY, QQQ, IWM, EFA, EEM, VIX
- Actions : XOM, CVX, LMT, MOS, AA
- Forex : UUP, FXE, FXY, FXF, CYB
Graphiques historiques disponibles par instrument (1j à 5 ans).
---
### 4. Options Lab
Pricer Black-Scholes interactif.
1. Choisir un **sous-jacent** (ou le taper manuellement)
2. Sélectionner une **stratégie** : Long Call, Long Put, Bull Call Spread, Bear Put Spread, Long Straddle
3. Régler **strike**, **type**, **durée** et **quantité**
4. Cliquer **"Calculer"** → prix de l'option, Greeks (Δ Θ ν ρ), breakeven
5. **Courbe P&L** : visualisation du gain/perte selon le prix du sous-jacent à expiration
La volatilité implicite (IV) est calculée automatiquement depuis l'historique de prix.
---
### 5. Patterns
Moteurs de détection géopolitique → signal de trade.
**Patterns intégrés (8)** : Middle East → Oil, US Tariffs → Agriculture, Geo Risk → Gold, Fed Hawkish → USD, China → Copper, Ukraine → Wheat, NG Disruption, Pandemic → VIX.
**Créer un pattern personnalisé** :
1. Cliquer **"Nouveau pattern"**
2. Remplir nom, description, mots-clés déclencheurs, actif ciblé, direction
3. **"Générer depuis un contexte"** (IA) : décrire librement la situation géopolitique → GPT-4o-mini génère le pattern complet
4. **"Évaluer avec IA"** : GPT-4o note le pattern sur 100 et indique ses forces/faiblesses
5. Sauvegarder → le pattern est actif immédiatement dans le Cockpit
---
### 6. Portefeuille
Suivi mark-to-market en temps réel de toutes les positions.
**Ajouter une position manuellement** :
1. Cliquer **"Nouvelle position"**
2. Remplir : sous-jacent, stratégie, strike, type (call/put), prime payée, capital, durée
3. Si la prime est renseignée → le P&L est calculé par rapport à cette prime réelle
4. Si non → le prix Black-Scholes au moment de l'ajout sert de référence (P&L démarre à ~0€)
**Lire une carte de position** :
| Champ | Signification |
|---|---|
| **Prime payée / Capital investi** | Référence d'entrée (BS au moment de l'achat si pas de prime réelle) |
| **Valeur BS actuelle** | Prix Black-Scholes calculé avec le spot live |
| **Spot sous-jacent** | Prix du sous-jacent récupéré en temps réel |
| **Jours restants** | Temps avant expiration (rouge < 14j, orange < 30j) |
| **Δ Θ ν** | Greeks nets de la position |
| **Frais IB** | $0.65/contrat (min $1.00) simulés à l'entrée |
| **P&L €/%** | (Valeur actuelle) (Référence entrée) (Frais IB entrée) |
**Clôturer une position** : cliquer "Clôturer la position", entrer la valeur de revente → le P&L net (frais sortie inclus) est calculé et la position passe dans l'historique.
**Supprimer une position** : icône poubelle (positions ouvertes) ou hover sur la ligne (positions clôturées).
**Courbe P&L** : onglet "Courbe P&L" → equity curve cumulée de tous les trades clôturés.
---
### 7. Backtest
Simulation historique d'une stratégie sur une période passée.
1. Choisir un sous-jacent, une stratégie, un strike et une durée
2. Sélectionner la fenêtre historique (1 an, 2 ans…)
3. Lancer le backtest → résultats : win rate, P&L moyen, max drawdown, sharpe ratio
---
### 8. Calendrier
Événements économiques à surveiller : Fed, BCE, NFP, CPI, OPEC, résultats trimestriels.
Classés par importance (! moyen, !! élevé, !!! critique).
---
### 9. Configuration
**Sources d'information** : activer/désactiver les flux RSS et APIs externes (Reuters, AP, Al Jazeera, FT, Bloomberg, EIA, FRED, USDA, WHO…).
**Clés API** :
- **OpenAI** : nécessaire pour le Top 10 IA, l'évaluation de patterns et l'analyse de discours
- **NewsAPI, EIA, FRED** : sources optionnelles pour enrichir les données
Après avoir entré la clé OpenAI et cliqué Sauvegarder, le badge "IA GPT-4o active" apparaît dans la sidebar.
---
## Workflow typique
```
1. Lancer start.ps1
2. Cockpit → lire le score de risque géopolitique
3. Patterns actifs → comprendre quels signaux sont déclenchés
4. Top 10 IA → générer les meilleures idées du moment
5. Options Lab → affiner le strike et visualiser la courbe P&L
6. "+ Ajouter au portefeuille" → position créée avec référence BS
7. Portefeuille → suivre l'évolution quotidienne
8. À terme → clôturer la position et voir la courbe P&L cumulée
```
---
## Frais IB simulés
| Nb contrats | Frais entrée | Frais sortie | Total |
|---|---|---|---|
| 1 | $1.00 | $1.00 | $2.00 |
| 3 | $1.95 | $1.95 | $3.90 |
| 5 | $3.25 | $3.25 | $6.50 |
| 10 | $6.50 | $6.50 | $13.00 |
1 contrat = 100 actions sous-jacentes. La prime s'exprime en $/share, la valeur totale en $/share × 100.
---
## Notes importantes
- Les prix sont en **temps différé de 15 minutes** (Yahoo Finance gratuit)
- La volatilité implicite est calculée depuis **l'historique de prix** (pas le marché des options)
- Les P&L sont en **euros** par convention d'affichage mais les sous-jacents sont cotés en **dollars**
- Ce cockpit est un **outil de simulation et d'aide à la décision** — pas une interface de trading réel