pionex-bot

Pionex 机器人技能

此技能用于 Pionex 机器人的生命周期操作：期货网格（获取、创建、调整、缩减、取消）、现货网格（获取、get_ai_strategy、创建、adjust_params、invest_in、取消、收益）、智能跟单（获取、创建、check_params、取消）以及用户自定义信号的 CRUD（列出、获取、创建、编辑、删除）。还可将交易信号推送到 Pionex 信号平台。

路由

• 机器人生命周期（期货网格）-> pionex-bot（此技能）
• 机器人生命周期（现货网格）-> pionex-bot（此技能）
• 机器人生命周期（智能跟单）-> pionex-bot（此技能）
• 用户自定义信号管理（列出/获取/创建/编辑/删除）-> pionex-bot（此技能）
• 将交易信号推送到信号平台（信号提供方角色）-> pionex-bot（此技能）
• 市场数据 -> pionex-market
• 现货余额 -> pionex-portfolio
• 现货订单下单/取消 -> pionex-trade

命令

命令	类型	描述
pionex-trade-cli bot order_list [--status running|finished] [--base BTC] [--quote USDT] [--page-token <token>] [--bu-order-types futures_grid,spot_grid,smart_copy]	READ	列出机器人订单，支持可选筛选条件和分页
pionex-trade-cli bot futures_grid get --bu-order-id <id>	READ	查询一个合约网格机器人订单
pionex-trade-cli bot futures_grid create --base BTC --quote USDT --bu-order-data-json '<json>' [--dry-run]	WRITE	创建合约网格机器人
pionex-trade-cli bot futures_grid check_params --base <BASE> --quote <QUOTE> --bu-order-data-json '<json>'	READ	创建前验证合约网格参数。若返回 FailedWithData，则显示 min_investment / max_investment / slippage。
pionex-trade-cli bot futures_grid adjust_params --body-json '<json>' [--dry-run]	WRITE	增加投资额 / 修改区间 / 触发追加投资
pionex-trade-cli bot futures_grid reduce --body-json '<json>' [--dry-run]	WRITE	减少机器人仓位
`pionex-trade-cli bot futures_grid cancel --bu-order-id [--close-sell-model TO_QUOTE\	TO_USDT] [--dry-run]`	WRITE
pionex-trade-cli bot spot_grid get --bu-order-id <id>	READ	查询一个现货网格机器人订单
pionex-trade-cli bot spot_grid get_ai_strategy --base <BASE> --quote <QUOTE>	READ	获取交易对的 AI 推荐网格参数
pionex-trade-cli bot spot_grid create --base <BASE> --quote <QUOTE> --bu-order-data-json '<json>' [--dry-run]	WRITE	创建新的现货网格机器人
pionex-trade-cli bot spot_grid check_params --base <BASE> --quote <QUOTE> --bu-order-data-json '<json>'	READ	创建前验证现货网格参数。若返回 FailedWithData，则显示 min_investment / max_investment / slippage。
pionex-trade-cli bot spot_grid adjust_params --body-json '<json>' [--dry-run]	WRITE	修改网格价格区间
pionex-trade-cli bot spot_grid invest_in --body-json '<json>' [--dry-run]	WRITE	向运行中的现货网格机器人追加资金
pionex-trade-cli bot spot_grid cancel --bu-order-id <id> [--dry-run]	WRITE	取消并平掉现货网格机器人
pionex-trade-cli bot spot_grid profit --body-json '<json>' [--dry-run]	WRITE	提取累计网格收益
pionex-trade-cli bot smart_copy get --bu-order-id <id>	READ	查询一个智能跟单机器人订单
pionex-trade-cli bot smart_copy check_params --base <BASE> --quote <QUOTE> --leverage <n> --quote-investment <amount> [--signal-type <uuid>] [--signal-param <json>]	READ	验证智能跟单参数。使用 --quote-investment 0 仅获取投资额范围。若返回 FailedWithData，则显示限制条件。
pionex-trade-cli bot smart_copy create --base <BASE> --quote <QUOTE> --bu-order-data-json '<json>' [--copy-from <id>] [--copy-type <type>] [--note <note>] [--dry-run]	WRITE	创建智能跟单机器人（投资组合模型）
pionex-trade-cli bot smart_copy cancel --bu-order-id <id> [--close-note <note>] [--convert-into-earn-coin] [--dry-run]	WRITE	取消并平掉智能跟单机器人
pionex-trade-cli bot signal listener --signal-type <uuid> --signal-param <json> --base <BASE> --quote <QUOTE> --time <iso> --price <price> --action <buy|sell> --position-size <size> --contracts <n> [--direction <dir>] [--dry-run]	WRITE	向 Pionex 信号平台推送交易信号（信号提供者角色）
pionex-trade-cli bot signal user_signal_list [--page-token <token>]	READ	列出用户自定义信号（分页）
pionex-trade-cli bot signal user_signal_get --signal-type <uuid>	READ	获取用户自定义信号详情（webhookUrl、TradingView 模板）
pionex-trade-cli bot signal user_signal_create --title <title> [--description <desc>] [--dry-run]	WRITE	创建新的用户自定义信号（每位用户最多 100 个）
pionex-trade-cli bot signal user_signal_edit --signal-type <uuid> --title <title> | --description <desc> [--dry-run]	WRITE	编辑用户自定义信号的标题或描述
pionex-trade-cli bot signal user_signal_delete --signal-type <uuid> [--dry-run]	WRITE	删除用户自定义信号（存在未平仓订单时会失败）

安全规则

1. 在不使用 --dry-run 运行之前，先确认用户确实希望执行创建／调整／减少／取消操作。
2. 调用 create 之前，先调用 check_params 验证参数。如果响应为 FailedWithData，重试前向用户展示返回的 min_investment、max_investment 和 slippage 值。注意：当 extraMargin=true（自动拆分模式）时，min_investment／max_investment 表示总输入范围（交易资金 + 安全缓冲）；当 extraMargin=false（手动模式）时，它们仅表示交易资金。务必告知用户适用哪种解释。
3. 切勿推断 buOrderId、杠杆、范围或金额；必须要求用户明确提供这些值。
4. 如果 API 拒绝参数，应向用户展示准确错误，并提供修正后的载荷建议。

现货网格专属规则

5. 如果用户没有明确提供价格范围和行数，在调用 create 之前先调用 get_ai_strategy。
6. 切勿在现货网格载荷中添加 leverage、trend 或 extraMargin 字段——现货网格不使用杠杆。
7. 创建或追加投资之前，确认账户的基础币和计价币余额充足。
8. invest_in 和 profit 是独立命令——不要与 adjust_params 混淆。

智能跟单专属规则

9. buOrderData 中的 portfolio 数组不能为空；每个条目都必须包含 base、signal_type（UUID）和 leverage（整数）。
10. 切勿推断 signal_type UUID；必须要求用户明确提供。
11. create 中的 --copy-from <id> 会复制现有智能跟单订单的参数——仅在用户明确要求时使用。
12. cancel 中的 --convert-into-earn-coin 会将持仓转换为 Earn 产品——使用前先向用户确认。
13. check_params 使用扁平标志（--leverage、--quote-investment），而不是 --bu-order-data-json。使用 --quote-investment 0 可查询投资范围，而不验证特定金额。

信号专属规则

14. bot signal listener 会推送交易信号至 Pionex 信号平台，以充当信号提供方——它不是消费者订阅命令。
15. 所有标志都是必需的：--signal-type、--signal-param、--base、--quote、--time（RFC 3339）、--price、--action、--position-size、--contracts。切勿省略或推断其中任何一项。
16. user_signal_create/edit/delete 是写入操作——在不使用 --dry-run 运行之前，先确认用户确实希望执行。
17. 如果信号有未结订单，user_signal_delete 将因 SIGNAL_HAS_UNCLOSED_ORDERS 而失败。重试前，向用户展示 cnt 值（未结订单数量）。
18. 对于 user_signal_edit，必须提供 --title 或 --description 中的至少一个。

示例

# --- Futures Grid ---

# List running futures grid bot orders
pionex-trade-cli bot order_list --status running --bu-order-types futures_grid

# List all running bot orders across all types
pionex-trade-cli bot order_list --status running

# Filter by symbol
pionex-trade-cli bot order_list --base BTC --quote USDT

# Paginate to next page
pionex-trade-cli bot order_list --status finished --page-token <nextPageToken>

# Read one bot status
pionex-trade-cli bot futures_grid get --bu-order-id 123456789

# Validate futures grid params before creating
# extraMargin=false (manual mode): quoteInvestment is trading capital only;
#   min_investment/max_investment represent trading capital range.
pionex-trade-cli bot futures_grid check_params \
  --base BTC \
  --quote USDT \
  --bu-order-data-json '{"top":"110000","bottom":"90000","row":100,"grid_type":"arithmetic","trend":"long","leverage":5,"extraMargin":false,"quoteInvestment":"100"}'

# extraMargin=true (auto-split mode): quoteInvestment is total input (trading capital + safety buffer);
#   min_investment/max_investment represent total input range. System splits automatically.
pionex-trade-cli bot futures_grid check_params \
  --base BTC \
  --quote USDT \
  --bu-order-data-json '{"top":"110000","bottom":"90000","row":100,"grid_type":"arithmetic","trend":"long","leverage":5,"extraMargin":true,"quoteInvestment":"100"}'

# Dry-run create
pionex-trade-cli bot futures_grid create \
  --base BTC \
  --quote USDT \
  --bu-order-data-json '{"top":"110000","bottom":"90000","row":100,"grid_type":"arithmetic","trend":"long","leverage":5,"extraMargin":false,"quoteInvestment":"100"}' \
  --dry-run

# Dry-run adjust
pionex-trade-cli bot futures_grid adjust_params --body-json '{"buOrderId":"123456789","type":"invest_in","quoteInvestment":50,"extraMargin":false}' --dry-run

# --- Spot Grid ---

# Get AI-recommended parameters for BTC/USDT spot grid
pionex-trade-cli bot spot_grid get_ai_strategy --base BTC --quote USDT

# Validate spot grid params before creating
pionex-trade-cli bot spot_grid check_params \
  --base BTC \
  --quote USDT \
  --bu-order-data-json '{"top":"110000","bottom":"90000","row":50,"grid_type":"arithmetic","quoteInvestment":"200"}'

# Dry-run create spot grid (using AI-recommended or user-specified params)
pionex-trade-cli bot spot_grid create \
  --base BTC \
  --quote USDT \
  --bu-order-data-json '{"top":"110000","bottom":"90000","row":50,"grid_type":"arithmetic","quoteInvestment":"200"}' \
  --dry-run

# Query spot grid bot status
pionex-trade-cli bot spot_grid get --bu-order-id 987654321

# Add investment to running spot grid bot
pionex-trade-cli bot spot_grid invest_in \
  --body-json '{"buOrderId":"987654321","quoteInvestment":"100"}' \
  --dry-run

# Extract accumulated grid profits
pionex-trade-cli bot spot_grid profit \
  --body-json '{"buOrderId":"987654321"}' \
  --dry-run

# Cancel spot grid bot
pionex-trade-cli bot spot_grid cancel --bu-order-id 987654321 --dry-run

# List running spot grid bots
pionex-trade-cli bot order_list --status running --bu-order-types spot_grid

# --- Smart Copy ---

# Step 1: Get investment range for a signal (quote-investment 0 = range query only)
pionex-trade-cli bot smart_copy check_params \
  --base BTC \
  --quote USDT \
  --leverage 5 \
  --quote-investment 0

# Step 1b: Validate a specific investment amount
pionex-trade-cli bot smart_copy check_params \
  --base BTC \
  --quote USDT \
  --leverage 5 \
  --quote-investment 100

# Step 2: Dry-run create (single signal, leverage 5)
pionex-trade-cli bot smart_copy create \
  --base BTC \
  --quote USDT \
  --bu-order-data-json '{"quote_total_investment":"100","portfolio":[{"base":"BTC","signal_type":"<signal-uuid>","leverage":5}]}' \
  --dry-run

# Dry-run create with stop-loss/take-profit and multi-signal portfolio
pionex-trade-cli bot smart_copy create \
  --base BTC \
  --quote USDT \
  --bu-order-data-json '{"quote_total_investment":"200","portfolio":[{"base":"BTC","signal_type":"<uuid1>","leverage":5,"percent":"0.5","profit_stop_ratio":"0.3","loss_stop_ratio":"0.1"},{"base":"ETH","signal_type":"<uuid2>","leverage":3,"percent":"0.5"}]}' \
  --dry-run

# Query smart copy bot status
pionex-trade-cli bot smart_copy get --bu-order-id 111222333

# Cancel smart copy bot
pionex-trade-cli bot smart_copy cancel \
  --bu-order-id 111222333 \
  --dry-run

# Cancel and convert holdings into Earn products
pionex-trade-cli bot smart_copy cancel \
  --bu-order-id 111222333 \
  --convert-into-earn-coin \
  --dry-run

# Push a trading signal to the Pionex signal platform (signal provider role)
pionex-trade-cli bot signal listener \
  --signal-type <uuid> \
  --signal-param '{}' \
  --base BTC \
  --quote USDT \
  --time "2026-04-15T10:00:00Z" \
  --price 85000 \
  --action buy \
  --position-size 1 \
  --contracts 1 \
  --dry-run

# List running smart copy bots
pionex-trade-cli bot order_list --status running --bu-order-types smart_copy

# --- User-defined Signal CRUD ---

# List all user-defined signals
pionex-trade-cli bot signal user_signal_list

# Get detail of a signal (includes webhookUrl and TradingView message template)
pionex-trade-cli bot signal user_signal_get --signal-type <uuid>

# Dry-run create a new signal
pionex-trade-cli bot signal user_signal_create \
  --title "My TradingView Signal" \
  --description "RSI crossover strategy" \
  --dry-run

# Dry-run edit signal title
pionex-trade-cli bot signal user_signal_edit \
  --signal-type <uuid> \
  --title "Updated Signal Name" \
  --dry-run

# Dry-run delete a signal (fails if unclosed orders exist)
pionex-trade-cli bot signal user_signal_delete \
  --signal-type <uuid> \
  --dry-run