Crypto Com 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`