pionex-trade

Pionex 交易技能

通过 pionex-trade-cli CLI 在 Pionex 上下达和管理现货订单。需要在 ~/.pionex/config.toml 中配置 API 凭据（请先运行 pionex-ai-kit onboard）。
安全提示：Pionex API 文档建议启用 IP 白名单，并且绝不分享 API Key/Secret。

前置条件

1. 安装 CLI 并配置凭据：

   npm install -g @pionex/pionex-ai-kit
   pionex-ai-kit onboard
   

2. 测试（只读）：

   pionex-trade-cli account balance
   

技能路由

• 市场数据（价格、深度、K 线、交易对信息）→ pionex-market
• 账户余额 → pionex-portfolio（或在下单前检查时使用此处的 pionex-trade-cli account balance）
• 下单／取消订单、查看未完成订单和成交记录 → pionex-trade（此技能）
• 期货网格机器人生命周期（创建／调整／减少／取消）→ pionex-bot

命令索引（此技能使用的订单和账户命令）

命令	类型	描述
pionex-trade-cli account balance	READ	所有现货余额（如有需要，可从 JSON 中按币种筛选）
pionex-trade-cli orders new --symbol <s> --side BUY|SELL --type MARKET|LIMIT [--amount | --size] [--price] [--dry-run]	WRITE	创建订单。市价买入：使用 --amount（计价币）；市价卖出／限价单：使用 --size（基础币）。限价单：添加 --price
pionex-trade-cli orders get --symbol <s> --order-id <id>	READ	按 ID 获取单个订单
pionex-trade-cli orders open --symbol <s>	READ	列出指定交易对的未完成订单
pionex-trade-cli orders all --symbol <s> [--limit <n>]	READ	订单历史（已成交／已取消）
pionex-trade-cli orders fills --symbol <s> [--startTime] [--endTime]	READ	成交记录（已执行的交易）
pionex-trade-cli orders fills_by_order_id --symbol <s> --order-id <id>	READ	指定订单的成交记录
pionex-trade-cli orders cancel --symbol <s> --order-id <id> [--dry-run]	WRITE	取消单个订单
pionex-trade-cli orders cancel_all --symbol <s> [--dry-run]	WRITE	取消指定交易对的所有未完成订单

下单前查看交易对信息（最小数量、精度）：使用 pionex-market → pionex-trade-cli market symbols --symbols BTC_USDT。

---

1. 何时使用此技能

用户希望执行以下操作时，请使用 pionex-trade：

• 下达现货订单（市价或限价买入／卖出）。
• 取消某个交易对的一个或所有订单。
• 查询未完成订单、订单历史或成交记录。

请勿用于：只查看价格或订单簿（使用 pionex-market）；只查看余额（使用 pionex-portfolio，或在交易流程中使用 pionex-trade-cli account balance）。

---

2. 通用规则

1. 明确参数 — 不要猜测交易对、方向或数量。如有不明确之处，请向用户询问：交易对（例如 BTC_USDT）、方向（BUY/SELL）、类型（MARKET/LIMIT）以及金额或数量。
2. 优先先试运行再确认 — 对于任何写入操作（新建订单、取消订单、cancel_all），在支持的情况下先使用 --dry-run 运行，向用户说明将执行的操作，然后在不带 --dry-run 的情况下运行前征求确认。
3. 未经告知，不要增加风险 — 未经用户明确同意，不得增加数量或添加额外订单。
4. 发生错误时 — 说明原因并建议后续步骤（例如将数量调整至最低要求，或检查余额）。

---

3. 根据余额处理订单

当用户要求按报价金额买入时（例如“用 1000 USDT 买入 BTC”）：

1. 检查余额

   pionex-trade-cli account balance
   

   从 JSON 结果中读取报价资产（例如 USDT）的可用余额。没有 --asset 标志；该命令会返回所有币种。

2. 与请求金额比较

   • 如果可用余额 < 请求金额：不要下单。告知用户可用余额和请求金额；建议减少金额或跳过。
   • 如果可用余额 ≥ 请求金额：继续下单流程（仍优先使用 dry-run，并征求用户确认）。

3. 示例

   • 用户：“用 1000 USDT 买入 BTC。”
   • Agent：运行 pionex-trade-cli account balance → 如果 USDT 可用余额是 600，则回复：“您有 600 USDT 可用，少于 1000。要改为用 600 USDT 市价买入吗？我会先使用 --dry-run。”
   • 只有用户确认后，才运行例如 pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type MARKET --amount 600（也可以先使用 --dry-run 运行，确认后再不带该参数运行）。

---

4. 最小下单量／“金额过小”错误

如果 API 返回有关最小订单数量或名义金额的错误（例如最小名义金额为 10 USDT）：

1. 获取交易对规则

   pionex-trade-cli market symbols --symbols BTC_USDT
   

   使用结果查看最小数量、最小名义金额和步长。

2. 建议有效数量 — 按要求的精度进行舍入，并确保名义金额 ≥ 最小名义金额。向用户说明：原始请求、交易所最低要求和建议数量。

3. 确认后重试 — 用户同意后，再次下单（优先先使用 --dry-run）。

---

5. 订单命令（准确 CLI）

• 市价买入（报价金额）
  pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type MARKET --amount 100

• 市价卖出（基础资产数量）
  pionex-trade-cli orders new --symbol BTC_USDT --side SELL --type MARKET --size 0.01

• 限价单
  pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type LIMIT --price 50000 --size 0.01

• 取消单笔订单
  pionex-trade-cli orders cancel --symbol BTC_USDT --order-id 123456

• 取消指定交易对的所有订单
  pionex-trade-cli orders cancel_all --symbol BTC_USDT
  运行前，先列出要取消的订单：pionex-trade-cli orders open --symbol BTC_USDT，然后向用户确认。

---

6. cancel_all 和批量操作

• 始终预览 — 在运行 pionex-trade-cli orders cancel_all --symbol <s> 前，先运行 pionex-trade-cli orders open --symbol <s>，并告知用户将取消多少个订单以及对应的交易对。
• 明确确认 — 例如：“这将取消 BTC_USDT 上的 3 个未成交订单。确认吗？”只有确认后，才在适用时不带 --dry-run 运行。

---

7. 总结

• pionex-trade 说明如何使用 pionex-trade-cli CLI 安全地提交和取消现货订单。
• 使用 pionex-trade-cli account balance 检查资金；使用 pionex-trade-cli market symbols（pionex-market）遵守最小数量／名义金额要求。
• 写入操作优先使用 --dry-run 并征求用户确认。未经用户明确同意，绝不增加风险。