Aller au contenu
Criée

Modifier et annuler un ordre

Garder ou perdre sa priorité de temps, écrire la modification avec annuler et passer, et les pièges de l’annulation.

Leçon 1010 min

À la fin de cette leçon

  • Prévoir l’effet d’une modification d’ordre sur sa priorité de temps
  • Écrire une modification avec annuler puis passer, en conservant le rang
  • Traiter les retours d’annuler, y compris pour un ordre déjà exécuté
Dans cette leçon5

Un ordre en carnet n'est pas figé. Le client peut réduire sa quantité, l'augmenter, changer sa limite ou tout annuler. Chaque geste a un effet sur la place de l'ordre dans la file, et cette place décide de ce qu'il recevra. Dans la leçon Cycle de vie d'un ordre et protocole FIX, la demande de modification avait un nom, OrderCancelReplaceRequest (G), mais aucune méthode du moteur ne lui répondait. Cette leçon la construit.

Modification d'ordre

Changement de la quantité ou de la limite d'un ordre en attente ; selon le changement, l'ordre garde ou perd sa priorité de temps.

La règle de priorité

Modifier un ordre fait perdre la priorité de temps si la limite change ou si la quantité augmente ; la priorité est conservée si la quantité diminue (Euronext Trading Manual, 2021, section 2). Le projet de règles de marché de la BVMAC de 2008 prévoyait la même règle (Instruction n°2, 2008, section 2.5).

La logique se lit dans la file d'attente. Réduire sa quantité ne lèse personne : les ordres derrière reçoivent plus tôt. Augmenter sa quantité en gardant sa place reviendrait à doubler ceux qui attendaient au même prix. Changer de limite, c'est changer de file.

La règle ci-dessus vient du manuel d'Euronext et d'un projet BVMAC de 2008. Nos recherches n'ont pas trouvé de texte actuel de la BVMAC qui détaille la modification d'un ordre. Traitez-la comme la spécification du moteur pédagogique, à confirmer avant toute mise en production.

Trois modifications, en scène

La file ci-dessous attend à 10 000 : A, B puis C ; D attend à 9 950. Choisissez une modification de B, puis suivez ce qu'elle change quand une vente de 70 arrive. Regardez surtout le rang de B après la modification.

Modifier un ordre1/4
10 000
Arang 1
30 × 10 000
Brang 2
20 × 10 000
Crang 3
25 × 10 000
9 950
Drang 4
15 × 9 950

carnet au départ

Une file à 10 000

A, B et C attendent à 10 000, dans l’ordre d’arrivée ; D attend à 9 950.

De mémoire : B réduit de 20 à 10 garde-t-il sa place devant C ? Et B augmenté à 40 ?

En code : annuler, puis repasser

Le moteur pédagogique ne connaît que passer et annuler. Une modification peut s'écrire avec ces deux méthodes, grâce à un détail de l'API : passer accepte un rang fourni par l'appelant. Garder la priorité, c'est repasser l'ordre avec son ancien rang. Ce découpage est un choix de conception de ce parcours, pas la description d'une plateforme réelle.

import { Carnet, type Execution } from '@criee/marche'

type Changement = { quantite?: number; limite?: number | null }

function trouver(c: Carnet, id: string) {
  const { achats, ventes } = c.ordres()
  return [...achats, ...ventes].find((o) => o.id === id)
}

/** Choix de conception : annuler puis repasser ; le rang n'est gardé que si la quantité baisse à limite égale. */
export function modifier(carnet: Carnet, id: string, ch: Changement): Execution[] | null {
  const actuel = trouver(carnet, id)
  if (!actuel) return null                                   // déjà exécuté, annulé ou inconnu
  const quantite = ch.quantite ?? actuel.quantite
  const limite = ch.limite === undefined ? actuel.limite : ch.limite
  if (!Number.isInteger(quantite) || quantite <= 0) return null // valider AVANT d'annuler
  const garde = limite === actuel.limite && quantite <= actuel.quantite
  const { sens, rang } = actuel
  carnet.annuler(id)
  return carnet.passer({ id, sens, quantite, limite, ...(garde ? { rang } : {}) })
}

Suivons-la pas à pas sur la file de la scène.

const c = new Carnet(10000)
c.passer({ id: 'A', sens: 'achat', quantite: 30, limite: 10000 }) // rang 1
c.passer({ id: 'B', sens: 'achat', quantite: 20, limite: 10000 }) // rang 2
c.passer({ id: 'C', sens: 'achat', quantite: 25, limite: 10000 }) // rang 3
c.passer({ id: 'D', sens: 'achat', quantite: 15, limite: 9950 })  // rang 4

modifier(c, 'B', { quantite: 10 })
// garde = true : B repasse avec le rang 2 → A r1, B r2, C r3, D r4

c.passer({ id: 'V', sens: 'vente', quantite: 70, limite: 9950 })
// [ { A, V, 10000, 30 }, { B, V, 10000, 10 }, { C, V, 10000, 25 }, { D, V, 9950, 5 } ]

Avec modifier(c, 'B', { quantite: 40 }) à la place, garde vaut false : B reçoit le rang 5, prochain numéro du compteur, et la file devient A, C, B. La vente de 70 sert alors A pour 30, C pour 25 et B pour 15 seulement.

Annuler : un booléen, trois pièges

Carnet.annuler(id) retire l'ordre en attente et renvoie true, ou false s'il n'est plus dans le carnet. Trois cas limites méritent un test chacun :

  • Annuler un ordre exécuté : false. L'état « exécuté » est final, l'annulation arrive trop tard.
  • Annuler deux fois : true, puis false. Une interface qui renvoie l'annulation doit s'attendre au second refus.
  • Identifiant réutilisé : deux ordres de même id sont retirés ensemble. C'est une limite connue du moteur, listée dans la fiche « contrat du moteur ».

Une annulation ne défait jamais une exécution. Si l'ordre a déjà été servi en partie, seul le reliquat quitte le carnet. Suivez le scénario d'annulation : l'ordre passe par « partiel » avant « annulé », et ses 30 titres exécutés restent acquis.

Machine à états d’un ordre1/4
ReçuEn carnetExécutéRejetéPartielAnnuléExpiré

ordre suivi

{
id: 'K-7'
etat: 'recu'
executee: 0
reste: 100
}

réception

Reçu

L’ordre K-7 (fictif) arrive : achat de 100 titres à 10 000. Lancez la lecture pour suivre ses transitions.

Plus loin

L'ordre perdu entre deux appels. Une première version de modifier annulait, puis repassait sans rien vérifier. Avec une quantité de 0, la suite est un piège de production :

carnet.annuler('B')                                           // true : B a quitté le carnet
carnet.passer({ id: 'B', sens: 'achat', quantite: 0, limite: 10000 })
// Error: La quantité doit être un entier strictement positif.
carnet.ordres().achats.map((o) => o.id)                        // [ 'A', 'C', 'D' ] : B a disparu

Le client voulait modifier son ordre ; il l'a perdu. La version ci-dessus valide avant d'annuler et renvoie null sans rien toucher. Dans un vrai système, la règle s'énonce ainsi : une modification réussit en entier ou ne change rien.

Quantité totale ou quantité restante ? Le carnet ne garde que la quantité restante. Un ordre de 100 déjà servi pour 30 en affiche 70. Si le client demande « réduire à 50 », parle-t-il des 100 d'origine (il reste alors 20 à servir) ou des 70 restants ? modifier raisonne sur le reste. C'est une décision à écrire dans la spécification, puis dans un test.

Une modification peut s'exécuter. Relever la limite de D de 9 950 à 10 050, face à une vente W de 10 titres à 10 050, ne se contente pas de déplacer D : passer renvoie aussitôt [{ achat: 'D', vente: 'W', prix: 10050, quantite: 10 }], et D ne garde que 5 titres, au rang 6. L'appelant de modifier doit traiter ces exécutions comme celles d'un nouvel ordre.

Le rang fourni n'est pas contrôlé. Le moteur accepte n'importe quel rang. Un ordre E passé avec rang: 0 se place devant A, arrivé avant lui. Seule la passerelle sait si un rang est légitime : c'est elle qui doit le garantir, et un test doit le vérifier.

De mémoire, en reliant à la leçon sur le carnet : pourquoi le rang 0 de E le place-t-il devant A, alors que leurs prix sont égaux ?

Défi : les deux tests de la leçon 7

Reprenez le défi de la leçon Du métier au cas de test. Avec modifier, écrivez en Étant donné / quand / alors : une réduction de quantité garde la priorité, une augmentation la perd. Choisissez des données qui ne passeraient pas si garde valait toujours true.

À toi de jouer

Un ordre en attente voit sa quantité réduite. Sa priorité de temps...

1Un ordre en attente voit sa quantité réduite. Sa priorité de temps...

Comment modifier garde-t-il la priorité avec l'API du moteur ?

2Comment modifier garde-t-il la priorité avec l'API du moteur ?

Que renvoie annuler pour un ordre déjà entièrement exécuté ?

3Que renvoie annuler pour un ordre déjà entièrement exécuté ?

Pourquoi valider la nouvelle quantité avant d'appeler annuler ?

4Pourquoi valider la nouvelle quantité avant d'appeler annuler ?

Une limite relevée croise une vente en attente. modifier renvoie...

5Une limite relevée croise une vente en attente. modifier renvoie...

À 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

Pour aller plus loin