Aller au contenu
Criée

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) : ordre sans rang (attribué automatiquement) ou avec. Renvoie les exécutions déclenchées, dans l'ordre de priorité. Lève une exception si quantite n'est pas un entier strictement positif.
  • annuler(id) : retire l'ordre en attente ; false s'il n'existe plus.
  • prix : dernier prix d'exécution, ou le prix de référence, ou null.
  • 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 champ null si 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 :

  1. ordres() renvoie les objets internes : modifier un ordre renvoyé modifie le carnet.
  2. limite n'est pas validée : négative, décimale ou NaN sont acceptées.
  3. Les identifiants ne sont pas vérifiés : deux ordres peuvent partager un id, et annuler les retire tous.
  4. Un ordre refusé consomme quand même un rang ; un rang fourni par l'appelant n'est pas contrôlé.
  5. Le reliquat d'un ordre au marché disparaît aussitôt, alors que le RG BVMAC 2025 l'élimine « à expiration ».
  6. fixing ne valide pas les quantités (zéro ou négatif acceptés).
  7. fixing n'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.
  8. 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 annuler puis passer, en repassant l'ancien rang quand 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. Execution n'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.

Partager :WhatsAppLinkedIn