Le domaine en dix objets
Ordre, carnet, exécution, position, compte espèces, règlement : les objets du marché, leurs relations et où s’arrête le moteur.
Leçon 110 min
À la fin de cette leçon
- Distinguer un ordre, une exécution et un règlement-livraison dans le code
- Traiter le délai de règlement comme un paramètre, faute de texte qui le fixe
- Expliquer pourquoi numéroter les exécutions rend un import rejouable sans doublon
Un moteur de cotation ne manipule pas « de la finance ». Il manipule une dizaine d'objets aux relations précises. Bien les nommer évite une famille entière de bogues : un ordre n'est pas une exécution, une exécution n'est pas un règlement, une position n'est pas un solde.
Avant le code, la vue métier : suivez un ordre d'achat de lieu en lieu, et regardez son tampon changer à chaque étape.
L’ordre naît
Awa décide d’acheter 40 actions de la société fictive Kapok, sans payer plus de 10 000 F chacune : c’est un ordre à cours limité.
Le trajet d'un achat
Suivez un achat de bout en bout. Une cliente fictive veut 40 titres d'une société inventée.
1/6Ordre
La cliente confie un ordre à sa société de bourse : acheter 40 titres, à 10 100 francs au plus.
Chaque étape s'appuie sur un texte. Seules les sociétés de bourse agréées par la COSUMAF peuvent négocier à la BVMAC (Règlement 01/22, art. 161). Tout ordre est horodaté dès sa réception par la société de bourse (RG BVMAC 2025, art. 150). La BVMAC transmet les données des négociations au dépositaire central, pour garantir la livraison des titres et le paiement du prix (même texte, art. 220 et 231). Ce rôle est tenu à titre transitoire par la BEAC (décision COSUMAF de 2019).
Dix objets, dix types
Touchez un objet : ses relations apparaissent, avec leur multiplicité (pour un objet de gauche, combien d'objets de droite).
- Exécutionapparie, côté achat et côté vente, unOrdre1..2
- Exécutiondonne lieu à unRèglement-livraison1..1
Exécution
Échange conclu entre un ordre d'achat et un ordre de vente, pour une quantité et à un prix.
Trois distinctions comptent plus que les autres quand vous écrivez du code.
- Ordre et exécution. Un ordre entrant peut produire zéro, une ou plusieurs exécutions (Euronext Trading Manual, 2021, section 3.2.1). La relation est donc « un vers plusieurs », jamais « un vers un ».
- Exécution et règlement. L'exécution est un engagement pris au marché. Le règlement-livraison est le transfert effectif, plus tard, chez le dépositaire central.
- Position et compte espèces. Deux grandeurs distinctes, mises à jour ensemble par le même règlement, en sens opposés.
Où s'arrête le moteur
Le moteur pédagogique @criee/marche couvre la moitié gauche de la carte : ordres, carnet, exécutions. Le reste vit en aval, dans le progiciel de la société de bourse.
import type { Execution } from '@criee/marche'
// Ce que produit le moteur
const e: Execution = { achat: 'a1', vente: 'v1', prix: 10100, quantite: 40 }
// Ce que le moteur ignore : la tenue de compte, côté progiciel
interface Position { compte: string; titre: string; quantite: number }
interface MouvementEspeces { compte: string; montant: number } // francs, entier
Cette frontière est un choix de conception : le moteur reste pur, sans base ni réseau, donc testable en isolation.
La même histoire, vue par les types. À chaque étape, l'objet change de nature ; le pointillé rouge marque l'endroit où le moteur s'arrête. Regardez l'étape 3 : un seul ordre, deux exécutions.
pointillé rouge : là où s’arrête le moteur
Omit<Ordre, 'rang'>
réception par la société de bourse
Un ordre : une intention
Combien de jours séparent l'exécution du règlement à la BVMAC ? Aucun texte trouvé ne le fixe. Le Bulletin officiel de la cote calcule le coupon couru à J+3, ce qui n'est qu'un indice. Ne codez pas ce délai en dur : faites-en un paramètre.
De mémoire : quelle différence entre une exécution et un règlement-livraison ?
Plus loin
Une exécution sans identifiant. Le type Execution du moteur n'a pas de champ id. Tant que les exécutions restent en mémoire, ce n'est pas gênant. Dès qu'elles sortent du moteur (fichier, message, base), le progiciel doit reconnaître une exécution déjà reçue, sinon un import rejoué compterait deux fois les mêmes titres. Reprenons le trajet d'Awa, pas à pas :
const c = new Carnet(10000)
c.passer({ id: 'v1', sens: 'vente', quantite: 25, limite: 10050 }) // []
c.passer({ id: 'v2', sens: 'vente', quantite: 30, limite: 10100 }) // []
const ex = c.passer({ id: 'a1', sens: 'achat', quantite: 40, limite: 10100 })
// [{ achat: 'a1', vente: 'v1', prix: 10050, quantite: 25 },
// { achat: 'a1', vente: 'v2', prix: 10100, quantite: 15 }]
ex.reduce((s, e) => s + e.quantite, 0) // 40 : la somme égale l'ordre servi
ex.reduce((s, e) => s + e.prix * e.quantite, 0) // 402750 : deux prix, un seul montant
- Les deux premiers appels ne produisent rien : il n'y a pas encore d'acheteur.
- Le troisième produit deux exécutions, à deux prix : celui de v1, puis celui de v2.
- La somme des quantités vaut 40 : c'est le contrôle le plus simple de la relation « un vers plusieurs ».
- Le montant payé n'est pas 40 × 10 100, mais la somme des montants de chaque exécution.
Pour l'identifiant, un choix de conception possible : numéroter chaque exécution à sa sortie du moteur, dans l'ordre où il les renvoie, et faire de ce numéro la clé d'import.
const numerotees = ex.map((e, n) => ({ ...e, ref: `S1-${n + 1}` })) // S1 : séance fictive
const recues = new Map(numerotees.map((e) => [e.ref, e])) // réimporter ne double rien
Ce numéro n'est stable que si le moteur est déterministe : la même séance doit renvoyer les mêmes exécutions dans le même ordre (leçon Les invariants d'un moteur). La traduction de ces exécutions en mouvements et en écritures fait l'objet de la leçon D'une exécution aux écritures.
De mémoire : un achat de 40 est servi par deux ventes, à 10 050 puis à 10 100. Combien de mouvements titres pour l'acheteur, et que vaut leur somme ?
À toi de jouer
À lire ensuite : Règlement général de la BVMAC (2025)
Une question ? Posez-la à votre enseignant, ou à un assistant IA en lui donnant le titre de cette leçon.