Skip to main content

​
Architecture

Joyride’s hybrid CLOB is split into a few focused services:
  • matching-engine: order book and matching logic
  • order-gateway: WebSocket trading interface and HTTP query interface
  • risk-engine: Greeks, mark pricing, and quote quality metrics
  • settlement-service: expiration settlement workflows
  • deribit-mirror and bs-market-maker: liquidity services and market making helpers

​
API surfaces

​
HTTP REST API

The exchange HTTP API is read-heavy and is the best place to start for integrations that need:
  • instruments
  • order books
  • tickers
  • price history
  • account state
  • order history
  • admin settlement and bootstrap flows
The full reference is auto-generated in the REST API tab from the checked-in openapi.yaml spec.

​
WebSocket API

Trading is WebSocket-only. The gateway speaks JSON-RPC 2.0 over a raw WebSocket connection for:
  • authentication
  • order placement and cancellation
  • live book subscriptions
  • user order and trade notifications
See WebSocket API for the protocol guide. Use the WebSocket Reference tab for the generated channel and message reference.

​
Risk engine API

The risk engine exposes Greeks, mark IV, and mark source metadata over HTTP and WebSocket. See Risk Engine.

​
Current ownership

The exchange docs in this site should stay close to order-gateway, risk-engine, and the checked-in API specs under docs/.