核心用法
Kraken Pro Skill 是一款面向 Kraken 交易所用户的命令行工具,通过 Python SDK 封装官方 REST API,覆盖投资组合管理、市场行情、交易执行、收益质押(Earn/Staking)、资金存取及完整的账本导出功能。
安装与配置:依赖 python3 与 python-kraken-sdk,通过环境变量或 OpenClaw 配置注入 KRAKEN_API_KEY / KRAKEN_API_SECRET。API 密钥需于 Kraken 网页端安全设置中生成,并按需分配权限(Query Funds / Create Orders / Withdraw Funds 等)。
主要功能模块:
- 组合概览:
summary/net-worth/holdings智能区分 Auto Earn(灵活收益,计入交易余额)与 Bonded Staking(锁定质押,独立钱包),计算真实总资产 - 市场数据:无需认证即可查询实时价格(ticker)、交易对(pairs)、资产列表(assets);注意 Kraken 使用非标准命名如 XBT、ZUSD
- 交易执行:支持限价/市价买卖,强制
--confirm确认,--validateDry-run 预检;批量撤单与订单管理 - 质押收益:查看持仓、策略、执行分配/赎回;注意 Bonded Staking 需手动计算入总资产
- 资金操作:存款地址查询、提款至预配置地址(API 无法新增地址,需网页端预先保存)
- 税务导出:
ledger支持日期区间、资产类型、交易类型过滤,自动分页,原生 CSV 导出;trades --csv导出成交记录
显著优点
1. 功能完整度高:覆盖个人投资者核心需求——从价格监控、组合估值到税务合规导出,一站式 CLI 完成
2. 资产计算准确:针对 Kraken 双钱包机制(Trade Balance vs Earn Wallet)设计专用逻辑,避免收益资产漏算或重复计算
3. 安全设计严谨:交易与提款强制 --confirm 交互确认,Dry-run 预检机制降低误操作风险;权限粒度映射清晰
4. 自动化友好:--json 原始输出、--csv 标准格式、自动分页处理,便于对接脚本与会计软件
潜在缺点与局限性
- 命名体系复杂:Kraken 使用 XBT、ZUSD 等非标准代码,新用户需适应或频繁查询
pairs --json - API 功能受限:无法通过 API 添加提款地址,必须预配置于网页端;无法列出已保存地址名称,需用户手动提供 key
- 链上资产隔离:同一钱包多链地址(如 SOL 链 USDC 与原生 USDC)需分别配置,易因误配导致提款失败
- 无实时流数据:仅 REST 轮询,无 WebSocket 行情推送,高频策略存在延迟
适合人群
- 持有 Kraken 账户、追求效率的活跃交易者与 DeFi 耕作者
- 需定期导出交易记录进行税务申报的个人或小型机构
- 希望用脚本自动化组合监控、定期报告或条件触发的技术型用户
- 对 CLI 操作有一定熟悉度,能接受非图形化交互的投资者
常规风险
- API 密钥泄露:密钥具备提款权限时,泄露即意味着资金直接风险;建议启用 IP 白名单、最低权限原则、独立子账户
- 误操作交易:尽管有
--confirm,脚本自动化时若逻辑错误仍可能触发非预期订单;生产环境务必先用--validate - 汇率与计价:Kraken 以美元本位计价,非美元用户需注意汇率换算与本地税务申报要求
- 质押流动性:Bonded Staking 通常有解锁期,
earn-deallocate非即时到账,大额资金规划需预留时间窗口