用途:通过 cdcx CLI 在 Crypto.com Exchange 进行交易与账户管理,覆盖行情、现货、衍生品、高级订单、投资组合和钱包操作。
安装与认证:安装 npx @cryptocom/cdcx-cli@latest;认证运行 cdcx auth login --oauth,会打开浏览器完成 OAuth,无需手动输入密钥;用 cdcx account summary -o json 验证。若提示 No credentials found,可立即通过 Bash 执行 cdcx auth login --oauth(浏览器回调约 120 秒超时)。
主要能力:行情(cdcx market,价格、订单簿、K线、成交、交易对,无需认证);下单(cdcx trade 限价/市价、改单撤单);高级订单(cdcx advanced 的 OCO、OTO、OTOCO 括号单);账户(cdcx account 余额、持仓、子账户、盈亏);历史(cdcx history);钱包(cdcx wallet 充值、提现、网络信息);逐仓杠杆(cdcx margin);质押(cdcx staking);法币(cdcx fiat);模拟交易(cdcx paper,本地模拟使用实时价格,无需认证);实时流(cdcx stream,WebSocket NDJSON)。
安全模型:命令分四级,read 与 sensitive_read 可直接运行;mutate 需 --yes 或 MCP acknowledged=true;dangerous 需 MCP 服务器上的 --allow-dangerous。执行真实订单前先用 --dry-run 预览。
常用用法示例:查价 cdcx market ticker BTC_USDT -o json;查余额 cdcx account summary -o json;市价单 cdcx trade order BUY BTC_USDT 0.01 --type MARKET -o json。
注意事项:交易对名称区分大小写(BTC_USDT);价格以字符串返回;ticker 的 c 是比率而非百分比;下单建议带 --client-oid;close-position 异步,需用 cdcx account positions 确认;高级订单不在 trade open-orders 中显示;批量最多 10 单;提现需在白名单地址且数量为含手续费的总额;memo 币种需带 --address-tag。流式数据优先于轮询。代理行为:新策略先 --dry-run,生产环境 mutate 前请用户确认,默认 -o json 输出,不展示完整密钥。