> ## Documentation Index
> Fetch the complete documentation index at: https://docs.joyride.exchange/llms.txt
> Use this file to discover all available pages before exploring further.

# Exchange Overview

> Architecture and API surface for Joyride's hybrid CLOB exchange.

## 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](./trading-hours) 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](./websocket) 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](./risk-engine).