cdcx-portfolio-intel

name	cdcx-portfolio-intel
description	Read-only portfolio analysis — balances, positions, P&L, sub-accounts, fee rates, transaction history

Portfolio Intelligence

When to Use

• User asks "what's my balance" / "what do I hold" / "how much PnL"
• Portfolio report or daily wrap-up
• Sub-account overview
• Fee tier or transaction history lookup

Requires authentication (CDCX_API_KEY/CDCX_API_SECRET or a configured profile).

Tools Used

Tool	Purpose	Tier
cdcx_account_summary	Wallet balances (cash per currency)	sensitive_read
cdcx_account_balance_history	Historical balance snapshots	sensitive_read
cdcx_account_positions	Open positions with unrealized P&L	sensitive_read
cdcx_account_info	Master account + sub-accounts	sensitive_read
cdcx_account_subaccount_balances	Per-sub-account balances	sensitive_read
cdcx_trade_fee_rate	Account fee tier	sensitive_read
cdcx_trade_instrument_fee_rate	Instrument-specific fee rate	sensitive_read
cdcx_account_orders	Historical orders	sensitive_read
cdcx_account_trades	Historical fills	sensitive_read
cdcx_account_transactions	All transactions (fills, funding, etc)	sensitive_read
cdcx_market_ticker	Mark prices for P&L valuation	read

Note: MCP tool names beginning with cdcx_account_orders/cdcx_account_trades/cdcx_account_transactions correspond to the history schema group which the account MCP service group also exposes.

Workflow

Quick Balance Check

cdcx account summary -o json

Returns per-currency balance with balance, available, reserved_qty, collateral_amount.

Full Portfolio Report

# 1. Cash
cdcx account summary -o json

# 2. Open positions (derivatives + margin)
cdcx account positions -o json

# 3. Mark prices for valuation
cdcx market ticker -o json

Combine: total equity = cash + Σ (position size × mark price) + Σ unrealized P&L. Break down by instrument; call out largest winners/losers.

Position Detail for One Instrument

cdcx account positions BTCUSD-PERP -o json

Historical Trades and Orders

cdcx history orders BTC_USDT --limit 50 -o json
cdcx history trades BTC_USDT --limit 50 -o json
cdcx history transactions --limit 100 -o json

Time windows via --start-time / --end-time (ms since epoch).

Fee Analysis

cdcx trade fee-rate -o json                      # Account tier
cdcx trade instrument-fee-rate --instrument-name BTC_USDT -o json

Note: fee-rate commands live under trade, not account.

Sub-Account Management

cdcx account info -o json                        # List master + sub-accounts
cdcx account subaccount-balances -o json         # Balances per sub-account
cdcx account subaccount-transfer \
    --from <sub_uuid_a> --to <sub_uuid_b> \
    --currency USDT --amount 1000                # Transfer (mutate)

subaccount-transfer is tier mutate — requires acknowledged=true in MCP mode.

Balance History (Equity Curve)

cdcx account balance-history --timeframe D1 -o json

Returns daily snapshots for building an equity curve chart.

Notes

• account summary shows cash; account positions shows open derivatives/margin positions — both are needed for a full equity view
• All read endpoints are safe to call repeatedly; no write effects
• subaccount-transfer moves real funds — treat as a mutate
• Fee-rate commands were moved to the trade group by the upstream API; don't expect them under account