From cdcx-cli
Enables CLI-based paper trading to test crypto strategies against live market prices without real funds. Use for validation, experimentation, and regression testing via buy/sell/positions/balance commands.
How this skill is triggered — by the user, by Claude, or both
Slash command
/cdcx-cli:cdcx-paper-strategyThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
- Validate a strategy before going live
CLI-only. Paper trading has no MCP tools — agents that need to paper trade must shell out to cdcx paper directly.
The paper engine is local (no API calls for order state — only for market prices). State lives in ~/.local/share/cdcx/paper/paper_account.json.
Fills use live mark prices fetched from the REST API at the moment the order is evaluated:
| Command | Purpose |
|---|---|
cdcx paper init --balance <n> | Create a new paper account (default 10000 USDT) |
cdcx paper buy <INSTRUMENT> --quantity <q> [--price <p>] | Buy (market if no price) |
cdcx paper sell <INSTRUMENT> --quantity <q> [--price <p>] | Sell |
cdcx paper positions | Open positions with unrealized P&L |
cdcx paper balance | Cash balance + realized P&L |
cdcx paper history | Fills log |
cdcx paper reset --balance <n> | Wipe state and start fresh |
All commands support -o json, -o table, -o ndjson.
cdcx paper init --balance 50000
cdcx paper balance -o json
# 1. Check current price
cdcx market ticker BTC_USDT -o json
# 2. Paper buy
cdcx paper buy BTC_USDT --quantity 0.01 -o json
# 3. Inspect open position
cdcx paper positions -o json
# 4. Close
cdcx paper sell BTC_USDT --quantity 0.01 -o json
# 5. Realized P&L shows up in balance
cdcx paper balance -o json
cdcx paper buy BTC_USDT --quantity 0.1 --price 49000 -o json
The limit sits in the paper engine until the market ticker crosses 49000. Check back with cdcx paper positions — until filled, the cash is reserved.
# Bootstrap
cdcx paper init --balance 100000
# Loop (external script / agent):
# 1. Read signal from cdcx market ticker / candlestick
# 2. Issue cdcx paper buy or cdcx paper sell accordingly
# 3. Call cdcx paper positions -o json to track running P&L
# Review
cdcx paper history -o json
cdcx paper balance -o json
cdcx paper reset --balance 100000
Wipes all positions, trades, and P&L; starts fresh with the specified balance.
cdcx invocations — use reset to start freshcdcx paper invocations using the then-current REST tickercdcx tui and press p to toggle LIVE/PAPER modenpx claudepluginhub crypto-com/cdcx-cli --plugin cdcx-cliTests trading strategy logic on Kraken spot paper trading via CLI before risking live funds. Validates entry/exit signals, position sizing, rebalances, and error handling.
Places a paper long position on Kalshi, Polymarket, Alpaca, or Coinbase with optional price. Validates arguments, checks risk limits, and provides fill confirmation.
Analyzes CDCX trading portfolios via CLI tools: fetches balances, positions with P&L, sub-accounts, fee rates, transaction history. Activates on balance, holdings, PnL queries or reports.