crypto-com-exchange

Crypto.com Exchange 技能

使用 cdcx CLI 在 Crypto.com Exchange 上进行交易。涵盖现货、衍生品、高级订单、投资组合和钱包操作。

前提条件

1. 安装：npx @cryptocom/cdcx-cli@latest，或参阅 references/install.md
2. 身份验证：运行 cdcx auth login --oauth — 打开浏览器进行 OAuth，无需手动输入密钥
3. 验证：cdcx account summary -o json

如果 cdcx account summary 因“No credentials found”而失败，请立即通过 Bash 执行 cdcx auth login --oauth（为浏览器回调设置约 120 秒的超时时间）。

功能

领域	CLI 命令组	功能
市场数据	cdcx market	价格、订单簿、K 线、交易、交易品种 — 无需身份验证
订单执行	cdcx trade	下单、修改和取消 LIMIT 与 MARKET 订单
高级订单	cdcx advanced	带触发逻辑的 OCO、OTO、OTOCO 组合订单
投资组合	cdcx account	余额、仓位、子账户、盈亏
历史记录	cdcx history	订单历史、成交记录、交易记录
钱包	cdcx wallet	充值、提现、网络信息
保证金	cdcx margin	逐仓保证金划转、杠杆
质押	cdcx staking	质押/取消质押、兑换、奖励历史
法币	cdcx fiat	法币充值/提现、银行账户
模拟交易	cdcx paper	使用实时价格的本地模拟，无需身份验证
数据流	cdcx stream	实时 WebSocket 数据（NDJSON）

安全模型

每条命令都有一个安全等级。CLI 会自动执行相应的限制：

等级	行为	示例
read	可自由运行	cdcx market ticker、cdcx market book
sensitive_read	可自由运行（需要身份验证）	cdcx account summary、cdcx trade open-orders
mutate	需要 --yes 或 MCP acknowledged=true	cdcx trade order、cdcx trade amend
dangerous	MCP 服务需要 --allow-dangerous	cdcx trade cancel-all、cdcx wallet withdraw

实盘下单前，请务必使用 --dry-run 预览请求。

快速开始

查看余额

cdcx account summary -o json

获取市场价格

cdcx market ticker BTC_USDT -o json

下限价单

# Preview first
cdcx trade order BUY BTC_USDT 0.01 --type LIMIT --price 50000 --dry-run -o json

# Execute
cdcx trade order BUY BTC_USDT 0.01 --type LIMIT --price 50000 --client-oid my-buy-001 -o json

下市价单

cdcx trade order BUY BTC_USDT 0.01 --type MARKET -o json

取消订单

cdcx trade cancel --order-id 123456789 -o json
cdcx trade cancel --client-oid my-buy-001 -o json

修改订单

cdcx trade amend --order-id 123456789 --new-price 51000 --new-quantity 0.01 -o json

必须同时提供 --new-price 和 --new-quantity — 对于不想更改的字段，请重新提交原值。

市场数据（无需身份验证）

cdcx market ticker BTC_USDT -o json          # Current price
cdcx market ticker -o json                    # All instruments
cdcx market book BTC_USDT --depth 10 -o json  # Orderbook
cdcx market candlestick BTC_USDT --timeframe 1h --count 24 -o json  # OHLCV
cdcx market trades BTC_USDT -o json           # Recent prints
cdcx market instruments -o json               # All tradable pairs + tick sizes

支持的时间周期：1m, 5m, 15m, 30m, 1h, 4h, 6h, 12h, 1D, 7D, 14D, 1M

数据流（实时）

cdcx stream ticker BTC_USDT ETH_USDT   # NDJSON to stdout
cdcx stream book BTC_USDT
cdcx stream trades BTC_USDT

订单执行

位置参数：<side> <instrument> <quantity>。方向为 BUY 或 SELL。

# Limit order
cdcx trade order BUY BTC_USDT 0.01 --type LIMIT --price 50000 -o json

# Market order (buy by notional)
cdcx trade order BUY BTC_USDT --type MARKET --notional 500 -o json

# Batch (up to 10)
cdcx trade order-list --order-list '[
    {"instrument_name":"BTC_USDT","side":"BUY","type":"LIMIT","price":"49000","quantity":"0.01"},
    {"instrument_name":"BTC_USDT","side":"BUY","type":"LIMIT","price":"48000","quantity":"0.01"}
]' -o json

# List open orders
cdcx trade open-orders BTC_USDT -o json

# Close a position
cdcx trade close-position BTCUSD-PERP --type MARKET -o json

订单选项

标志	用途
--type	LIMIT 或 MARKET
--price	限价（字符串）
--notional	以计价货币表示的支出金额（MARKET BUY）
--client-oid	你的关联 ID（最多 36 个字符）
--time-in-force	GOOD_TILL_CANCEL、FILL_OR_KILL、IMMEDIATE_OR_CANCEL
--exec-inst	POST_ONLY、SMART_POST_ONLY、REDUCE_ONLY、ISOLATED_MARGIN
--dry-run	预览但不执行

高级订单（OCO / OTO / OTOCO）

OTOCO 组合订单（入场 + 止损 + 止盈）

cdcx advanced create-otoco '[
    {"instrument_name":"BTC_USDT","side":"BUY","type":"LIMIT","price":"50000","quantity":"0.01"},
    {"instrument_name":"BTC_USDT","side":"SELL","type":"STOP_LOSS","trigger_price":"48000","quantity":"0.01","ref_price_type":"MARK_PRICE"},
    {"instrument_name":"BTC_USDT","side":"SELL","type":"TAKE_PROFIT","trigger_price":"55000","quantity":"0.01","ref_price_type":"MARK_PRICE"}
]' --dry-run -o json

OTO（入场 + 保护）

cdcx advanced create-oto '[
    {"instrument_name":"BTC_USDT","side":"BUY","type":"LIMIT","price":"50000","quantity":"0.01"},
    {"instrument_name":"BTC_USDT","side":"SELL","type":"STOP_LOSS","trigger_price":"48000","quantity":"0.01","ref_price_type":"MARK_PRICE"}
]' -o json

OCO（为现有仓位设置双向退出订单）

cdcx advanced oco '[
    {"instrument_name":"BTC_USDT","side":"SELL","type":"LIMIT","price":"55000","quantity":"0.01"},
    {"instrument_name":"BTC_USDT","side":"SELL","type":"STOP_LOSS","trigger_price":"48000","quantity":"0.01","ref_price_type":"MARK_PRICE"}
]' -o json

单个触发订单

cdcx advanced order BTCUSD-PERP --side SELL --type STOP_LOSS --quantity 0.01 --trigger-price 48000 --ref-price-type MARK_PRICE -o json

管理高级订单

cdcx advanced open-orders BTC_USDT -o json
cdcx advanced order-detail --order-id <id> -o json
cdcx advanced cancel-otoco --list-id <list_id> -o json
cdcx advanced cancel-oco --list-id <list_id> -o json
cdcx advanced cancel-oto --list-id <list_id> -o json

投资组合与账户

cdcx account summary -o json                # Cash balances
cdcx account positions -o json              # Open positions + unrealized P&L
cdcx account info -o json                   # Master + sub-accounts
cdcx account subaccount-balances -o json    # Per-sub-account
cdcx account balance-history --timeframe D1 -o json  # Equity curve

# Fee rates
cdcx trade fee-rate -o json
cdcx trade instrument-fee-rate --instrument-name BTC_USDT -o json

# History
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

钱包操作

# Deposit
cdcx wallet networks -o json                        # Supported networks
cdcx wallet deposit-address BTC -o json             # Get address
cdcx wallet deposit-history -o json                 # Track arrivals

# Withdraw (dangerous tier)
cdcx wallet withdraw BTC 0.1 <ADDRESS> --network-id BITCOIN --dry-run -o json
cdcx wallet withdraw BTC 0.1 <ADDRESS> --network-id BITCOIN --client-wid my-wd-001 -o json
cdcx wallet withdrawal-history -o json

提现需要使用白名单地址（在 Exchange 网页版界面中配置）。

逐仓保证金

对于需要逐仓保证金的交易品种（例如 SPYUSD-PERP、NVDAUSD-PERP）：

cdcx trade order BUY SPYUSD-PERP 0.001 --type LIMIT --price 710.25 --exec-inst ISOLATED_MARGIN -o json

# Fund/withdraw margin
cdcx margin transfer --direction IN --amount 100 <ISOLATION_ID>
cdcx margin transfer --direction OUT --amount 50 <ISOLATION_ID>

# Adjust leverage
cdcx margin leverage --leverage 5 <ISOLATION_ID>

通过 cdcx account positions -o json 获取 isolation_id。

模拟交易（无需身份验证）

cdcx paper init --balance 50000
cdcx paper buy BTC_USDT --quantity 0.01 -o json
cdcx paper sell BTC_USDT --quantity 0.01 -o json
cdcx paper positions -o json
cdcx paper balance -o json
cdcx paper history -o json
cdcx paper reset --balance 100000

操作示例

晨间简报

cdcx market ticker -o json                          # Market snapshot
cdcx account summary -o json                        # Cash
cdcx account positions -o json                      # Open positions
cdcx trade open-orders -o json                      # Pending orders
cdcx advanced open-orders -o json                   # Advanced orders
cdcx history trades --start-time $(date -v-1d +%s)000 -o json  # Yesterday's fills

紧急平仓

执行前需要获得用户明确确认 — 此操作会取消所有订单，并以市价平掉所有仓位。

cdcx trade cancel-all --yes -o json                 # Cancel all orders
cdcx advanced cancel-all --yes -o json              # Cancel all advanced
cdcx account positions -o json | \
    jq -r '.data[].instrument_name' | \
    while read i; do cdcx trade close-position "$i" --type MARKET --yes; done
cdcx account positions -o json                      # Verify flat

重要说明

• 交易品种名称区分大小写：使用 BTC_USDT，而非 btc_usd。现货使用 _（例如 BTC_USDT），永续合约使用 -PERP（例如 BTC-PERP）
• API 中的价格为字符串，进行算术运算前请转换为浮点数或十进制数
• 行情响应中的 c 是比率，不是百分比：0.0257 表示 +2.57%
• 始终提供 --client-oid，以便关联订单
• close-position 为异步操作，之后请通过 cdcx account positions 确认
• 高级订单使用独立命名空间，在 cdcx trade open-orders 中不可见
• 每次调用最多可批量处理 10 个订单
• OTOCO 结构：第 1 段 = 入场限价单，第 2 段 = 止损触发单，第 3 段 = 止盈触发单
• OTO 的第二段必须是触发类型（STOP_LOSS、STOP_LIMIT、TAKE_PROFIT、TAKE_PROFIT_LIMIT）
• get-open-orders 不支持分页，会返回所有未结订单
• 提币金额为总额（手续费从中扣除）
• 对于需要备注的币种（XRP、XLM、EOS），始终包含 --address-tag

Agent 行为

1. 对新策略执行实盘订单前，始终先使用 --dry-run
2. 在生产环境执行任何 mutate 级操作前，先征求用户确认，并要求其回复“CONFIRM”
3. 切勿显示完整 API 密钥；请掩盖凭据（密钥保留前 5 位和后 4 位，Secret 仅保留最后 5 位）
4. 默认使用 --output json，以便程序处理
5. 下单前使用 cdcx market instruments 确认最小变动单位
6. 下单前使用 cdcx account summary 检查可用余额
7. 对于流式数据，优先使用 cdcx stream，而非轮询