Aller au contenu
Criée

Cycle de vie d’un ordre et protocole FIX

Une machine à états pour l’ordre, puis les messages FIX qui la transportent et la session qui les numérote.

Leçon 814 min

À la fin de cette leçon

  • Décrire la machine à états d’un ordre et ses transitions interdites
  • Reconnaître les messages FIX d’un ordre et leurs valeurs par défaut
  • Gérer les numéros de séquence et les doublons d’une session FIX
Dans cette leçon4

Un ordre n'est pas une ligne figée : c'est un objet qui change d'état. Reçu, rangé dans le carnet, partiellement exécuté, puis exécuté, annulé, expiré ou rejeté. Modéliser ces états comme une machine à états, avec des transitions autorisées et interdites, rend le code plus sûr et les tests plus faciles à écrire.

Cycle de vie d'un ordre

Suite des états d'un ordre, de sa réception à un état final : exécuté, annulé, expiré ou rejeté.

La machine à états

Les sept états ci-dessous sont un choix de modélisation du parcours. Trois faits du règlement les justifient : la validité « jour » est la règle par défaut, la validité à durée déterminée ne dépasse pas 30 jours (RG BVMAC 2025, art. 162), d'où l'état « expiré » ; un ordre peut être servi en plusieurs fois, d'où l'état « partiellement exécuté » ; et il peut être annulé tant qu'il attend.

Déclenchez les événements. Les exécutions et les annulations viennent d'un vrai Carnet : remarquez qu'une vente à 9 950 s'exécute à 10 000, le prix de l'ordre déjà présent.

Cycle de vie d’un ordreachat 100 × 10 000 · 0/100
ReçuDans le carnetExécutéRejetéPartiellement exécutéAnnuléExpiré
  1. L’ordre est reçu par la société de bourse. Choisissez un événement.

En code, une table de transitions suffit, et un test vérifie qu'aucune transition interdite ne passe :

type Etat = 'recu' | 'rejete' | 'actif' | 'partiel' | 'execute' | 'annule' | 'expire'

const transitions: Record<Etat, Etat[]> = {
  recu: ['actif', 'partiel', 'execute', 'rejete'],
  actif: ['partiel', 'execute', 'annule', 'expire'],
  partiel: ['partiel', 'execute', 'annule', 'expire'],
  execute: [], annule: [], expire: [], rejete: [], // états finaux
}

const peutPasser = (de: Etat, vers: Etat) => transitions[de].includes(vers)

Un ordre reçu peut passer directement à « exécuté » : en continu, un ordre qui trouve assez de contrepartie s'exécute dès son entrée.

La table dit quelles transitions existent ; la scène montre ce qui les déclenche. Chaque arc s'allume avec l'appel au moteur qui le provoque, et l'objet suivi change de champ. Comparez les scénarios « Annulation » et « Expiration » : le même annuler mène à deux états finaux différents, car le moteur ignore pourquoi on l'appelle.

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.

De mémoire : un ordre exécuté peut-il être annulé ? Que renvoie alors Carnet.annuler ?

Le protocole FIX en bref

Entre une société de bourse et un marché, les ordres et leurs états voyagent dans des messages. Un standard ouvert existe pour cela : FIX. Il est développé par la FIX Trading Community, organisme de normalisation indépendant à but non lucratif ; ses spécifications sont ouvertes et couvrent tout le cycle de vie, de la pré-négociation au règlement (FIX Trading Community, standards). La version recommandée est FIX Latest ; FIX 4.4 et 4.2 restent supportées pour l'existant (protocole FIX).

Protocole FIX

Norme ouverte d'échange de messages électroniques de négociation, maintenue par la FIX Trading Community.

Quatre messages suffisent pour suivre le cycle de vie modélisé ici. Leur type (MsgType) est une valeur courte (Orchimate, FIX Latest) :

  • NewOrderSingle (D) : un nouvel ordre. Côté moteur, Carnet.passer.
  • OrderCancelRequest (F) : une demande d'annulation. Côté moteur, Carnet.annuler.
  • OrderCancelReplaceRequest (G) : une demande de modification. Le moteur n'en a pas ; souvenez-vous qu'elle fait perdre la priorité si la limite change ou si la quantité augmente (Euronext Trading Manual, 2021, section 2). La leçon Modifier et annuler un ordre traite ce message.
  • ExecutionReport (8) : le message de retour, par lequel l'émetteur de l'ordre apprend ce qu'il devient.

Dans NewOrderSingle, quatre champs sont obligatoires : ClOrdID (11), Side (54), TransactTime (60) et OrdType (40). Price (44) est requis pour un ordre à cours limité. TimeInForce (59) est facultatif, et son absence vaut ordre jour (Orchimate, NewOrderSingle). Une passerelle traduit ces champs vers le type du moteur :

// Esquisse de traduction : les valeurs codées (Side, OrdType) se lisent dans la spécification
function versOrdre(m: NewOrderSingle): Omit<Ordre, 'rang'> {
  return {
    id: m.ClOrdID,                                           // tag 11
    sens: lireSens(m.Side),                                  // tag 54
    quantite: lireQuantite(m.OrderQtyData),                  // composant OrderQtyData
    limite: estLimite(m.OrdType) ? versEntier(m.Price) : null, // tags 40 et 44
  }
}

Le rang ne vient pas du message : c'est le moteur qui le donne, à la réception. C'est le choix fait dans Modéliser un ordre : un rang entier plutôt qu'une heure, attribué en un seul endroit.

Suivez un ordre fictif sous forme de messages : ouverture de session, NewOrderSingle, comptes rendus, demande d'annulation. À chaque arrivée, regardez l'appel au moteur que la passerelle en déduit.

Un ordre en messages FIX1/7
A · Logon

Logon (A)

{
MsgType: 'A'
}

Logon (A) →

Ouverture de session

La société de bourse ouvre la session. Les messages qui suivent seront numérotés en séquence continue à partir de 1.

La session : numéros de séquence

Une session FIX est un flux bidirectionnel de messages ordonnés, avec une série continue de numéros de séquence commençant à 1, en trois temps : ouverture (Logon, type A), échange, fermeture (FIX Session Layer). La couche session prévoit la resynchronisation des messages ; le message ResendRequest (type 2) sert à redemander des messages. Pour un testeur, c'est un scénario à part entière : couper la connexion au milieu d'une séance et vérifier qu'aucun ordre n'est perdu ni traité deux fois.

Le format texte de FIX (TagValue : des paires « tag=valeur » séparées par un caractère de contrôle, ouvertes par BeginString, BodyLength et MsgType, fermées par une somme de contrôle) n'a été confirmé que par des guides d'implémentation : la spécification officielle n'a pas été lue. Ne codez pas un analyseur sur cette base sans la lire. Les champs d'ExecutionReport, dont l'état de l'ordre, se lisent sur Orchimate ; ce parcours ne les recopie pas. Enfin, nous n'avons trouvé aucune source sur l'usage de FIX par la BVMAC.

Plus loin

Stocker l'état, ou le calculer ?

La table de transitions suppose un champ etat stocké et mis à jour à chaque événement. Alternative de conception : ne stocker que les faits (quantité de l'ordre, quantité exécutée, présence au carnet, fin éventuelle) et calculer l'état. Deux sources de vérité ne peuvent alors plus diverger.

interface Suivi {
  quantite: number
  executee: number
  enCarnet: boolean
  fin: 'rejete' | 'annule' | 'expire' | null
}

function etat(s: Suivi): Etat {
  if (s.fin === 'rejete') return 'rejete'
  if (s.executee === s.quantite) return 'execute'
  if (s.fin !== null) return s.fin
  if (!s.enCarnet) return 'recu'
  return s.executee > 0 ? 'partiel' : 'actif'
}

Pas à pas, avec un vrai Carnet et l'ordre K-7 de la scène :

  1. passer({ id: 'K-7', sens: 'achat', quantite: 100, limite: 10000 }) renvoie [] : enCarnet vaut true, etat donne 'actif'.
  2. Une vente de 30 à 9 950 arrive : une exécution de 30 à 10 000. executee vaut 30, etat donne 'partiel'.
  3. annuler('K-7') renvoie true : fin vaut 'annule', etat donne 'annule'.
  4. Un second annuler('K-7') renvoie false : rien ne change, l'état final tient.

L'ordre des tests dans etat compte : un ordre entièrement exécuté reste 'execute', même si une annulation tardive est enregistrée ensuite.

Le coût de la table se mesure aussi : 7 états donnent 49 couples possibles, dont 12 autorisés (« partiel » vers « partiel » compris). Un test qui parcourt les 49 couples avec peutPasser vérifie aussi les 37 interdits, ce qu'aucun test d'exemple ne fait.

Le même compte rendu, deux fois

Après une coupure, la couche session FIX prévoit la resynchronisation, et ResendRequest redemande des messages (FIX Session Layer). Une passerelle doit donc supposer qu'elle peut recevoir deux fois le même ExecutionReport. Si elle additionne naïvement, executee dépasse quantite.

const dejaVus = new Set<string>()

function appliquerExecution(s: Suivi, cle: string, quantite: number): Suivi {
  if (dejaVus.has(cle)) return s // déjà compté : on l'ignore
  dejaVus.add(cle)
  return { ...s, executee: s.executee + quantite }
}

Quel champ d'ExecutionReport sert de clé unique d'une exécution ? Ce parcours ne recopie pas ses champs : lisez-les sur Orchimate avant de choisir. Le principe ne dépend pas de FIX : une exécution doit être comptée une seule fois, quel que soit le nombre de fois où elle arrive.

De mémoire, leçon 4 : un ordre au marché de 20 ne trouve que 12 titres. Que fait le moteur du reliquat, et dans quel état finit l'ordre ?

À toi de jouer

Quel message FIX porte un nouvel ordre ?

1Quel message FIX porte un nouvel ordre ?

Un NewOrderSingle sans TimeInForce (59) est...

2Un NewOrderSingle sans TimeInForce (59) est...

Un ordre passe de « partiellement exécuté » à « reçu ». C'est...

3Un ordre passe de « partiellement exécuté » à « reçu ». C'est...

Dans une session FIX, les numéros de séquence...

4Dans une session FIX, les numéros de séquence...

Le même ExecutionReport arrive deux fois après une resynchronisation. Le suivi doit...

5Le même ExecutionReport arrive deux fois après une resynchronisation. Le suivi doit...

À lire ensuite : Orchimate, messages de FIX Latest (FIX Trading Community)

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