SPB Git

Repository Public

markets-risk.md 9.8 KB

# Parité — Marchés, ordres unifiés, risque, mandats, clés d'API

Référence web : apps/web/src/screens/{Markets,PrivateMarkets,Risk,TradeUnified,Developer}.tsx (branche v11). iOS : Features/DeFi/ et Features/Security/{Risk,Mandate,Developer}*.swift (branche ui-markets). « Vérifié » précise comment : test unitaire (Tests/MarketsRiskTests.swift), test d'interface sur la pile jetable (UITests/MarketsRiskUITests.swift, dev-stack.sh up-fork, port 8790), capture d'écran lue, ou non vérifiable ici.

Verrous d'environnement du serveur, tels que /risk/state les nomme (tous fermés par défaut sur la pile jetable) : deriv_live_mainnet (SPW_DERIV_LIVE_MAINNET), deriv_mandate_mainnet (SPW_DERIV_MANDATE_MAINNET), deriv_gmx_live (SPW_DERIV_GMX_LIVE), deriv_mm_mainnet (SPW_DERIV_MM_MAINNET), deriv_mm_testnet (SPW_DERIV_MM_TESTNET), trading_api_execution (SPW_TRADING_API_EXECUTION). L'app les affiche par nom avec la phrase du serveur ; elle ne peut pas les modifier.

# Marchés

Capacité Web iOS (cette version) Maturité réelle côté serveur Ce qui bloque
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) —
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 —
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
Tableau triable + volet de détail (iPad) tableau oui (Table, tri envoyé au serveur) — non vérifié sur simulateur iPad dans cette session
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
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 —
Écarts entre plateformes oui oui (4 premiers, hypothèses et risques du serveur) estimation, jamais une consigne —
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)
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)
Valorisation implicite oui seulement si la formule est publiée ET la fiche revue et non expirée ; sinon la raison impliedValuation.formula / reasonCode —
Expiration d'une fiche oui « Fiche expirée », aucune unité ni valeur dérivée review.validUntil —
Carnet et bougies d'un contrat privé oui non /private-markets/:id (book, candles) non construit dans cette version

# Ordres et positions unifiés

Capacité Web iOS (cette version) Maturité réelle côté serveur Ce qui bloque
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 »
Filtres mode / plateforme / état oui oui (appliqués sur la page lue) — —
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
Positions oui oui, erreurs de sources affichées /trading/positions —
Annuler un ordre oui oui, une confirmation ; « annulé » seulement quand le serveur le dit en service —
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)
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)
Ligne de commande oui non /trading/commands non construit

# Risque

Capacité Web iOS (cette version) Maturité réelle côté serveur Ce qui bloque
É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 —
Engager l'arrêt du trading / la lecture seule oui oui : une confirmation, sans clé d'accès, raison facultative en service —
Lever un interrupteur oui oui : prepareRelease → revue (quoi, quand, par qui, pourquoi) → clé d'accès intention SPW-RISK-SWITCH-INTENT-v1 —
Limites par mode, nommées et expliquées oui oui : 25 limites du schéma, valeur enregistrée / défaut / en vigueur en service —
Resserrer une limite oui oui, session seule après que le serveur a dit que rien n'est assoupli en service —
Assouplir une limite oui oui : prepareLimits → revue des limites assouplies de → à + ensemble complet → clé d'accès intention SPW-RISK-LIMITS-INTENT-v1 —
Limites inconnues de cette version — avertissement + enregistrement bloqué (storedUnknownFields) — vérifié par test unitaire seulement (aucune limite inconnue sur la pile)
Arrêts automatiques oui oui : activer = session ; désactiver = revue + clé d'accès intention SPW-RISK-AUTO-INTENT-v1 —
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é

# Mandats de trading

Capacité Web iOS (cette version) Maturité réelle côté serveur Ce qui bloque
Liste, détail, utilisation, tableau « qui fait respecter » oui oui en service —
Révoquer (avec ou sans annulation des ordres ouverts) oui oui, une confirmation, sans clé d'accès en service —
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
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
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

# Clés d'API et webhooks

Capacité Web iOS (cette version) Maturité réelle côté serveur Ce qui bloque
Liste (permissions, plafonds, restrictions, dernière utilisation, expiration, état) oui oui en service —
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é)
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 —
É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)
Renouveler une clé oui oui (revue + clé d'accès, secret une fois) en service —
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
Révoquer oui oui, une confirmation en service —
Exécution réelle par une clé — état affiché trading_api_execution fermé par défaut verrou d'environnement
Journal d'utilisation, état de l'API oui non /developer/usage, /developer/status non construit
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
Files main
Menu

Theme