cdcx-cli

cdcx

A CLI, MCP server, and terminal dashboard for the Crypto.com Exchange API. Single binary, zero runtime dependencies.

86 REST endpoints across 10 API groups, dynamically generated from the Crypto.com Exchange OpenAPI spec. Real-time WebSocket streaming. Full-screen TUI dashboard. Paper trading. Works as a standalone CLI, an MCP tool server for AI agents, or an interactive terminal.

Caution: This software interacts with the live Crypto.com Exchange and can execute real financial transactions. Test with cdcx paper before using real funds.

Install

curl -sSfL https://raw.githubusercontent.com/crypto-com/cdcx-cli/main/install.sh | sh

From source:

cargo install --git https://github.com/crypto-com/cdcx-cli.git --bin cdcx

---

Why cdcx?

For AI Agents

Every response is structured JSON. 86 MCP tools with typed parameters, enum validation, safety enforcement, and schema discovery — all generated from the OpenAPI spec at runtime. Your LLM can trade, analyze markets, and manage positions without custom tooling.

cdcx mcp --services market,account,trade

{
  "mcpServers": {
    "cdcx": {
      "command": "cdcx",
      "args": ["mcp", "--services", "market,account,trade"]
    }
  }
}

Compatible with Claude Code, Cursor, Claude Desktop, Codex, Github Copilot, Gemini CLI, and other MCP clients. Includes 13 agent skill files in skills/ for guided workflows.

Things you can ask your AI agent:

"What's the current BTC price and 24h volume?"

"Paper trade BTC for a few rounds and show me the P&L"

"Place an OTOCO bracket on BTC_USDT: entry at 70000, stop-loss at 65000, take-profit at 75000"

For the Command Line

Every endpoint is a command. --help on everything. --dry-run to preview. --output json for scripting. Tab completion. Profiles for multi-account.

cdcx market ticker BTC_USDT -o table
cdcx trade order BUY BTC_USDT 0.001 --dry-run
cdcx stream ticker BTC_USDT ETH_USDT
cdcx paper buy BTC_USDT --quantity 0.01

For the Dashboard

Full-screen terminal trading interface. 6 tabs, real-time streaming, candlestick charts, heatmap mode, split screen, order workflows. Zero flicker.

cdcx tui

Press p to toggle paper mode. Press O for OTOCO bracket orders. Press ? for all shortcuts.

---

Quick Start

Public market data works without credentials:

cdcx market ticker BTC_USDT -o table
cdcx market book BTC_USDT --depth 10 -o table
cdcx market candlestick BTC_USDT --timeframe 1h -o table

Paper trading works without credentials:

cdcx paper init --balance 50000
cdcx paper buy BTC_USDT --quantity 0.01
cdcx paper positions
cdcx paper balance

For trading, set credentials:

export CDCX_API_KEY="your-key"
export CDCX_API_SECRET="your-secret"
cdcx account summary

---

MCP Server

Expose the Exchange API as MCP tools for AI agents:

cdcx mcp --services market,account,trade
cdcx mcp --services all --allow-dangerous

Service groups (MCP): market, account, trade, advanced, margin, staking, funding, fiat, otc, stream, all

Note: account also exposes historical endpoints (orders, trades, transactions). funding covers wallet deposit/withdrawal endpoints. Paper trading is a CLI-only feature and has no MCP tools.

Safety Model

Tier	Behavior	Examples
read	No confirmation	market ticker, market book
sensitive_read	No confirmation	account summary, trade open-orders
mutate	Requires acknowledged: true	trade order, trade cancel
dangerous	Requires --allow-dangerous	trade cancel-all, wallet withdraw

Agent Skills

13 skill files in skills/ covering:

Skill	Purpose
cdcx-market-intel	Market analysis and price discovery
cdcx-portfolio-intel	Portfolio analysis and risk assessment
cdcx-execution	Order placement with safety checks
cdcx-advanced	OCO, OTO, OTOCO contingency orders
cdcx-paper-strategy	Paper trading strategy testing
cdcx-wallet-ops	Deposits, withdrawals, network management
cdcx-auth-setup	Credential configuration
cdcx-autonomy-levels	Safety tier configuration
cdcx-check-balance	Balance and credential verification
cdcx-place-limit-order	Limit order workflow with preflight checks
cdcx-isolated-margin	Isolated margin trading (equity/RWA perpetuals)
recipe-morning-brief	Daily market briefing workflow
recipe-emergency-flatten	Emergency position flattening

Plugin Installation

Install cdcx as a one-click plugin from your AI coding tool's marketplace.

Claude Code:

claude plugin marketplace add crypto-com/cdcx-cli
claude plugin install cdcx-cli@cdcx-cli

Codex CLI: