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.
- 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.
ordre suivi
réception
Reçu
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.
Logon (A)
Logon (A) →
Ouverture de session
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 :
passer({ id: 'K-7', sens: 'achat', quantite: 100, limite: 10000 })renvoie[]:enCarnetvauttrue,etatdonne'actif'.- Une vente de 30 à 9 950 arrive : une exécution de 30 à 10 000.
executeevaut 30,etatdonne'partiel'. annuler('K-7')renvoietrue:finvaut'annule',etatdonne'annule'.- Un second
annuler('K-7')renvoiefalse: 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
À 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.