SuperAPI AI 工具集

cdcx-check-balance

智能体与模型

查看项目

更新于 10-15 20:29

技能介绍

用途:在交易流程开始前确认凭据可用,并向用户报告当前钱包余额,也可用于脚本门控,例如仅在可用 USDT 超过某阈值时才下单。该技能需要认证。

主要能力:通过 cdcx account summary -o json 获取完整余额快照,返回账户级 total_available_balance 与 total_margin_balance,以及 position_balances[] 中各币种的 quantity、market_value 等明细;通过 cdcx account subaccount-balances -o json 查询主账户下所有子账户余额。

使用方式:先做预检,运行 cdcx account info -o json > /dev/null 2>&1 && echo ok || echo "auth not configured",失败时引导用户执行 cdcx setup 或使用 cdcx-auth-setup 技能。查询单币种可用 jq 过滤 position_balances;也可用 jq 生成汇总行或逐行列出所有币种。脚本门控示例:先取 total_available_balance,再用 awk 判断是否大于阈值,满足则执行 cdcx trade order BUY BTC_USDT 0.001 --type MARKET -o json,否则输出余额不足。

适用场景:交易前凭据校验、余额报告、按余额条件触发交易、多账户运维。

限制与注意:total_margin_balance 和 total_available_balance 以 USD 计价,position_balances[].quantity 为原生币种数量;position_balances 是逐币种余额明细,不要与衍生品持仓(cdcx account positions)混淆;cdcx account summary 属于 tier sensitive_read,在 MCP 模式下无需确认。其他细节暂未提供。