Données de marché Kalshi : préserver les unités, les côtés et le temps

Les unités de prix passent en premier dans les données de marché Kalshi

Commencez par un dictionnaire des champs qui accompagne les données. Un prix nécessite une unité monétaire, une convention relative à l’issue et une précision. La quantité nécessite sa propre unité et sa propre précision. Un horodatage nécessite à la fois une échelle temporelle et un fuseau horaire. Enregistrer un simple nombre appelé prix laisse toutes ces questions aux utilisateurs en aval, qui peuvent faire des hypothèses différentes sans se rendre compte qu’elles divergent.

La documentation de Kalshi sur les nombres à virgule fixe décrit des chaînes de caractères exprimant des montants en dollars avec jusqu’à quatre décimales, et des quantités de contrats avec jusqu’à deux décimales. Elle indique également que les plages de prix propres à chaque marché définissent les incréments valides. Une intégration doit préserver ces informations au lieu de supposer que des nombres entiers de cents et des contrats entiers décrivent tous les marchés actuels. L’arrondi à l’affichage est un choix de présentation distinct.

Considérons un enregistrement fictif avec un prix en dollars de 0,4250 et une quantité de 12,50. La multiplication brute donne 5,3125 $ avant frais. Lire la première valeur comme 42,50 dollars multiplie le montant prévu par 100. Tronquer la quantité à 12 fait perdre un demi-contrat. Aucune de ces erreurs ne rend nécessairement un graphique inutilisable : toutes deux peuvent traverser une chaîne de traitement logiciel si le programme ne vérifie pas le sens de chaque champ.

Un montant intermédiaire précis ne détermine pas non plus le débit final du compte. Les frais de la plateforme et les arrondis du solde peuvent entraîner des écritures distinctes. Conservez le calcul brut, puis rapprochez-le des enregistrements réels de la plateforme. Si un rapport arrondit le produit à 5,31 $ pour faciliter la lecture, conservez la valeur non arrondie afin qu’une autre personne chargée de la vérification puisse distinguer un arrondi d’affichage d’un véritable écart dans le compte.

Identifier le contrat avant de comparer les prix

Un symbole de marché ou un autre identifiant de marché stable doit servir de référence à chaque observation. Un titre court apporte du contexte, mais ne constitue pas une clé primaire fiable. Deux marchés peuvent porter sur la même publication économique avec des seuils, des dates ou des règles de révision différents. Combiner leurs enregistrements peut produire une série historique régulière à partir de prix qui n’ont jamais correspondu au même droit financier.

Conservez le lien avec l’événement ainsi que l’identité de chaque marché. Un ensemble de marchés peut décrire des intervalles, des seuils ou plusieurs issues possibles. Leur relation compte lorsqu’un utilisateur demande l’exposition agrégée ou compare les probabilités apparentes. L’appartenance à un même ensemble ne suffit pas, à elle seule, à établir qu’exactement un marché donnera lieu à un paiement. Cette conclusion découle des conditions des contrats.

Pour une vérification pratique, imaginez deux marchés fictifs qui mentionnent tous deux l’activité manufacturière de septembre. L’un demande si le premier indice publié dépasse 52 ; l’autre utilise un chiffre révisé ultérieurement. Une cotation de chacun est valide prise isolément. Un outil de données est défaillant lorsqu’il les rattache toutes deux à un seul contrat canonique sans conserver cette différence. La correction doit porter sur la correspondance des identités, et non sur un ajustement numérique.

Le guide antérieur sur le scanner de marchés de prédiction explique pourquoi la mise en correspondance des contrats précède le classement des prix. Appliquez cette rigueur à l’ingestion : conservez la définition source et la version examinée. Un analyste en aval doit pouvoir découvrir une incompatibilité sans avoir à la déduire d’un écart de prix anormalement important.

La direction et la convention de prix sont des champs distincts

Une intégration doit préciser si une valeur est exprimée comme un prix Yes, un prix No ou selon une convention propre à l’interface. Elle doit aussi préciser si la direction décrit l’exposition d’un utilisateur, l’action d’un ordre ou le preneur de liquidité dans une transaction publique. Réutiliser un même libellé générique de côté pour tous ces enregistrements favorise les inversions accidentelles.

Le guide de Kalshi sur la direction distingue les champs de direction canoniques des ordres, des exécutions et des transactions des conventions de prix du canal du carnet. Il décrit une option permettant d’exprimer les niveaux du carnet sur une échelle unifiée de prix Yes. Pour la mise en œuvre, il faut donc lire le contrat réel d’abonnement et de réponse plutôt que déduire l’échelle du mot No. Une migration peut modifier cette hypothèse sans modifier le marché sur le plan économique.

Conservez les représentations originales et normalisées. Si l’adaptateur convertit un prix du carnet pour la composante No en une offre de vente sur l’échelle Yes, enregistrez cette transformation et sa convention. Un utilisateur ultérieur des données ne doit pas appliquer le complément une deuxième fois. De même, un champ déjà exprimé sur l’échelle unifiée doit être transmis sans deuxième conversion au seul motif que sa direction indique une exposition No.

Cette distinction évite aussi des libellés de transaction trompeurs. Une transaction publique décrit une activité d’appariement et le point de vue du preneur de liquidité ; elle ne révèle ni les motivations de chaque participant ni l’ensemble de son portefeuille. Une exécution dont la direction est significative peut clôturer une position existante ou s’inscrire dans un montage plus large. Les données de marché peuvent étayer une description de la transaction observée sans établir la prévision privée d’un trader.

Lire un carnet d’ordres Kalshi pour une quantité donnée

Pour l’exemple fictif suivant, supposons la représentation conventionnelle d’un instantané contenant des offres d’achat Yes et No, chaque côté étant coté dans les unités de sa propre issue. Les offres d’achat Yes sont de 120 unités à 0,46 $ et de 180 à 0,45 $. Les offres d’achat No sont de 80 unités à 0,51 $ et de 220 à 0,50 $. Ces hypothèses sont explicites parce que les mêmes libellés peuvent être normalisés différemment dans une autre vue.

Dans le modèle complémentaire standard à un dollar, l’offre d’achat No à 0,51 $ implique une offre de vente Yes disponible à 0,49 $. Le niveau No suivant implique une offre de vente Yes à 0,50 $. L’achat de 150 unités Yes utiliserait donc 80 unités à 0,49 $ et 70 à 0,50 $ si la profondeur affichée restait disponible. Cela représente 39,20 $ plus 35 $, soit un total de 74,20 $ avant frais.

Le prix d’acquisition moyen est d’environ 0,4947 $ par unité. Multiplier la meilleure offre de vente par la totalité des 150 unités donnerait 73,50 $ et sous-estimerait le coût modélisé de 0,70 $. La différence provient de la profondeur visible, avant même de tenir compte de la concurrence, du délai ou des frais. Un estimateur de coût doit montrer les niveaux utilisés afin que le résultat puisse être reproduit.

Pour une vente de 150 unités Yes, les offres d’achat affichées pertinentes sont différentes : 120 à 0,46 $ et 30 à 0,45 $ rapporteraient 68,70 $ avant frais. Acheter puis revendre immédiatement cette quantité dans un carnet inchangé entraînerait une perte de 5,50 $ avant frais. Un graphique du prix médian entre achat et vente ne peut remplacer aucun de ces deux calculs. Le guide antérieur sur la liquidité des marchés de prédiction développe cette approche du coût de transaction qui dépend de la quantité.

Reconstituer le carnet à partir de modifications ordonnées

Un instantané fournit un état de départ. Les messages incrémentaux modifient cet état selon les règles documentées du canal. La référence de Kalshi sur les mises à jour du carnet décrit des messages d’instantané suivis de deltas et fournit des informations de séquence. Une application a besoin de règles explicites de reconstitution ; ajouter chaque message observé à un graphique ne garantit pas que la profondeur affichée soit cohérente.

Supposons qu’un niveau de prix fictif commence à 80 unités. Une variation de moins 30 le ramène à 50 ; une variation ultérieure de plus 20 le porte à 70. Si la première variation est appliquée deux fois, la quantité affichée devient 40. Si la deuxième variation est prise pour une quantité de remplacement, l’affichage devient 20. Les deux résultats peuvent rester non négatifs et ainsi échapper à un contrôle de cohérence simpliste.

Interprétez le type de mise à jour avant d’appliquer la valeur. Une variation de quantité et une quantité totale à un niveau correspondent à des opérations différentes, même lorsque les noms de leurs champs se ressemblent. Conservez l’identifiant du message original ou le contexte de séquence nécessaire à la déduplication. Le programme doit aussi distinguer un niveau à zéro qui supprime de la profondeur disponible d’un niveau absent qui n’a jamais été inclus dans la reconstitution actuelle.

Lorsqu’une lacune ou une mise à jour non prise en charge rend l’état incertain, marquez le carnet comme inutilisable pour les décisions exigeant une profondeur actuelle. Obtenez un nouveau point de départ faisant autorité par le mécanisme pris en charge, puis ne reprenez qu’une fois la reconstitution cohérente. Estimer la variation manquante à partir de la transaction suivante peut produire un graphique séduisant tout en laissant inconnue la quantité réellement disponible.

La séquence des mises à jour Kalshi nécessite des règles de gestion du temps

L’ordre de séquence et l’heure de l’horloge résolvent des problèmes liés, mais différents. Les informations de séquence peuvent établir l’ordre des messages dans leur périmètre documenté. L’heure source indique quand une observation s’est produite. L’heure de réception indique quand l’application en a pris connaissance. L’heure d’affichage indique seulement quand une interface utilisateur a rendu l’enregistrement à l’écran. Préservez ces concepts au lieu de choisir un seul horodatage pour tous les usages.

Imaginez une cotation horodatée à 10:00:02 arrivant à 10:00:03, suivie d’une autre horodatée à 10:00:01 arrivant à 10:00:04. La deuxième arrivée ne doit pas automatiquement remplacer la première comme observation la plus récente. Le délai réseau peut inverser l’ordre d’arrivée. À l’inverse, des horodatages affichant les mêmes secondes ne prouvent pas une disponibilité simultanée lorsque la source offre une précision plus fine.

Les règles de fraîcheur des données doivent être liées à la décision prévue. Un graphique historique peut conserver une observation ancienne accompagnée d’une date claire. Un ordre envisagé pour exécution immédiate peut nécessiter un carnet beaucoup plus récent. Le seuil est un choix de conception qui doit être justifié par le processus, et non une promesse non documentée selon laquelle toute cotation âgée de moins d’une certaine durée restera exécutable.

La synchronisation des horloges compte pour comparer les sources, mais une horloge synchronisée ne peut pas remédier à l’absence d’éléments probants. Si le flux ne fournit pas d’horodatage source, conservez cette limitation et précisez la solution de repli. Ne fabriquez pas une heure source en copiant l’heure de réception dans son champ. Cela évite qu’un analyste ultérieur traite une mesure de l’application comme une observation de la plateforme de négociation.

Distinguer les transactions, les cotations et les exécutions du compte

Une transaction publique atteste qu’une transaction a eu lieu. Une cotation indique un intérêt disponible dans un état observé particulier. Une exécution du compte atteste une exécution pour ce compte. Ces enregistrements répondent à des questions différentes et ne doivent pas partager un champ de statut laissant penser qu’ils sont interchangeables.

Par exemple, une transaction publique historique à 0,49 $ ne prouve pas qu’un nouvel achat de 500 unités pourrait aussi être exécuté à ce prix. La transaction peut avoir consommé la quantité disponible, avoir eu lieu avant une nouvelle annonce ou avoir porté sur une quantité différente. De même, une cotation atteignant la limite d’un ordre ne prouve pas que l’ordre a été exécuté. D’autres ordres peuvent avoir la priorité, ou le niveau visible peut disparaître avant l’appariement.

Un jeu de données de recherche réaliste doit conserver suffisamment d’informations pour distinguer l’activité de marché observée de l’exécution simulée. Si un backtest suppose des exécutions chaque fois qu’une transaction publique franchit un seuil, indiquez cette hypothèse et examinez comment les résultats changent lorsque moins d’exécutions se produisent. Le lecteur ne doit pas confondre l’historique des positions simulées avec un historique de compte reconstitué.

La discussion connexe sur l’algorithme de trading Polymarket est utile pour transformer les observations en décisions. Les différentes représentations des plateformes nécessitent leurs propres adaptateurs, mais la distinction analytique reste la même : des éléments probants peuvent suggérer une action sans démontrer qu’elle a eu lieu. L’enregistrement doit préserver cette distinction tout au long du processus.

Traiter les données manquantes comme une information sur le jeu de données

Une réponse vide peut avoir plusieurs significations : aucune activité correspondante, une erreur de pagination, un identifiant de marché incorrect, un service indisponible ou une requête dirigée vers la mauvaise couche de données. Un collecteur robuste enregistre l’explication qui a été établie. Traiter chaque résultat vide comme une absence d’activité peut fausser discrètement les estimations de volume et de liquidité.

Suivez la couverture de la collecte séparément des valeurs de marché. Une interruption de cinq minutes doit apparaître comme une lacune de collecte, et non comme un prix constant, sauf si une observation faisant autorité étaye cette valeur. Reporter le dernier prix peut être utile pour une visualisation particulière, mais la valeur reportée doit rester identifiable par rapport à une nouvelle observation. La différence compte pour mesurer la volatilité ou le moment d’apparition des signaux.

Lorsque vous combinez plusieurs pages de requête, enregistrez les curseurs et dédupliquez à partir de l’identité stable des enregistrements. Une page répétée peut surestimer l’activité ; une page sautée peut la sous-estimer. N’enregistrer que l’agrégat final rend ces deux erreurs difficiles à diagnostiquer. Le collecteur doit conserver suffisamment d’informations de provenance pour expliquer comment l’agrégat a été formé et si l’intervalle demandé a été entièrement couvert.

L’article complémentaire sur les données Kalshi étend ces pratiques à la recherche historique. Une vue en direct peut sembler correcte à un instant donné tandis que ses archives perdent des révisions, des intervalles manquants ou des définitions de marché. Concevoir les archives en même temps que le flux permet de justifier bien plus solidement les évaluations ultérieures.

Tester l’interprétation avec des exemples délibérément difficiles

Un ensemble utile de cas de validation contient des valeurs susceptibles de révéler les hypothèses : une quantité fractionnaire, un incrément de prix fin, un niveau du carnet côté No, un message reçu dans le désordre, un delta en double et une lacune lors d’une reconnexion. Ce ne sont pas des cas limites décoratifs. Chacun peut modifier sensiblement un montant envisagé ou la confiance dans l’actualité du carnet qui l’étaye.

Donnez à la personne chargée de la vérification un résultat économique attendu ainsi que les champs attendus. Pour l’achat de 150 unités ci-dessus, le coût attendu avant frais est de 74,20 $ à profondeur inchangée. Un analyseur qui renvoie un résultat différent doit expliquer si l’écart provient des unités, de la conversion de côté, de la répartition des quantités ou d’un changement documenté des niveaux disponibles. Se contenter de reproduire une capture d’écran est un test peu probant.

Testez également le refus. L’absence de convention de prix doit empêcher une comparaison précise tenant compte du côté. Une lacune de séquence inexpliquée doit empêcher l’utilisation de la profondeur reconstituée. Un incrément non pris en charge doit empêcher un arrondi silencieux qui aboutirait à une instruction différente. Le test réussit lorsque l’incertitude reste visible et que les décisions qui en dépendent demeurent encadrées jusqu’à ce que le fait manquant soit établi.

Le guide des outils de trading Polymarket offre une autre perspective sur l’évaluation des interfaces de données à travers des tâches réelles. L’objectif n’est pas d’imposer le format d’un fournisseur à un autre. Il consiste à exiger que chaque interface préserve suffisamment de sens pour que l’utilisateur puisse expliquer ses chiffres et les décisions qu’ils peuvent étayer.

Examiner un désaccord sans choisir le chiffre le plus séduisant

Supposons qu’un graphique affiche 0,50 $ alors que la meilleure offre de vente reconstituée est de 0,53 $. La première question est de savoir ce que mesure le graphique. Il peut montrer une dernière transaction, un prix médian entre achat et vente ou une observation effectuée à un autre moment. Deux mesures différentes peuvent toutes deux être correctes. Déclarer un flux inexact avant de vérifier sa définition peut conduire l’analyste à écarter des éléments utiles ou à écraser un enregistrement valide par une valeur incompatible.

Créez un petit enregistrement du désaccord contenant l’identifiant du marché, les deux heures d’observation, les définitions des valeurs et leur provenance. Comparez ensuite des éléments comparables. Si les deux prétendent représenter la même meilleure offre de vente dans le même état pertinent, examinez les lacunes de collecte, la conversion des prix et le traitement des mises à jour. S’ils représentent des mesures différentes, expliquez la différence à l’affichage au lieu d’imposer une concordance numérique.

Utilisez la quantité comme deuxième outil de diagnostic. Une meilleure offre de vente de 0,53 $ avec deux unités disponibles étaye une décision différente de la même offre avec 200 unités disponibles. Un contrôle portant uniquement sur le prix peut réussir alors qu’un analyseur de quantités perd la partie fractionnaire ou combine des niveaux provenant d’instantanés différents. Examiner le triplet complet composé du côté, du prix et de la quantité est plus instructif que vérifier si un prix se situe entre zéro et un.

Enfin, distinguez l’état du marché de l’état privé du compte. Un carnet public peut montrer que la quantité à ce niveau a été absorbée par des transactions alors qu’un point de terminaison du compte n’a pas encore fourni l’enregistrement d’exécution correspondant. Cette observation peut justifier une enquête, mais elle ne doit pas fabriquer une exécution personnelle confirmée. Conservez l’engagement possible et effectuez le rapprochement à l’aide des enregistrements de compte pris en charge. Sinon, une correction des données de marché peut accidentellement devenir un ajustement comptable non autorisé.

Le guide antérieur sur l’analyse des marchés de prédiction relie ces mesures à un processus analytique plus large. Ce processus d’examen des désaccords crée un signal de maintenance utile. Des écarts répétés concentrés autour des reconnexions suggèrent un problème de reconstitution. Des écarts concentrés après un changement d’interface suggèrent un problème de convention ou de schéma. Des différences limitées aux quantités demandées importantes peuvent indiquer un problème d’agrégation de la profondeur. Classer ces tendances aide l’équipe à corriger l’erreur d’interprétation précise plutôt qu’à ajouter de larges tolérances qui donnent au tableau de bord une apparence plus calme tout en affaiblissant sa valeur probante.

Publier une vue des données qu’une autre personne peut reproduire

Un enregistrement efficace de données de marché relie l’observation brute, la correspondance des identités, la conversion des unités, l’état du carnet et le calcul final. Une personne chargée de la vérification doit pouvoir reconstituer le coût affiché sans deviner quelle échelle de prix ou quelle convention d’horodatage a été utilisée. C’est particulièrement utile lorsqu’une migration d’interface change les noms des champs tandis que les enregistrements historiques restent dans les archives.

Gérez les versions des règles d’interprétation. Si un adaptateur ultérieur corrige une erreur de conversion de côté, conservez la liste des enregistrements concernés et reconstruisez explicitement les synthèses qui en dépendent. Remplacer discrètement les valeurs historiques peut améliorer le graphique actuel tout en effaçant les éléments nécessaires pour comprendre une décision antérieure. Les données corrigées et les données initialement disponibles ont chacune des usages légitimes lorsqu’elles sont étiquetées avec précision.

Enfin, définissez les limites du résultat produit. Une estimation valide fondée sur le carnet actuel reste une estimation avant l’exécution. Un historique complet des transactions n’est pas la stratégie privée d’un participant. Un prix normalisé n’est pas une probabilité objective. Préserver ces distinctions transforme les données de marché Kalshi en éléments probants utilisables, avec des raisons claires de faire confiance à un calcul et des limites claires à ce qu’il peut établir.