Fiche : le contrat du moteur
API de @criee/marche, garanties et limites connues, sur une page.
Fiche5 min
À la fin de cette leçon
- Retrouver la signature et les garanties de chaque fonction du moteur
- Retrouver les limites connues du moteur pédagogique, chacune à tester
Dans cette leçon7
L'API publique de @criee/marche, ce qu'elle garantit et ce qu'elle ne garantit pas. Prix et quantités sont des entiers ; limite: null désigne un ordre au marché.
Types
type Sens = 'achat' | 'vente'
interface Ordre { id: string; sens: Sens; quantite: number; limite: number | null; rang: number; auteur?: string }
interface Execution { achat: string; vente: string; prix: number; quantite: number }
interface Niveau { prix: number; quantite: number; ordres: number }
interface VueCarnet { achats: Niveau[]; ventes: Niveau[] }
interface PointCourbe { prix: number; demande: number; offre: number; volume: number; desequilibre: number }
interface ResultatFixing {
prix: number | null; volume: number; courbe: PointCourbe[]; executions: Execution[]
regle: 'volume' | 'desequilibre' | 'pression' | 'reference' | 'aucun-echange'
}
Cotation continue : Carnet
new Carnet(prixReference = null): carnet vide ; le prix de référence sert de dernier cours initial.passer(ordre):ordresansrang(attribué automatiquement) ou avec. Renvoie les exécutions déclenchées, dans l'ordre de priorité. Lève une exception siquantiten'est pas un entier strictement positif.annuler(id): retire l'ordre en attente ;falses'il n'existe plus.prix: dernier prix d'exécution, ou le prix de référence, ounull.ordres(): ordres en attente des deux côtés, triés par priorité.vue(profondeur = 5): niveaux de prix agrégés, les ordres au marché exclus.fourchette():{ achat, vente, ecart }, chaque champnullsi un côté est vide.
Fixing : fixing(ordres, prixReference = null)
Fonction pure. Les candidats sont les limites présentes (le prix de référence seulement s'il n'y en a aucune). Départage dans l'ordre : volume maximal, plus petit déséquilibre absolu, pression, proximité du prix de référence. Répartition par priorité prix puis temps, au prix unique. Sans croisement : prix: null, regle: 'aucun-echange'.
Utilitaires
trierCote(ordres, sens): copie triée par priorité prix puis temps ; l'ordre au marché en tête.agreger(ordres): regroupe des ordres déjà triés en niveaux de prix.
Garanties
Pour des entrées valides au sens de la leçon 2 :
- Exécution au prix de l'ordre déjà présent dans le carnet (continu) ; au prix unique (fixing).
- Aucune exécution hors des limites des deux ordres.
- Carnet jamais croisé après
passer. - Même suite d'entrées, même suite de sorties : aucune horloge, aucun hasard dans le moteur.
Limites connues du moteur pédagogique
Chacune mérite un test, puis une décision :
ordres()renvoie les objets internes : modifier un ordre renvoyé modifie le carnet.limiten'est pas validée : négative, décimale ouNaNsont acceptées.- Les identifiants ne sont pas vérifiés : deux ordres peuvent partager un
id, etannulerles retire tous. - Un ordre refusé consomme quand même un rang ; un
rangfourni par l'appelant n'est pas contrôlé. - Le reliquat d'un ordre au marché disparaît aussitôt, alors que le RG BVMAC 2025 l'élimine « à expiration ».
fixingne valide pas les quantités (zéro ou négatif acceptés).fixingn'ajoute pas le prix de référence aux candidats quand des ordres limités existent : des ordres au marché qui ne se croisent qu'entre eux ne se traitent pas au prix de référence, contrairement au manuel d'Euronext.- Sans prix de référence, la règle
'reference'prend le candidat médian : comportement non documenté.
Ce que le moteur ne fournit pas
Trois absences façonnent le code qui l'entoure :
- Pas de modification. Elle s'écrit avec
annulerpuispasser, en repassant l'ancienrangquand la priorité est conservée (Modifier et annuler un ordre). Valider avant d'annuler, sinon l'ordre se perd. - Pas de journal ni de compteur exposé. Un carnet restauré numérote de nouveau depuis 1 : un journal qui veut se rejouer depuis un instantané doit porter le rang de chaque ordre (Journaliser et rejouer une séance).
- Pas d'identifiant d'exécution.
Executionn'a ni numéro ni heure : la référence qui rend un import idempotent vient de l'extérieur (D'une exécution aux écritures).
De mémoire : que renvoie fixing() quand aucun prix ne permet d'échange ?
À lire ensuite : Euronext Trading Manual, 5 juillet 2021
Une question ? Posez-la à votre enseignant, ou à un assistant IA en lui donnant le titre de cette leçon.