介绍
# Kraken Crypto Skill
使用 kraken_cli.py 包装器查询您的 Kraken 账户。
## 设置
导出您的 Kraken API 凭证。
```bash export KRAKEN_API_KEY="your_api_key" export KRAKEN_API_SECRET="your_api_secret" ```
您也可以在技能目录中创建一个 .env 文件。
## 1. 主要命令
使用这些命令进行投资组合查询。它们会自动计算总额。
| 命令 | 描述 | |---------|-------------| | summary | 包含正确总额的投资组合概览 | | net-worth | 总净资产计算 | | performance | 收益与存款的对比 | | holdings | 包含美元价值的资产细分 | | staking | 质押仓位和奖励 |
### 示例输出 summary
``` TOTAL NET WORTH Main Wallet (Equity): $544.95 Earn Wallet (Bonded): $81.89 TOTAL: $626.84
AUTO EARN (Flexible) in Main Wallet BTC : $493.92 (rewards: $0.03) ETH : $50.66 (rewards: $0.11)
BONDED STAKING in Earn Wallet SOL : $66.73 (rewards: $0.89) DOT : $15.16 (rewards: $0.55)
Total Staking Rewards: $1.71 ```
该包装器将 Auto Earn 与 Bonded staking 分开，以避免重复计算。
## 2. 原始 API 命令
这些命令使用 kraken_api.py 获取详细数据。请将它们用于主要命令未涵盖的特定信息。
### 市场数据 公共
| 命令 | 描述 | 用例 | |---------|-------------|----------| | ticker --pair XXBTZUSD | 当前价格和 24 小时统计数据 | 价格查询 | | ohlc --pair XXBTZUSD | 历史蜡烛图 | 图表数据 | | depth --pair XXBTZUSD | 订单簿 | 流动性分析 | | recent-trades --pair XXBTZUSD | 实时交易 | 市场活动 | | assets | 资产名称和小数位数 | 资产查询 | | pairs | 有效的交易对 | 交易对发现 | | status | 交易所状态 | 连接检查 | | time | 服务器时间 | API 健康检查 |
### 账户数据 私有
| 命令 | 描述 | 用例 | |---------|-------------|----------| | balance | 原始资产数量 | 详细持仓 | | balance-ex | 包含保留资金的余额 | 保证金分析 | | portfolio | 美元计价的交易余额 | 原始权益数据 | | open-orders | 活跃订单 | 订单管理 | | closed-orders | 已完成订单 | 订单历史 | | trades | 交易执行历史 | 交易分析 | | ledger | 所有交易 | 交易跟踪 | | ledger --asset ZUSD | 按资产筛选 | 资产历史 | | volume | 30 天交易量 | 费用等级信息 |
### 赚取收益数据 私有
| 命令 | 描述 | 用例 | |---------|-------------|----------| | earn-positions | 原始质押分配 | 详细质押数据 | | earn-strategies | 可用的收益计划 | 策略发现 | | earn-status | 待处理的质押 | 分配监控 | | earn-dealloc-status --refid ID | 待处理的取消质押 | 解除分配监控 |
### 充值 私有
| 命令 | 描述 | 用例 | |---------|-------------|----------| | deposits-methods | 可用的充值方式 | 充值选项 | | deposits-address --asset BTC | 钱包地址 | 接收加密货币 |
## 3. 重要注意事项
### 重复计算警告
请勿将 balance 和 earn-positions 相加。
Kraken 有两种质押类型。 - Auto Earn 灵活资产保留在主钱包中。这些包含在投资组合权益中。 - Bonded Staking 资产会转移到 Earn 钱包中。这些不包含在投资组合权益中。
summary 命令正确处理了这一点。如果您手动使用原始命令，请遵循此逻辑。 - 正确的计算方式是 总额 等于 投资组合权益 加上 仅限 Bonded Earn。 - 错误的计算方式是 总额 等于 投资组合权益 加上 所有 Earn 分配。
### API 响应说明
- ohlc 在交易对键下返回一个列表。 - depth bids 和 asks 嵌套在交易对键下。 - recent-trades 返回一个包含价格、成交量、时间、方向、类型和其他信息的列表。 - earn-strategies 使用带有 apr_estimate 的 items 键。
## 4. 示例用法
| 用户请求 | 机器人操作 | |--------------|------------| | 我的加密货币投资组合怎么样？ | 运行 summary | | 我的净资产是多少？ | 运行 net-worth | | 我的表现如何？ | 运行 performance | | 显示我的持仓 | 运行 holdings | | 显示我的质押情况 | 运行 staking | | BTC 价格是多少？ | 运行 ticker --pair XXBTZUSD | | 显示我的挂单 | 运行 open-orders | | 显示我的交易历史 | 运行 trades | | 获取我的 BTC 充值地址 | 运行 deposits-address --asset BTC |
## 5. 所需的 API 密钥权限
| 功能 | 权限 | |---------|------------| | 余额和投资组合 | Query Funds | | 订单、交易和账本 | Query Funds | | Earn 分配 | Earn | | 充值地址 | Query Funds | | 市场数据 | 无 |