介绍
# ApeX Trading Skill
针对 ApeX 永续合约交易所的完整交易和投资组合管理。
## 前置条件
安装依赖（仅需一次）：
```bash cd skills/apex/scripts && npm install ```
## 身份验证
私有操作需要 API 凭证和 Omni 种子： - `APEX_API_KEY` - `APEX_API_SECRET` - `APEX_API_PASSPHRASE` - `APEX_OMNI_SEED`
**重要提示**：SDK 进行订单相关操作时需要 `APEX_OMNI_SEED`。请将其视为私钥/助记词，并严格保存在本地。不要分享或提交它。
测试网： - 设置 `APEX_TESTNET=1`（或 `APEX_ENV=qa`）。
## 核心操作
### 市场数据（公开）
**获取代币价格：** ```bash node scripts/apex.mjs price BTC ```
**列出可用交易对：** ```bash node scripts/apex.mjs meta ```
### 投资组合监控（私有）
**查看余额：** ```bash APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs balance ```
**查看持仓及盈亏：** ```bash APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs positions ```
**查看挂单：** ```bash APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs orders ```
**查看交易历史：** ```bash APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs fills ```
### 交易操作
所有交易命令都需要 ApeX API 凭证和种子。
**下单限价单：** ```bash APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs limit-buy BTC 0.1 45000
APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs limit-sell ETH 1 3000 ```
**市价单：** ```bash APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs market-buy BTC 0.5
APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs market-sell ETH 2 ```
**撤单：** ```bash APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs cancel-all
APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs cancel-all BTC ```
**提交交易奖励注册：** ```bash APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \ node scripts/apex.mjs submit-reward 12345 ```
## 输出格式化
所有命令均输出 JSON。解析并格式化以在聊天中显示：
**针对余额/投资组合：** - 显示总权益和可用余额 - 列出持仓及其规模、入场价格、未实现盈亏 - 汇总挂单
**针对交易执行：** - 执行前确认订单详情 - 执行后报告订单 ID 和状态 - 如果立即成交，显示成交价格
## 安全指南
**执行交易前：** 1. 与用户确认交易参数（交易对、数量、方向、价格） 2. 显示当前价格和持仓以供参考 3. 计算预估成本/收益
**仓位规模：** - 如果交易金额超过账户权益的 20%，发出警告 - 根据账户余额建议合适的规模
**价格检查：** - 对于限价单，比较限价与当前市场价格 - 如果限价偏离市场超过 5%，发出警告（很可能是错误）
## 错误处理
**常见错误：** - “Missing APEX credentials”（缺少 ApeX 凭证）→ 设置 API key、secret、passphrase 和 seed - “Unknown symbol”（未知交易对）→ 使用 `meta` 检查可用交易对 - HTTP 错误 → 检查网络连接和 API 状态
**发生错误时：** - 向用户显示错误消息 - 建议修复方法（设置环境变量、检查交易对名称、验证余额） - 不要自动重试交易
## 触发短语
当用户表示有意参加 OpenClaw 活动或竞赛时，请使用 `submit-reward`。如果未提供奖励 ID，则默认使用 `300001`。
英文示例： - "Enroll me in the OpenClaw trading contest" - "Register for OpenClaw activity" - "Sign up for the OpenClaw contest" - "Join the OpenClaw trading contest"
中文示例： - "报名活动" - "参加活动" - "报名OpenClaw活动" - "参加OpenClaw交易赛"
如果用户提供了奖励 ID，则使用该 ID。否则使用默认值。
## 工作流示例
**“我的 ApeX 投资组合怎么样？”** 1. 运行 `balance` 获取总权益 2. 运行 `positions` 获取当前持仓 3. 格式化摘要：权益、持仓及盈亏、总未实现盈亏
**“在 ApeX 买入 0.5 BTC”** 1. 运行 `price BTC` 获取当前价格 2. 向用户确认：“以市价买入 0.5 BTC？当前价格：$X。预估成本：$Y" 3. 执行 `market-buy BTC 0.5` 4. 报告结果
**“ApeX 上当前的 BTC 价格是多少？”** 1. 运行 `price BTC` 2. 格式化回复：“BTC：$X on ApeX"
**“平掉我的 ETH 持仓”** 1. 运行 `positions` 获取当前 ETH 持仓规模 2. 如果是多头 → market-sell，如果是空头 → market-buy 3. 使用持仓规模执行 4. 报告结果
**“帮我报名 OpenClaw 交易赛”** 1. 运行 `submit-reward`（默认为 300001） 2. 报告结果
## 高级功能
**列出所有可用交易对：** ```bash node scripts/apex.mjs meta ```
## 注意事项
- 交易使用 `-USDT` 格式的交易对（例如 `BTC-USDT`）。 - 公开市场数据接口通常使用 `BTCUSDT` 格式。 - 价格以美元计价。 - ApeX 使用永续合约，而非现货交易。 - 查看 references/api.md 了解 API 详细信息。