← Proyectos

TitaniumBOE-Sim Simulador del protocolo BOE de Cboe

Simulador del lado del exchange para el protocolo binario BOE de Cboe, con matching engine precio-tiempo, bots de trading, REST API y WebSocket en un solo JAR.

Stack
Java 21 · Javalin · RocksDB · WebSocket · Docker
Estado
Terminado
Año
2025

Qué es BOE

BOE (Binary Order Entry) es el protocolo con el que los participantes envían órdenes a los mercados de opciones de Cboe en EE. UU. No es texto: cada mensaje es una secuencia exacta de bytes en Little Endian, con campos de tamaño fijo, precios con 4 decimales implícitos y campos opcionales que se anuncian con bitfields. Arriba puedes enviar una orden al libro y ver después sus bytes, codificados igual que en el simulador.

Qué construí

Un simulador del lado del exchange, escrito a partir de la especificación v2.11.90: acepta conexiones TCP, autentica sesiones, recibe órdenes BOE y las casa en un motor de matching con prioridad precio-tiempo. Alrededor de eso:

  • Tres bots (market maker, trend follower y random trader) que mantienen actividad en el libro.
  • REST API y WebSocket para market data y operaciones.
  • Documentación interactiva de la API (OpenAPI con Scalar) servida desde el mismo JAR.
  • Persistencia en RocksDB: usuarios, trades y órdenes sobreviven a un reinicio, y las órdenes vivas vuelven al libro.

Por dentro

  • Cada conexión TCP corre en su propia virtual thread de Java 21: código de I/O bloqueante, fácil de leer, sin pagar un hilo del sistema operativo por cliente.
  • El matching se sincroniza por símbolo, no de forma global: AAPL y MSFT se casan en paralelo sin bloquearse.
  • Las escrituras a RocksDB van a una cola asíncrona: el cliente recibe su confirmación sin esperar al disco.
  • Los mensajes forman una jerarquía de sealed classes, así que el compilador conoce todos los tipos posibles.

Qué tan cerca está del spec

Revisé el simulador sección por sección contra la especificación v2.11.90 y corregí cada diferencia que encontré. Los ejemplos en hexadecimal del propio spec se usan como tests, y cuando un ejemplo contradice sus tablas lo anoto como errata en lugar de copiarlo. Lo que hoy cumple:

  • Los códigos de todos los mensajes, el heartbeat de 1 s / 5 s y el login con sus códigos de rechazo.
  • Mensajes secuenciados y sin secuencia, con replay de lo perdido al reconectar.
  • Los campos opcionales que el cliente pide al hacer login (return bitfields), mensaje por mensaje.
  • Órdenes Day, IOC, FOK, GTC y GTD; órdenes con reserva, cantidad mínima y stop; prevención de auto-cruce.
  • Cancel y Modify con sus reglas de prioridad, mass cancel, Purge Orders, lockouts de riesgo y Reset Risk.

Lo que no tiene, y responde con el rechazo que marca el spec: subastas, órdenes complejas, cruces y cotizaciones de market maker. Tampoco usa todavía la simbología de series de opciones: el libro negocia símbolos como AAPL.

Números medidos

Con la prueba de carga del repositorio, en un equipo de 16 núcleos y con el servidor recién iniciado en cada corrida:

  • 500 conexiones TCP simultáneas, sin rechazos.
  • P99 del Order Acknowledgment entre 2,5 y 4,0 ms (900 órdenes por corrida, en 10 sesiones, todas confirmadas).
  • Unas 4.600 peticiones REST por segundo en endpoints públicos.
  • Más de 600 tests automatizados, todos en verde.

La P99 se mide después de las fases de conexiones, logins y REST, que calientan el JIT. Midiendo la latencia sola, con el servidor en frío, la P99 queda entre 7,2 y 13,9 ms.

Al medir descubrí que la propia prueba de carga estaba desactualizada: esperaba los códigos de sesión anteriores y enviaba órdenes para un símbolo que el servidor rechaza, así que los logins y la latencia llevaban tiempo sin medirse. La corregí antes de publicar estas cifras. La fase de memoria sigue sin servir: mide el heap del cliente, no el del servidor, así que no publico ese número.

El cuello de botella

El login no llega a la meta que me había puesto (200 por segundo): se queda en unos 50. Cada contraseña se verifica con BCrypt de coste 12, que consume del orden de 200 ms de CPU por intento; con 16 núcleos, el techo ronda los 60 logins por segundo. Es un costo deliberado: bajarlo abarataría un ataque de fuerza bruta.

Verlo funcionando