Connexion abonné Kalshi Edge

En me connectant à DoubleZero, j'accepte les Conditions d'utilisation de DoubleZero. Veuillez noter que les données sont destinées à votre usage interne uniquement et ne peuvent pas être retransmises (voir Section 2(e)).

Les flux Kalshi fournissent les données de marché perps et sports via le réseau DoubleZero Edge sous forme de multicast UDP. Il y a quatre flux :

perps Top of Book (TOB)
perps Market by Price (MBP)
sports Top of Book (TOB)
sports Market by Price (MBP)

Quel chemin dois-je prendre ?

#	Chemin	Idéal pour	Effort
1	Edge Connect	Agents et applications souhaitant un CLI simple et du JSON décodé via WebSocket	Le plus faible
2	Multicast natif	Construire votre propre décodeur sur le format brut	Le plus élevé

Avant tout chemin : achetez les flux dont vous avez besoin sur doublezero.xyz/edge/subscribe. En achetant, vous acceptez les Conditions d'utilisation de DoubleZero et les Conditions de service Kalshi.

1. Edge Connect (recommandé)

Commencez ici. doublezero-edge-connect est le chemin adapté aux agents : une seule commande d'installation, l'hôte rejoint DoubleZero, et votre application consomme du JSON décodé via WebSocket (ws://<host>:8081) au lieu de décoder du multicast binaire.

Edge Connect répond aux besoins de sa base d'utilisateurs en expansion. C'est la méthode de connexion la plus simple, et elle doit être utilisée sauf si vous avez un besoin technique spécifique.

Version courte :

curl -fsSL https://get.doublezero.xyz/connect | bash

L'installateur demande votre secret : un jeton d'accès DZ_… ou le chemin vers le fichier JSON de la keypair Solana qui possède votre pass d'accès / achat de flux.

Si un doublezerod hôte est déjà en cours d'exécution, celui-ci et le daemon du conteneur se lient tous deux au port UDP 44880, de sorte que le daemon du conteneur se termine juste après le démarrage. L'installateur propose d'arrêter et de désactiver le daemon hôte, et le fait sans demander lorsque DZ_ASSUME_YES=1 est défini. Pour le faire vous-même :

sudo systemctl stop doublezerod
sudo systemctl disable doublezerod

Puis vérifiez le statut à l'intérieur du conteneur (attendez-vous à BGP Session Up et votre groupe Kalshi) et connectez un client WebSocket sur :8081 :

docker exec doublezero-edge-connect doublezero status

Contrat WebSocket : PROTOCOL.md.

2. Multicast natif (avancé)

Connaissances techniques approfondies requises

Le multicast natif signifie que vous rejoignez le groupe vous-même et décodez le format brut Edge sur votre hôte. Seuls les utilisateurs les plus techniquement compétents devraient emprunter ce chemin. Vous devrez lire et comprendre les spécifications, en commençant par market-by-price/spec.md et le reste de edge-feed-spec. Préférez Edge Connect sauf si vous avez un besoin impératif de posséder le décodeur.

Configuration du client DoubleZero

Suivez les instructions de configuration pour installer et configurer le client DoubleZero. Maintenez le client à jour :

sudo apt update && sudo apt install doublezero

Acheter un flux

Avec doublezerod en cours d'exécution, identifiez le périphérique à la latence la plus faible avant d'acheter :

doublezero latency

Achetez sur https://doublezero.xyz/edge/subscribe.

Configurer le pare-feu

Autorisez GRE, BGP, PIM et le trafic du flux Kalshi. Les ports UDP Kalshi se situent dans la plage 30000–59999 : le premier chiffre est la classe de trafic (3 données de marché, 4 données de référence, 5 snapshot) et le deuxième chiffre est le flux, donc les données de référence sont toujours marché + 10000 et le snapshot est toujours marché + 20000. Ouvrez la bande complète sur doublezero1 pour que de nouveaux canaux et flux ne nécessitent pas une autre modification du pare-feu — voir Adresses des flux.

iptables :

sudo iptables -A OUTPUT -p gre -j ACCEPT
sudo iptables -A INPUT -i doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -s 169.254.0.0/16 -d 169.254.0.0/16 -p tcp --dport 179 -j ACCEPT
sudo iptables -A OUTPUT -o doublezero1 -p pim -j ACCEPT
# Kalshi marché / référence / snapshot (tous les flux)
sudo iptables -A INPUT -i doublezero1 -p udp --dport 30000:59999 -j ACCEPT

UFW :

sudo ufw allow proto gre from any to any
sudo ufw allow in on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
sudo ufw allow out on doublezero1 from 169.254.0.0/16 to 169.254.0.0/16 port 179 proto tcp
# Kalshi marché / référence / snapshot (tous les flux)
sudo ufw allow in on doublezero1 to any port 30000:59999 proto udp

UFW n'a pas de protocole pim. Le PIM sortant est autorisé par la politique sortante par défaut de UFW ; si vous bloquez le trafic sortant, ajoutez une règle brute pour PIM dans /etc/ufw/before.rules.

Décoder le format vous-même

La version du schéma est 3 — ignorez les datagrammes dont la version n'est pas implémentée par votre décodeur. Formats de référence : edge-feed-spec, incluant market-by-price/spec.md.

Chaque datagramme commence par un en-tête de 24 octets, suivi d'un ou plusieurs messages applicatifs empaquetés jusqu'au MTU. Les datagrammes sont en little-endian et à disposition fixe.

Champ	Notes
Magic	`u16` à l'offset 0 : `0x445A` pour TOB, `0x4442` pour MBP. Validez-le.
Version du schéma	`3`
Channel ID	Démultiplexe les canaux partageant un port
Sequence	Monotone par adresse IP source, Channel ID et port de destination — chaque port a sa propre série. À utiliser pour la détection de lacunes.
Horodatage d'envoi	Nanosecondes depuis l'époque Unix
Nombre de messages	Messages empaquetés dans ce datagramme
Compteur de reset	Tout changement (y compris le passage de `255` à `0`) est un reset ; supprimez l'état du canal de cet émetteur. MBP peut aussi l'incrémenter en cours de session lors d'un re-seed à l'échelle de la place.
Longueur du datagramme	Nombre total d'octets

Messages applicatifs (TOB)

Type	ID	Taille	Port	Contenu
Heartbeat	`0x01`	16 o	market	Signal de vie lorsque le marché est calme
InstrumentDefinition	`0x02`	130 o	reference	Symbole, exposants, tick et lot, expiration
Quote	`0x03`	60 o	market	Meilleur bid et ask, prix et taille, indicateurs de mise à jour
Trade	`0x04`	52 o	market	Prix, taille, côté agresseur, identifiant de trade
EndOfSession	`0x06`	12 o	market	Arrêt propre
ManifestSummary	`0x07`	24 o	reference	Indicateur de validité, compteur de changement Manifest Seq, nombre d'instruments, horodatage
PerpStats	`0x30`	124 o	sibling	Funding, prix mark et oracle, intérêt ouvert, volume du jour

Le Source ID de Kalshi dans le registre edge-feed-spec est 3. Lisez price_exponent et qty_exponent de chaque InstrumentDefinition — ne les codez pas en dur.

Les flux MBP utilisent l'ensemble de messages market-by-price. Consultez les spécifications market-by-price et reference-data dans edge-feed-spec.

La livraison est en UDP sans retransmission (fire-and-forget), et le port de données de référence ne répare pas les données de marché : il ne répète que InstrumentDefinition (au moins une fois toutes les 30 s) et ManifestSummary (au moins une fois toutes les 1 s). Un Quote TOB perdu reste perdu jusqu'à ce que le meilleur bid ou ask de ce marché change. Seuls les flux MBP disposent d'un chemin de réparation — le cycle de snapshot — et un démarrage à froid MBP doit se lier au port snapshot. Dédupliquez les trades sur (instrument ID, trade ID), jamais sur le trade ID seul.

Adresses des flux

Code de flux	Code de groupe	Description	Groupe multicast	Données de marché	Données de référence	Snapshot
`kalshi-perps-tob`	`edge-kalshi-perps-tob`	Perps top-of-book	`233.84.178.3`	`31000`	`41000`	—
`kalshi-perps-mbp`	`edge-kalshi-perps-mbp`	Perps market-by-price	`233.84.178.4`	`32000`	`42000`	`52000`
`kalshi-sports-tob`	`edge-kalshi-sports-tob`	Sports top-of-book	`233.84.178.17`	`33000` + id	`43000` + id	—
`kalshi-sports-mbp`	`edge-kalshi-sports-mbp`	Sports market-by-price	`233.84.178.20`	`34000` + id	`44000` + id	`54000` + id

Abonnez-vous avec le code de flux ; doublezero status et multicast group list affichent le code de groupe.

Schéma des ports : le premier chiffre est la classe de trafic (3 marché, 4 référence, 5 snapshot) ; le deuxième chiffre est le flux. Les données de référence sont marché + 10000 ; le snapshot est marché + 20000. Les ports perps sont fixes. Les ports sports sont base + channel id (par exemple, l'id 10 sur edge-kalshi-sports-mbp utilise 34010 / 44010 / 54010).

Le groupe sélectionne le flux ; le port sélectionne les données de marché, les données de référence ou le snapshot à l'intérieur de celui-ci. La réplication multicast se fait par adresse IP source et groupe, et le fabric n'inspecte jamais le port UDP, donc rejoindre un groupe délivre tout ce qui est sur ce groupe via votre tunnel DoubleZero. Le port est un filtre de socket appliqué sur votre propre hôte après l'arrivée des octets.

Dépannage

Si vous rencontrez un problème non couvert ici, veuillez nous contacter via votre canal existant avant de tenter de le contourner. Si vous n'avez pas de canal, consultez Support.

Assurez-vous que votre client est à jour

Exécutez : sudo apt update && sudo apt install doublezero

Aucun datagramme reçu

Confirmez que le flux a été acheté sur https://doublezero.xyz/edge/subscribe. Un flux non acheté ne délivre aucun trafic.
Confirmez que BGP est actif : doublezero status devrait afficher BGP Session Up sur le bon réseau DoubleZero.
Confirmez que l'abonnement est actif : doublezero user list --client-ip <your ip> devrait lister le flux sous groups.
Confirmez que le groupe est rejoint sur la bonne interface. Le multicast arrive sur doublezero1, pas doublezero0.
Confirmez que le pare-feu autorise les ports UDP du flux en entrée sur doublezero1.

Lacunes de séquence

Suivez la séquence par adresse IP source, Channel ID et port de destination ; un décodeur indexé uniquement sur le Channel ID verra de fausses lacunes. Une vraie lacune signifie des datagrammes perdus. Sur les flux MBP, les marchés affectés se rétablissent lors du prochain cycle de snapshot. Sur les flux TOB, il n'y a pas de réparation : la cotation d'un marché redevient actuelle lorsque son meilleur bid ou ask change à nouveau.

Changements du compteur de reset

Tout changement du compteur de reset signifie que cet émetteur a redémarré ou ré-ensemencé le canal. Supprimez l'état pour cette adresse IP source et ce canal, recueillez les définitions depuis le port de données de référence, et sur les flux MBP reconstruisez les carnets d'ordres depuis le port snapshot.

Le tunnel ne s'établit pas

Edge Connect : exécutez le statut dans le conteneur — docker exec doublezero-edge-connect doublezero status. Le doublezero status de l'hôte échoue souvent alors que le flux fonctionne (le conteneur possède le daemon). Confirmez que le doublezerod de l'hôte est arrêté.
Natif : vérifiez que le daemon hôte est en cours d'exécution : sudo systemctl status doublezerod
Vérifiez que les règles de pare-feu sont en place (GRE, BGP, PIM et les ports du flux sur doublezero1)
Vérifiez le statut de connexion depuis le même endroit où vous vous êtes connecté (conteneur ou hôte) — attendez-vous à BGP Session Up sur le bon réseau DoubleZero

L'IP client est détectée automatiquement à partir de l'IP publique de votre hôte. Vérifiez qu'elle correspond à l'IP utilisée lors de l'achat du flux.

Design de référence pour la recherche

Optionnel. Si vous avez déjà un tunnel DoubleZero et un abonnement sur l'hôte et souhaitez enregistrer et visualiser les données du flux, le design de référence pour la recherche exécute multicast → parser → topofbook-bot → ClickHouse → Grafana avec Docker Compose :

github.com/malbeclabs/edge-multicast-ref/tree/main/demo

Ceci pointe la démo vers Kalshi perps TOB. Pour un autre flux, utilisez son groupe et ses ports depuis Adresses des flux :

cd demo
cp .env.example .env
sed -i -e 's/^DZ_MULTICAST_GROUP=.*/DZ_MULTICAST_GROUP=233.84.178.3/' \
       -e 's/^DZ_MARKETDATA_PORT=.*/DZ_MARKETDATA_PORT=31000/' \
       -e 's/^DZ_REFDATA_PORT=.*/DZ_REFDATA_PORT=41000/' \
       -e 's/^DZ_INTERFACE=.*/DZ_INTERFACE=doublezero1/' .env
docker compose up -d --build

Grafana est généralement accessible à http://localhost:3000 sur l'hôte. Détails et tableaux de bord : le README de la démo.

Ceci visualise les données que vous recevez déjà. Cela ne remplace pas l'achat du flux, l'abonnement, ni l'un des chemins de connexion ci-dessus.

Connexion abonné Kalshi Edge

Quel chemin dois-je prendre ?

1. Edge Connect (recommandé)

2. Multicast natif (avancé)

Configuration du client DoubleZero

Acheter un flux

Configurer le pare-feu

S'abonner

Décoder le format vous-même

Messages applicatifs (TOB)

Adresses des flux

Dépannage

Assurez-vous que votre client est à jour

Aucun datagramme reçu

Lacunes de séquence

Changements du compteur de reset

Le tunnel ne s'établit pas

Design de référence pour la recherche