Internal Alternative Trading System with CLOB matching engine, pre/post-trade compliance, and regulatory reporting.

CEX — Central Limit Order Book ATS

cexd is Lux's internal Alternative Trading System (ATS). It provides a central limit order book matching engine with integrated pre-trade compliance gating, post-trade surveillance, and regulatory reporting for FINRA, SEC, and international equivalents.

Architecture

Client -> Gateway (HTTP/JWT) -> Engine -> Matcher (CLOB)
                                  |
                            Compliance (pre-trade)
                                  |
                            Surveillance (post-trade)
                                  |
                            Reporting (FINRA/ATS)

API Endpoints

All endpoints require JWT authentication (via CEX_JWT_SECRET). In dev mode (no secret set), endpoints are open.

Markets

Method	Path	Description
`GET`	`/api/v1/markets`	List all active markets
`GET`	`/api/v1/markets/{symbol}`	Get market details
`GET`	`/api/v1/markets/{symbol}/book`	Order book snapshot (`?depth=20`)

Orders

Method	Path	Description
`POST`	`/api/v1/accounts/{accountId}/orders`	Submit order (compliance-gated)
`GET`	`/api/v1/accounts/{accountId}/orders`	List account orders
`GET`	`/api/v1/accounts/{accountId}/orders/{orderId}`	Get order details
`DELETE`	`/api/v1/accounts/{accountId}/orders/{orderId}`	Cancel order

Accounts

Method	Path	Description
`POST`	`/api/v1/accounts/{accountId}/register`	Register with compliance status
`GET`	`/api/v1/accounts/{accountId}/status`	Get compliance status

Admin (requires `admin` role)

Method	Path	Description
`GET`	`/api/v1/admin/reports/finra`	FINRA OATS reports
`GET`	`/api/v1/admin/reports/ats`	ATS-N quarterly report
`GET`	`/api/v1/admin/surveillance/alerts`	Surveillance alerts (`?status=open`)
`POST`	`/api/v1/admin/markets/{symbol}/halt`	Halt trading (circuit breaker)
`POST`	`/api/v1/admin/markets/{symbol}/resume`	Resume trading

Order Types

Type	Description
`limit`	Limit order at specified price
`market`	Market order at best available price

Time in Force

Value	Description
`GTC`	Good 'til cancelled
`IOC`	Immediate or cancel
`FOK`	Fill or kill
`DAY`	Day order (cancelled at market close)

Pre-Trade Compliance Flow

Every order submission passes through the compliance engine before reaching the matcher:

Sanctions check — blocked accounts cannot trade

PEP screening — direct/related PEPs require EDD + source of funds verification

Adverse media — flagged accounts require EDD completion

FATF high-risk country — requires enhanced KYC (level 3)

KYC level — per-jurisdiction, per-asset-class minimums (30+ jurisdictions)

Offering-type gating — Reg D (accredited only), Reg S (non-US only), etc.

Order size limits — per-account max order size and daily limits

Market status — halted markets reject all orders

Configuration

Env Var	Default	Description
`CEX_JWT_SECRET`	(none)	JWT signing secret; empty = dev mode
`CEX_JWT_ISSUER`	`https://hanzo.id`	Expected JWT issuer
`CEX_ADDR`	`:8080`	Listen address

Source

Repository: luxfi/cex

Language: Go

Key packages: pkg/engine, pkg/compliance, pkg/surveillance, pkg/reporting, pkg/gateway

CEX (cexd)