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

Trading schedule

Joyride trades on a 24/7 schedule with 24-hour rounds and daily settlement at 08:00 UTC. See Trading Hours and Rollover for the user-facing timing contract, TWAP window, and rollover behavior.

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
  • spot prices and candles
  • oracle TWAP previews and settlement timing
  • social leaderboard and activity
  • account state
  • order history
  • profile and avatar management
  • admin settlement and bootstrap flows
The full reference is auto-generated in the REST API tab from the OpenAPI 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
  • live ticker, spot, candle, social, leaderboard, and settlement streams
  • user order and trade notifications
  • settlement and instrument-bootstrap push events for authenticated clients
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. See Risk Engine.