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 |