ApeX 交易技能

为 ApeX 永续期货交易所提供完整的交易和投资组合管理。

先决条件

一次性安装依赖项：

cd skills/apex/scripts && npm install

身份验证

私有操作需要 API 凭证和一个 Omni 种子：

• APEX_API_KEY
• APEX_API_SECRET
• APEX_API_PASSPHRASE
• APEX_OMNI_SEED

重要提示：APEX_OMNI_SEED是 SDK 执行订单相关操作所必需的。请将其视为私钥/种子短语，并严格保存在本地。不要分享或提交它。

测试网：

• 设置APEX_TESTNET=1（或APEX_ENV=qa）。

核心操作

市场数据（公开）

获取币种价格：

node scripts/apex.mjs price BTC

列出可用交易对：

node scripts/apex.mjs meta

投资组合监控（私有）

查询余额：

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs balance

查看持仓及盈亏情况：

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs positions

查看未成交订单：

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs orders

查看交易历史：

APEX_API_KEY=... APEX_API_SECRET=... APEX_API_PASSPHRASE=... APEX_OMNI_SEED=... \
  node scripts/apex.mjs fills

交易操作

所有交易指令均需提供ApeX API凭证及密钥种子。

下达限价订单：

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

市价订单：

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

撤销订单：

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

提交交易奖励登记：

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%（可能是错误）则发出警告

错误处理

常见错误：

• "缺少APEX凭证" → 设置API密钥、密钥、密码短语和种子
• "未知交易品种" → 使用元数据
• 检查可用交易品种

HTTP错误 → 检查网络连接和API状态

• 发生错误时：
• 建议修复（设置环境变量、检查符号名称、验证余额）
• 不要自动重试交易

触发短语

使用submit-reward当用户表达参加 OpenClaw 活动或比赛的意图时。如果未提供奖励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。否则使用默认值。

工作流示例

"How's my ApeX portfolio?"

1. 运行余额以获取总权益
2. 运行持仓以获取未平仓头寸
3. 汇总格式：权益、持仓及盈亏、总未实现盈亏

"在ApeX买入0.5 BTC"

1. 运行BTC价格以获取当前价格
2. 向用户确认："以市价买入0.5 BTC？当前价格：$X。预估成本：$Y"
3. 执行市价买入 BTC 0.5
4. 报告结果

"ApeX上BTC当前价格是多少？"

1. 运行BTC价格
2. 响应格式："ApeX上BTC价格：$X"

"平掉我的ETH头寸"

1. 运行持仓以获取当前ETH头寸规模
2. 若为多头 → 市价卖出，若为空头 → 市价买入
3. 使用仓位大小执行
4. 报告结果

"报名参加OpenClaw交易大赛"

1. 运行提交奖励（默认为300001）
2. 报告结果

高级功能

列出所有可用交易对：

node scripts/apex.mjs meta

注意事项

• 交易对使用-USDT格式进行交易（例如，BTC-USDT）。
• 公共市场数据接口通常使用BTCUSDT格式。
• 价格以美元计价。
• ApeX使用永续期货合约，而非现货交易。
• 查看 references/api.md 获取API详情。