cdcx — Crypto.com Exchange Terminal

WHY CDCX?

Three tools. One binary.

FOR AI AGENTS

86 MCP tools with typed parameters, safety enforcement, and schema discovery. 12 agent skill files. Works with Claude, GPT, Copilot, Gemini, and any MCP client.

FOR THE COMMAND LINE

86 REST endpoints across 10 API groups. --help on everything. --dry-run to preview. --output json for scripts. Profiles for multi-account. Paper trading.

FOR THE DASHBOARD

Full-screen TUI with streaming data, candlestick charts, heatmap, split screen, order workflows. Toggle between LIVE and PAPER mode with one key.

MARKET DATA

Every market. One command.

86 endpoints from the Crypto.com Exchange API. Tickers, order books, trades, candlesticks, instruments — all accessible as simple CLI commands with table or JSON output.

market data

$ cdcx market ticker -o table INSTRUMENT LAST BID ASK 24H VOLUME BTC_USDT 70,581.00 70,588.08 70,588.09 +2.57% 5,371 BTC ETH_USDT 2,137.85 2,137.85 2,137.86 +2.67% 109,707 ETH SOL_USDT 90.43 90.43 90.44 +3.38% 257,392 SOL CRO_USDT 0.074 0.074 0.075 -0.81% 4,812,000 CRO

LIVE OUTPUT

`cdcx market ticker BTC_USDT`	Live ticker for one instrument
`cdcx market book BTC_USDT`	Order book with depth
`cdcx market trades BTC_USDT`	Recent trades
`cdcx market candlestick BTC_USDT`	OHLCV candlestick data
`cdcx market instruments`	All available instruments

INTERACTIVE DASHBOARD

A trading floor in your terminal.

Full-screen dashboard with 6 tabs, real-time WebSocket streaming, sparklines, heatmap mode, and zero flicker. Built with ratatui — character-level double-buffer diffing.

cdcx tui

1:Market | 2:Portfolio | 3:Orders | 4:History | 5:Watchlist | 6:Positions Market: [Spot] Perpetual Futures Sort: [Vol↓] # Instrument Spark Price 24h Volume ▸1 BTC_USDT ▂▃▅▇█▇▅▆▇█ 70,581.00 +2.57% 372.5B 2 ETH_USDT ▃▄▅▆▇▆▅▄▅▆ 2,137.85 +2.67% 234.6M 3 SOL_USDT ▁▂▃▅▇▆▇█▇█ 90.43 +3.38% 23.3M 4 XRP_USDT ▇▆▅▄▃▄▃▂▂▁ 0.52 -1.20% 18.7M 5 DOGE_USDT ▄▅▆▅▆▇▆▅▆▇ 0.11 +0.89% 12.1M ←→:category s:sort /:search h:heatmap k:chart Enter:detail PROD ■ LIVE $52,481.30 (+481.30) Theme: terminal-pro q:quit ?:help

LIVE DASHBOARD

HEATMAP MODE (h)

ORDER BOOK + TRADES (Enter)

6 TABS

Market, Portfolio, Orders, History, Watchlist, Positions

STREAMING

WebSocket ticker, book, candlestick, trade channels. Auto-reconnect.

SPARKLINES

24h Braille-dot price charts from real candle data.

HEATMAP

Toggle h — rows glow red/green by 24h performance.

SPLIT SCREEN

\ splits table + chart. Navigate rows, chart follows.

LIVE P&L

Session P&L in the status bar. Portfolio tab shows cash vs positions breakdown with real-time tracking.

PAPER MODE

Toggle p — trade against local paper engine with unrealized/realized P&L tracking.

ADVANCED ORDERS

o for OCO (stop-loss + take-profit). O for OTOCO (entry + SL + TP).

6 THEMES

terminal-pro, cyber-midnight, monochrome, neon, micky-d, amber. Plus custom TOML.

CHARTS & COMPARE

See everything. Miss nothing.

Candlestick charts with volume bars, 9 timeframes, streaming updates. Compare up to 4 instruments side by side.

CANDLESTICK CHART WITH VOLUME & TIME AXIS

COMPARE VIEW — SIDE BY SIDE

`k`	Toggle candlestick chart
`[ / ]`	Cycle timeframe (1m, 5m, 15m, 1h, 4h, 1D)
`m`	Compare mode — up to 4 instruments
`a / d`	Add/remove instruments in compare

TRADING

Execute from the command line.

Place orders, cancel, amend — all with safety confirmations and dry-run preview. Every dangerous operation requires explicit acknowledgment.

dry run

$ cdcx trade create-order BTC_USDT --side BUY --quantity 0.001 \ --type LIMIT --price 50000 --dry-run { "dry_run": true, "method": "private/create-order", "params": { "instrument_name": "BTC_USDT", "side": "BUY", "type": "LIMIT", "price": "50000", "quantity": "0.001" } }

SAFETY TIERS

read, sensitive_read, mutate, dangerous. Each with appropriate guardrails.

DRY RUN

--dry-run previews the exact API payload without executing.

TUI WORKFLOWS

Press t for interactive order placement with instrument picker.

PAPER TRADING

Test before you trade.

Local paper trading engine with live market prices. No auth required. Track positions, unrealized/realized P&L, cash vs position breakdown, and trade history. Available in both CLI and TUI.

PAPER TRADING CLI

TUI PAPER MODE (p)

`cdcx paper init --balance 50000`	Create paper account
`cdcx paper buy BTC_USDT --quantity 0.01`	Market buy
`cdcx paper sell BTC_USDT --quantity 0.01`	Market sell
`cdcx paper positions`	Portfolio + live P&L
`cdcx paper balance`	Account balance
`cdcx paper reset`	Start fresh

AGENT MODE

Built for AI agents.

Expose the Exchange API as MCP tools. Claude, GPT, or any MCP-compatible agent gets 86 typed, documented tools with safety enforcement — market data, trading, advanced orders, OTC, wallet, staking, fiat, margin.

mcp server

$ cdcx mcp --services market,account,trade MCP server started (stdio transport) Services: market, account, trade Tools exposed: 75 Safety: mutate requires acknowledged: true Dangerous operations: blocked (use --allow-dangerous)

config

// Claude Desktop / MCP client config { "mcpServers": { "cdcx": { "command": "cdcx", "args": ["mcp", "--services", "market,trade"] } } }

STREAMING

Real-time. Always.

WebSocket streaming as newline-delimited JSON. Pipe to jq, feed to agents, or just watch the market flow.

streaming

$ cdcx stream ticker BTC_USDT ETH_USDT {"i":"BTC_USDT","a":"70581.00","b":"70580.99","c":"0.0257","t":1774285026} {"i":"ETH_USDT","a":"2137.85","b":"2137.84","c":"0.0267","t":1774285027} {"i":"BTC_USDT","a":"70582.50","b":"70582.49","c":"0.0257","t":1774285028} {"i":"ETH_USDT","a":"2138.10","b":"2138.09","c":"0.0268","t":1774285029} ◌

`cdcx stream ticker`	Stream ticker updates
`cdcx stream book`	Stream order book
`cdcx stream trades`	Stream trade executions
`cdcx stream orders`	Your order updates (auth)
`cdcx stream positions`	Position changes (auth)

INSTALL & CONFIGURE

One line. Eleven megabytes. Done.

Single binary, no runtime dependencies. macOS and Linux.

install via curl (recommended)

$ curl -sSfL https://raw.githubusercontent.com/crypto-com/cdcx-cli/main/install.sh | sh ██████╗██████╗ ██████╗██╗ ██╗ ██╔════╝██╔══██╗██╔════╝╚██╗██╔╝ ██║ ██║ ██║██║ ╚███╔╝ ██║ ██║ ██║██║ ██╔██╗ ╚██████╗██████╔╝╚██████╗██╔╝██╗ ╚═════╝╚═════╝ ╚═════╝╚═╝ ╚═╝ ✓ Detected platform: darwin-aarch64 ✓ Checksum verified ✓ Installed to /usr/local/bin/cdcx

install from source

# Requires Rust toolchain $ cargo install --git https://github.com/crypto-com/cdcx-cli.git --bin cdcx ✓ Compiled + installed to ~/.cargo/bin/cdcx

`cdcx setup`	Interactive credential setup
`cdcx tui --setup`	TUI wizard — theme, watchlist, tick rate
`--profile uat`	Switch credential profiles
`--env uat`	Target UAT/sandbox

THEMES