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	先物グリッドボット注文を1件取得します
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	スポットグリッドボット注文を1件取得します
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	スマートコピーボット注文を1件取得します
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 がパラメーターを拒否した場合は、正確なエラーを提示し、修正したペイロードを提案してください。

Spot Grid 固有のルール

5. ユーザーが価格範囲と行数を明示していない場合は、create の前に get_ai_strategy を呼び出してください。
6. 現物グリッドはレバレッジを使用しないため、現物グリッドのペイロードに leverage、trend、extraMargin フィールドを追加してはいけません。
7. 投資を作成または追加する前に、口座に十分なベース残高とクオート残高があることを確認してください。
8. invest_in と profit は単独のコマンドです。adjust_params と混同しないでください。

Smart Copy 固有のルール

9. buOrderData 内の portfolio 配列を空にしてはいけません。各エントリーには base、signal_type（UUID）、leverage（整数）が必要です。
10. signal_type の UUID を推測してはいけません。明示的なユーザー指定を必須としてください。
11. create の --copy-from <id> は既存の Smart Copy 注文からパラメーターをコピーします。ユーザーが明示的に要求した場合にのみ使用してください。
12. cancel の --convert-into-earn-coin は保有資産を Earn 商品に変換します。使用前にユーザーに確認してください。
13. check_params では --leverage、--quote-investment のようなフラットなフラグを使用し、--bu-order-data-json は使用しません。特定の金額を検証せずに投資範囲を照会するには、--quote-investment 0 を使用してください。

Signal 固有のルール

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 のいずれかを少なくとも1つ指定する必要があります。

例

# --- 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