📦 pionex-trade — Pionex现货交易

通过 pionex-trade-cli CLI 在 Pionex 进行现货下单和管理。需要 ~/.pionex/config.toml 中的API凭证（先运行 pionex-ai-kit onboard）。

安全提示：Pionex API文档 推荐IP白名单，切勿分享您的API Key/Secret。

前置条件

• 安装CLI并配置凭证：

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

• 测试（只读）：

pionex-trade-cli account balance

技能路由

• 市场数据（价格、深度、K线、符号信息）→ pionex-market
• 账户余额 → pionex-portfolio（或在下单前使用 pionex-trade-cli account balance）
• 下单/撤单、开放订单、成交记录 → pionex-trade（本技能）
• 合约网格机器人生命周期（创建/调整/减少/取消）→ pionex-bot

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

命令	类型	描述
pionex-trade-cli account balance	读取	所有现货余额（如需要可按货币从JSON过滤）
pionex-trade-cli orders new --symbol --side BUY	SELL --type MARKET	LIMIT [--amount	--size] [--price] [--dry-run	写入	创建订单。MARKET买入：使用--amount（计价货币）。MARKET卖出/LIMIT：使用--size（基础货币）。LIMIT：添加--price
pionex-trade-cli orders get --symbol --order-id	读取	按ID获取一个订单
pionex-trade-cli orders open --symbol	读取	列出符号的开放订单
pionex-trade-cli orders all --symbol [--limit ]	读取	订单历史（已成交/已取消）
pionex-trade-cli orders fills --symbol [--startTime] [--endTime]	读取	成交记录（已执行交易）
pionex-trade-cli orders fills_by_order_id --symbol --order-id	读取	特定订单的成交记录
pionex-trade-cli orders cancel --symbol --order-id [--dry-run]	写入	取消一个订单
pionex-trade-cli orders cancel_all --symbol [--dry-run]	写入	取消符号的所有开放订单

下单前获取符号信息（最小数量、精度）：使用 pionex-market → pionex-trade-cli market symbols --symbols BTC_USDT。

---

1. 何时使用本技能

用户想要以下操作时使用 pionex-trade：

• 下现货订单（market或limit买入/卖出）。
• 取消一个订单或符号的所有订单。
• 查询开放订单、订单历史或成交记录。

不要用于：

• 仅查看价格或订单簿（使用pionex-market）；仅查看余额（pionex-portfolio，或作为交易流程一部分使用pionex-trade-cli account balance）。

---

2. 一般规则

• 明确参数 — 不要猜测符号、方向或数量。如果不明确，向用户询问：符号（如BTC_USDT）、方向（BUY/SELL）、类型（MARKET/LIMIT）、数量或大小。
• 优先dry-run然后确认 — 对于任何写操作（新订单、cancel、cancel_all），在支持时先使用--dry-run运行，向用户展示将执行什么，然后在不带--dry-run运行前请求确认。
• 不增加风险而不告知用户 — 未经用户明确同意，不增大数量、不额外下单。
• 出错时 — 解释并建议后续步骤（如调整到最小数量，或检查余额）。

---

3. 余额感知的订单流程

当用户要求用计价货币买入时（如"用1000 USDT买入BTC"）：

• 检查余额

pionex-trade-cli account balance

从JSON结果中读取计价货币（如USDT）的可用余额。命令无--asset标志；返回所有货币。

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

• 示例
• 用户：“用1000 USDT买入BTC。”
• 智能体：运行pionex-trade-cli account balance → 如果USDT可用为600，回复：“您的可用USDT为600，少于1000。是否改为用600 USDT下单market买入？我会先用--dry-run。”
• 仅在用户确认后，运行如pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type MARKET --amount 600（也可选择先带--dry-run运行，确认后不带运行）。

---

4. 最小数量/"金额太小"错误

如果API返回关于最小订单数量或名义价值的错误（如最小名义价值10 USDT）：

• 获取符号规则

pionex-trade-cli market symbols --symbols BTC_USDT

使用结果查看最小数量、最小名义价值、步长。

• 建议有效数量 — 四舍五入到所需精度并确保名义价值 ≥ 最小名义价值。向用户解释：原始请求、交易所最小值和建议的数量。

• 确认后重试 — 用户同意后，重新下单（优先--dry-run先试）。

---

5. 订单命令（精确CLI）

• Market买入（计价金额）

pionex-trade-cli orders new --symbol BTC_USDT --side BUY --type MARKET --amount 100

• Market卖出（基础数量）

pionex-trade-cli orders new --symbol BTC_USDT --side SELL --type MARKET --size 0.01

• Limit订单

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 前，运行pionex-trade-cli orders open --symbol 并向用户展示有多少订单以及是哪个符号。

• 明确确认 — 如“这将取消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和用户确认。未经用户明确同意，绝不增加风险。