Repository Public
1<!--2SP Wallet iOS3File: docs/parity/markets-risk.md4Author: Simon-Pierre Boucher5Contact: contact@spboucher.ai6-->7# Parité — Marchés, ordres unifiés, risque, mandats, clés d'API89Référence web : `apps/web/src/screens/{Markets,PrivateMarkets,Risk,TradeUnified,Developer}.tsx` (branche `v11`).10iOS : `Features/DeFi/` et `Features/Security/{Risk,Mandate,Developer}*.swift` (branche `ui-markets`).11« Vérifié » précise comment : test unitaire (`Tests/MarketsRiskTests.swift`), test d'interface sur la pile jetable12(`UITests/MarketsRiskUITests.swift`, `dev-stack.sh up-fork`, port 8790), capture d'écran lue, ou non vérifiable ici.1314Verrous d'environnement du serveur, tels que `/risk/state` les nomme (tous **fermés** par défaut sur la pile jetable) :15`deriv_live_mainnet` (`SPW_DERIV_LIVE_MAINNET`), `deriv_mandate_mainnet` (`SPW_DERIV_MANDATE_MAINNET`), `deriv_gmx_live`16(`SPW_DERIV_GMX_LIVE`), `deriv_mm_mainnet` (`SPW_DERIV_MM_MAINNET`), `deriv_mm_testnet` (`SPW_DERIV_MM_TESTNET`),17`trading_api_execution` (`SPW_TRADING_API_EXECUTION`). L'app les affiche par nom avec la phrase du serveur ; elle ne peut pas les modifier.1819## Marchés2021| Capacité | Web | iOS (cette version) | Maturité réelle côté serveur | Ce qui bloque |22|---|---|---|---|---|23| Explorateur (comptant + perpétuels, 5 sources) | oui | oui : recherche, filtres type / plateforme / négociable, tri serveur, pagination, compteurs du serveur | lecture publique en service (`/markets-hub`) ; dYdX et edgeX en données seules (juridiction) | — |24| Source et âge de chaque prix | oui | oui : marque « en direct / retardé / périmé / reconnexion / instantané » + source + nature du prix | `stale`, `ageMs`, `staleAfterMs`, `source` servis par ligne | — |25| Mises à jour en direct | oui (`quotes.ts`) | oui : `QuoteStream`, abonnement aux seules lignes à l'écran, désabonnement à la sortie, arrêt en arrière-plan | websocket propriétaire `/api/v1/stream` | une seule connexion par écran Marchés ; un flux partagé dans `AppEnvironment` éviterait une 2ᵉ connexion avec Contrats à terme |26| Tableau triable + volet de détail (iPad) | tableau | oui (`Table`, tri envoyé au serveur) | — | non vérifié sur simulateur iPad dans cette session |27| Page d'un sous-jacent : graphique | oui | oui : barres consolidées, sélecteur d'intervalle (ceux que le serveur annonce), règle et sources affichées | `/market-data/candles` : 40 symboles, 5m / 1h / 1d | hors de ces 40 symboles : « pas de série consolidée », aucun graphique |28| Comparateur de plateformes | oui (valeurs préremplies 1000 / 3 / 24) | oui, **sans** valeur préremplie (sens, notionnel, levier, horizon saisis) ; avertissement du serveur mot pour mot | estimation à partir d'un instantané public | — |29| Écarts entre plateformes | oui | oui (4 premiers, hypothèses et risques du serveur) | estimation, jamais une consigne | — |30| Liens vers Échanger / Contrats à terme | oui (préremplit) | ouvre la section seulement, rien n'est prérempli | — | le `Router` n'a pas de paramètre de marché à transmettre (voir demandes) |31| Marchés privés (affichage seul) | oui | oui : sociétés, fiches de contrat, références avec source et date, écarts ; `Table` sur iPad | lecture seule ; `tradable` toujours faux | non négociable par conception (juridiction + définition des contrats) |32| Valorisation implicite | oui | seulement si la formule est publiée ET la fiche revue et non expirée ; sinon la raison | `impliedValuation.formula` / `reasonCode` | — |33| Expiration d'une fiche | oui | « Fiche expirée », aucune unité ni valeur dérivée | `review.validUntil` | — |34| Carnet et bougies d'un contrat privé | oui | non | `/private-markets/:id` (book, candles) | non construit dans cette version |3536## Ordres et positions unifiés3738| Capacité | Web | iOS (cette version) | Maturité réelle côté serveur | Ce qui bloque |39|---|---|---|---|---|40| Liste des ordres (machine à états) | oui | oui : états tels que servis, seul FILLED est un succès, UNKNOWN ni fait ni échoué ; PAPIER et RÉEL en groupes séparés | `/trading/orders` en service | pagination : les 200 plus récents, pas de « page suivante » |41| Filtres mode / plateforme / état | oui | oui (appliqués sur la page lue) | — | — |42| Détail : transitions, exécutions, décision de risque | oui | oui (décisions retrouvées dans les 200 dernières du journal) | `/trading/orders/:id`, `/risk/decisions` | une décision plus ancienne que les 200 dernières n'apparaît pas |43| Positions | oui | oui, erreurs de sources affichées | `/trading/positions` | — |44| Annuler un ordre | oui | oui, une confirmation ; « annulé » seulement quand le serveur le dit | en service | — |45| Fermer / réduire une position | oui | oui (fraction saisie) ; un ordre réel AWAITING_APPROVAL renvoie vers Contrats à terme | papier : en service ; réel : approbation dans le parcours de la plateforme | réel : `deriv_live_mainnet` fermé ⇒ pas de nouveau risque (les réductions passent) |46| Saisie d'un ordre (aperçu + placement) | oui (`TradeUnified`) | **non, volontairement** : un seul formulaire d'ordre, celui du terminal de Contrats à terme | `/trading/orders/preview`, `/trading/orders` | décision de conception (éviter deux formulaires divergents) |47| Ligne de commande | oui | non | `/trading/commands` | non construit |4849## Risque5051| Capacité | Web | iOS (cette version) | Maturité réelle côté serveur | Ce qui bloque |52|---|---|---|---|---|53| État : interrupteurs, arrêts automatiques, verrous par nom, exposition par livre, limites, journal | oui | oui, en une lecture (`/risk/state`), instantané hors ligne | en service | — |54| Engager l'arrêt du trading / la lecture seule | oui | oui : une confirmation, sans clé d'accès, raison facultative | en service | — |55| Lever un interrupteur | oui | oui : `prepareRelease` → revue (quoi, quand, par qui, pourquoi) → clé d'accès | intention `SPW-RISK-SWITCH-INTENT-v1` | — |56| Limites par mode, nommées et expliquées | oui | oui : 25 limites du schéma, valeur enregistrée / défaut / en vigueur | en service | — |57| Resserrer une limite | oui | oui, session seule après que le serveur a dit que rien n'est assoupli | en service | — |58| Assouplir une limite | oui | oui : `prepareLimits` → revue des limites assouplies de → à + ensemble complet → clé d'accès | intention `SPW-RISK-LIMITS-INTENT-v1` | — |59| Limites inconnues de cette version | — | avertissement + enregistrement bloqué (`storedUnknownFields`) | — | vérifié par test unitaire seulement (aucune limite inconnue sur la pile) |60| Arrêts automatiques | oui | oui : activer = session ; désactiver = revue + clé d'accès | intention `SPW-RISK-AUTO-INTENT-v1` | — |61| Journal des décisions / refus | oui | oui : code, limite, valeur observée, seuil, phrase du moteur, mot pour mot | `/risk/decisions` (200 max) | vide sur la pile tant qu'aucun ordre n'a été évalué |6263## Mandats de trading6465| Capacité | Web | iOS (cette version) | Maturité réelle côté serveur | Ce qui bloque |66|---|---|---|---|---|67| Liste, détail, utilisation, tableau « qui fait respecter » | oui | oui | en service | — |68| Révoquer (avec ou sans annulation des ordres ouverts) | oui | oui, une confirmation, sans clé d'accès | en service | — |69| Créer un mandat PAPIER | oui (durée, cadence, glissement préremplis) | oui, **tout** est saisi ; approbation par la session seule | en service | il faut un compte papier (créé dans Contrats à terme) et une clé d'API ou un agent |70| Créer un mandat RÉEL | oui | oui : `prepareApproval` → mandat en entier, tableau d'application, reconnaissance mot pour mot + case, deux demandes « 1/2 signataire », « 2/2 API » | Hyperliquid seulement ; le signataire applique instruments, levier, plafonds, plancher, expiration ; la perte du jour est appliquée par l'API | `deriv_live_mainnet` + `deriv_mandate_mainnet` (+ `trading_api_execution` pour une clé d'API) fermés ; il faut une autorisation de plateforme active sur le compte |71| Mandat de tenue de marché | oui | liste et révocation seulement (le Core refuse son approbation) | `deriv_mm_mainnet` / `deriv_mm_testnet` | approbation hors de ce module |7273## Clés d'API et webhooks7475| Capacité | Web | iOS (cette version) | Maturité réelle côté serveur | Ce qui bloque |76|---|---|---|---|---|77| Liste (permissions, plafonds, restrictions, dernière utilisation, expiration, état) | oui | oui | en service | — |78| Créer une clé | oui | oui : revue de l'intention vérifiée → clé d'accès ; aucune valeur présélectionnée | intention `SPW-APIKEY-INTENT-v1` | liaison à un mandat à la création : non offerte (se fait en créant le mandat pour la clé) |79| Secret montré une seule fois | oui | oui : feuille dédiée, copie 120 s locale, masqué pendant un enregistrement d'écran, jamais mis en cache | le serveur ne garde qu'une empreinte | — |80| Écarts entre la clé créée et l'intention | — | affichés en tête + révocation immédiate | — | vérifié par lecture du code seulement (aucun écart possible sur une pile honnête) |81| Renouveler une clé | oui | oui (revue + clé d'accès, secret une fois) | en service | — |82| Restreindre / élargir | oui | permissions, plafonds, restrictions, cadence : session si rien n'élargit, sinon revue + clé d'accès | en service | nom, expiration et liaison de mandat non modifiables ici |83| Révoquer | oui | oui, une confirmation | en service | — |84| Exécution réelle par une clé | — | état affiché | `trading_api_execution` fermé par défaut | verrou d'environnement |85| Journal d'utilisation, état de l'API | oui | non | `/developer/usage`, `/developer/status` | non construit |86| Webhooks : liste, création, activation, suppression, nouveau secret | oui | oui (secret une fois, même feuille) | en service | modification des événements d'un webhook existant : non offerte |87