# 機器人 Skills ### 機器人訂單列表 #### 命令參考 | 命令 | 類型 | 說明 | | -------------------------------------------------------------------------------------------------------------------------------------------------- | -- | -------------------- | | `pionex-trade-cli bot order_list [--status running\|finished] [--base ] [--quote ] [--page-token ] [--bu-order-types ]` | 讀取 | 列出所有類型的機器人訂單，支援過濾與分頁 | #### 參數 | 參數 | 說明 | | ------------------ | ------------------------------------------------------------ | | `--status` | `running`（預設）或 `finished` | | `--base` | 基礎貨幣過濾（例如 `BTC`） | | `--quote` | 計價貨幣過濾（例如 `USDT`） | | `--page-token` | 分頁游標（來自上一次回應） | | `--bu-order-types` | 逗號分隔的機器人類型：`futures_grid`、`spot_grid`、`smart_copy`。省略則回傳所有類型 | #### MCP 工具 | 工具 | 說明 | | ----------------------- | ------------------------------------------------------------ | | `pionex_bot_order_list` | 列出機器人訂單（支援過濾與分頁，涵蓋 futures\_grid / spot\_grid / smart\_copy） | #### 範例 ```bash # 列出所有執行中的機器人訂單 pionex-trade-cli bot order_list # 僅列出現貨網格訂單 pionex-trade-cli bot order_list --bu-order-types spot_grid # 列出已完成的 BTC 所有類型機器人訂單 pionex-trade-cli bot order_list --status finished --base BTC # 同時過濾多個機器人類型 pionex-trade-cli bot order_list --bu-order-types futures_grid,spot_grid # 翻到下一頁 pionex-trade-cli bot order_list --page-token ``` *** ### pionex-bot：合約網格機器人 合約網格機器人的建立與管理。**需要 API 憑證**。 #### 命令參考 | 命令 | 類型 | 說明 | | ------------------------------------------------------------------------------------------------------------ | -- | ------------------ | | `pionex-trade-cli bot futures_grid get --bu-order-id ` | 讀取 | 依 ID 查詢合約網格機器人訂單 | | `pionex-trade-cli bot futures_grid create --base --quote --bu-order-data-json ''` | 寫入 | 建立合約網格機器人訂單 | | `pionex-trade-cli bot futures_grid check_params --base --quote --bu-order-data-json ''` | 讀取 | 下單前驗證參數 | | `pionex-trade-cli bot futures_grid adjust_params --body-json ''` | 寫入 | 調整機器人參數（追加投入/網格範圍） | | `pionex-trade-cli bot futures_grid reduce --body-json ''` | 寫入 | 減少機器人倉位 | | `pionex-trade-cli bot futures_grid cancel --bu-order-id ` | 寫入 | 取消並關閉機器人訂單 | #### 建立參數 **`buOrderData` 必填欄位：** * `top` / `bottom`：網格上限/下限價格 * `row`：網格層數 * `grid_type`：`"arithmetic"` 或 `"geometric"` * `trend`：`"long"`、`"short"` 或 `"no_trend"` * `leverage`：槓桿倍數 * `quoteInvestment`：以計價貨幣計算的投入金額 #### 範例 ```bash # 建立做多合約網格機器人 pionex-trade-cli bot futures_grid create --base BTC --quote USDT --bu-order-data-json '{ "top": "80000", "bottom": "60000", "row": 50, "grid_type": "arithmetic", "trend": "long", "leverage": 5, "quoteInvestment": "1000" }' # 查詢機器人狀態 pionex-trade-cli bot futures_grid get --bu-order-id 123456 # 追加保證金 pionex-trade-cli bot futures_grid adjust_params --body-json '{ "buOrderId": "123456", "type": "invest_in", "extraMargin": true, "quoteInvestment": 500 }' # 減少倉位 pionex-trade-cli bot futures_grid reduce --body-json '{"buOrderId": "123456", "reduceNum": 10}' # 取消機器人 pionex-trade-cli bot futures_grid cancel --bu-order-id 123456 ``` #### 行為約束 1. **明確參數**：絕不猜測網格範圍、槓桿或投入金額。若不明確，請詢問使用者。 2. **下單前驗證**：始終先呼叫 `check_params` 驗證參數。若伺服器回傳含 `min_investment` / `max_investment` 的 `FailedWithData` 錯誤，將有效範圍展示給使用者並請其調整。 3. **先模擬執行**：對於任何寫入操作（建立、調整、減倉、取消），優先以 `--dry-run` 執行，向使用者展示將會發生什麼，確認後再實際執行。 4. **餘額檢查**：建立機器人前檢查可用餘額。若資金不足，告知使用者並建議調整投入金額。 5. **槓桿意識**：始終與使用者確認槓桿。絕不在未經明確同意的情況下增加槓桿。 6. **取消預覽**：取消機器人前，先取得其當前狀態並展示給使用者確認。 7. **不單方面增加風險**：Agent 絕不會在未經使用者明確同意的情況下增加投入、槓桿或網格範圍。 #### 機器人交易流程範例 使用者：「用 1000 USDT 建立一個做多 BTC 合約網格機器人」 Agent 執行流程： 1. 檢查餘額：`pionex-trade-cli account balance` -> 驗證可用 USDT 2. 取得交易對資訊：`pionex-trade-cli market symbols --symbols BTC_USDT --type PERP` 3. 取得當前價格：`pionex-trade-cli market tickers --symbol BTC_USDT --type PERP` 4. 詢問使用者網格範圍、格數和槓桿（若未指定） 5. 驗證參數：`pionex-trade-cli bot futures_grid check_params --base BTC --quote USDT --bu-order-data-json '...'` — 若回傳 `FailedWithData`，展示有效範圍並請使用者調整 6. 模擬執行預覽：`pionex-trade-cli bot futures_grid create --base BTC --quote USDT --bu-order-data-json '...' --dry-run` 7. 使用者確認後，執行實際建立（移除 `--dry-run`） *** ### pionex-bot：現貨網格機器人 現貨網格機器人的建立與管理。**需要 API 憑證**。 #### 命令參考 | 命令 | 類型 | 說明 | | ------------------------------------------------------------------------------------------------------------------------------- | -- | ---------------- | | `pionex-trade-cli bot spot_grid get --bu-order-id ` | 讀取 | 依 ID 查詢現貨網格機器人訂單 | | `pionex-trade-cli bot spot_grid get_ai_strategy --base --quote ` | 讀取 | 取得交易對的 AI 推薦網格參數 | | `pionex-trade-cli bot spot_grid create --base --quote --bu-order-data-json ''` | 寫入 | 建立現貨網格機器人訂單 | | `pionex-trade-cli bot spot_grid check_params --base --quote --bu-order-data-json ''` | 讀取 | 下單前驗證參數 | | `pionex-trade-cli bot spot_grid adjust_params --bu-order-id [--top

] [--bottom

] [--row ] [--quote-invest ]` | 寫入 | 調整網格範圍或追加投入 | | `pionex-trade-cli bot spot_grid invest_in --bu-order-id --quote-invest <金額>` | 寫入 | 向執行中的機器人追加計價貨幣投入 | | `pionex-trade-cli bot spot_grid cancel --bu-order-id [--close-sell-model NOT_SELL\|TO_QUOTE\|TO_USDT]` | 寫入 | 取消並關閉機器人訂單 | | `pionex-trade-cli bot spot_grid profit --bu-order-id --amount <金額>` | 寫入 | 提取累積的網格利潤 | #### 建立參數 **`buOrderData` 必填欄位：** * `top` / `bottom`：網格上限/下限價格 * `row`：網格層數（2–200） * `gridType`：`"arithmetic"` 或 `"geometric"`（駝峰命名，與合約網格的 `grid_type` 不同） * `quoteTotalInvestment`：以計價貨幣計算的投入金額 **與合約網格的關鍵差異：** * 無 `leverage`（槓桿）與 `trend`（方向）欄位（現貨，非合約） * `gridType` 為駝峰命名；合約網格使用 `grid_type` 底線命名 * 建立時使用 `quoteTotalInvestment`，而非 `quoteInvestment` * 追加投入使用 `quoteInvest` * 預設 `closeSellModel` 為 `NOT_SELL`（合約網格預設為 `TO_QUOTE`） #### 範例 ```bash # 取得 AI 策略推薦 pionex-trade-cli bot spot_grid get_ai_strategy --base BTC --quote USDT # 建立現貨網格機器人（先模擬執行） pionex-trade-cli bot spot_grid create --base BTC --quote USDT --bu-order-data-json '{ "top": "110000", "bottom": "90000", "row": 50, "gridType": "arithmetic", "quoteTotalInvestment": "100" }' --dry-run # 查詢機器人狀態 pionex-trade-cli bot spot_grid get --bu-order-id 123456 # 追加投入 pionex-trade-cli bot spot_grid invest_in --bu-order-id 123456 --quote-invest 50 # 調整網格範圍 pionex-trade-cli bot spot_grid adjust_params --bu-order-id 123456 --top 120000 --bottom 85000 # 提取利潤 pionex-trade-cli bot spot_grid profit --bu-order-id 123456 --amount 10 # 取消機器人 pionex-trade-cli bot spot_grid cancel --bu-order-id 123456 --close-sell-model TO_QUOTE ``` #### 行為約束 1. **明確參數**：絕不猜測網格範圍或投入金額。若不明確，請詢問使用者。 2. **優先 AI 策略**：對於新機器人，建議先呼叫 `get_ai_strategy` 取得推薦參數，再由使用者確認或調整。 3. **下單前驗證**：始終先呼叫 `check_params` 驗證參數。若伺服器回傳含 `min_investment` / `max_investment` 的 `FailedWithData` 錯誤，將有效範圍展示給使用者並請其調整。 4. **先模擬執行**：對於任何寫入操作（建立、調整、追加投入、取消、提取利潤），優先以 `--dry-run` 執行，確認後再實際執行。 5. **餘額檢查**：建立機器人前，檢查可用計價貨幣餘額。 6. **取消預覽**：取消機器人前，先取得其當前狀態並展示給使用者確認。 7. **不單方面增加風險**：Agent 絕不會在未經使用者明確同意的情況下增加投入或網格範圍。 #### 現貨網格交易流程範例 使用者：「用 100 USDT 建立一個 BTC 現貨網格機器人」 Agent 執行流程： 1. 檢查餘額：`pionex-trade-cli account balance` → 驗證可用 USDT 2. 取得 AI 策略：`pionex-trade-cli bot spot_grid get_ai_strategy --base BTC --quote USDT` 3. 取得當前價格：`pionex-trade-cli market tickers --symbol BTC_USDT` 4. 展示 AI 推薦參數；請使用者確認或調整 5. 驗證參數：`pionex-trade-cli bot spot_grid check_params --base BTC --quote USDT --bu-order-data-json '...'` — 若回傳 `FailedWithData`，展示有效範圍並請使用者調整 6. 模擬執行預覽：`pionex-trade-cli bot spot_grid create --base BTC --quote USDT --bu-order-data-json '...' --dry-run` 7. 使用者確認後，執行實際建立（移除 `--dry-run`） *** ### pionex-bot：智慧跟單機器人 智慧跟單機器人的建立與管理。自動複製訊號來源的交易操作。**需要 API 憑證**。 #### 命令參考 | 命令 | 類型 | 說明 | | ------------------------------------------------------------------------------------------------------------------------------------------- | -- | ---------------- | | `pionex-trade-cli bot smart_copy get --bu-order-id ` | 讀取 | 依 ID 查詢智慧跟單機器人訂單 | | `pionex-trade-cli bot smart_copy create --base --quote --bu-order-data-json ''` | 寫入 | 建立智慧跟單機器人訂單 | | `pionex-trade-cli bot smart_copy check_params --base --quote --leverage --quote-investment [--signal-type ]` | 讀取 | 下單前驗證參數 | | `pionex-trade-cli bot smart_copy cancel --bu-order-id ` | 寫入 | 取消並關閉智慧跟單機器人訂單 | #### 建立參數 **`bu_order_data` 必填欄位：** * `quote_total_investment`：計價貨幣總投入金額（字串） * `portfolio`：要跟單的訊號來源清單，每項必填： * `base`：基礎貨幣（如 `"BTC"`） * `signal_type`：訊號來源 UUID * `leverage`：槓桿倍數（整數） * `percent`：佔總投入金額的比例（如 `"1"` = 100%） **與網格機器人的主要差異：** 無 `top`/`bottom`/`row` 欄位 — 智慧跟單無需設定網格範圍，直接複製訊號來源的倉位大小。 #### check\_params 參數 傳入 `--quote-investment 0` 僅取得允許範圍，不進行投入估算。 | 參數 | 說明 | | -------------------- | --------------------- | | `--leverage` | 槓桿倍數（如 `2`） | | `--quote-investment` | 投入金額；`0` = 僅取得範圍 | | `--signal-type` | 選填；訊號來源 UUID，用於限定驗證範圍 | #### cancel 參數 | 參數 | 說明 | | -------------------------- | --------------- | | `--bu-order-id` | 必填；智慧跟單機器人訂單 ID | | `--close-note` | 選填；關閉備註 | | `--convert-into-earn-coin` | 將剩餘資金轉換為理財幣 | #### 範例 ```bash # 檢查餘額 pionex-trade-cli account balance # 驗證參數（僅取得範圍） pionex-trade-cli bot smart_copy check_params --base BTC --quote USDT \ --leverage 2 --quote-investment 0 --signal-type # 模擬執行預覽 pionex-trade-cli bot smart_copy create --base BTC --quote USDT \ --bu-order-data-json '{"quote_total_investment":"100","portfolio":[{"base":"BTC","signal_type":"","leverage":2,"percent":"1"}]}' \ --dry-run # 確認後建立機器人 pionex-trade-cli bot smart_copy create --base BTC --quote USDT \ --bu-order-data-json '{"quote_total_investment":"100","portfolio":[{"base":"BTC","signal_type":"","leverage":2,"percent":"1"}]}' # 查詢機器人狀態 pionex-trade-cli bot smart_copy get --bu-order-id 123456 # 取消機器人 pionex-trade-cli bot smart_copy cancel --bu-order-id 123456 ``` #### 行為限制 1. **明確參數**：不猜測 `quote_total_investment` 或 `leverage`。如不明確，向使用者詢問。 2. **必須確認訊號來源**：建立前必須與使用者確認 `signal_type`（訊號來源 UUID）。不得在沒有使用者明確指示的情況下自行選擇訊號來源。 3. **下單前驗證**：始終先呼叫 `check_params`。若 `FailedWithData` 回傳限額，展示有效範圍並請使用者調整。 4. **先模擬執行**：對於所有寫入操作（建立、取消），優先使用 `--dry-run`，僅在使用者確認後執行。 5. **餘額確認**：建立機器人前確認可用計價貨幣餘額。 6. **取消前預覽**：取消前先查詢機器人當前狀態，展示給使用者確認。 7. **不單方面改變風險**：不在使用者明確同意的情況下更改 `leverage` 或投入金額。 #### 智慧跟單交易流程範例 使用者：「用 100 USDT 以 2 倍槓桿跟單交易員 X 的 BTC 交易」 Agent 執行流程： 1. 檢查餘額：`pionex-trade-cli account balance` → 驗證可用 USDT ≥ 100 2. 驗證參數：`pionex-trade-cli bot smart_copy check_params --base BTC --quote USDT --leverage 2 --quote-investment 0 --signal-type ` — 展示允許範圍 3. 模擬執行預覽：在建立命令中加 `--dry-run`，將解析後的請求內容展示給使用者 4. 使用者確認後，移除 `--dry-run` 執行實際建立 *** ### pionex-bot：訊號 訊號推送（供訊號來源使用）。**需要 API 憑證**。 #### 命令參考 | 命令 | 類型 | 說明 | | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -- | --------- | | `pionex-trade-cli bot signal listener --signal-type --signal-param --base --quote --time --price --action --position-size --contracts ` | 寫入 | 向平台推送交易訊號 | #### 參數說明 | 參數 | 說明 | | -------------------- | ---------------------------------------- | | `--signal-type` | 訊號來源 UUID | | `--signal-param` | 訊號參數（JSON 字串，如 `'{}'`） | | `--base` / `--quote` | 交易對（如 `BTC` / `USDT`） | | `--time` | RFC 3339 格式時間戳（如 `2024-01-01T12:00:00Z`） | | `--price` | 訊號觸發時的當前價格 | | `--action` | `buy` 開倉，`sell` 平倉 | | `--position-size` | 目標持倉比例（`"1"` = 100%） | | `--contracts` | 合約數量 | #### 範例 ```bash # 推送買入訊號 pionex-trade-cli bot signal listener --signal-type --signal-param '{}' \ --base BTC --quote USDT --time 2024-01-01T12:00:00Z --price 85000 \ --action buy --position-size 1 --contracts 1 # 推送賣出訊號 pionex-trade-cli bot signal listener --signal-type --signal-param '{}' \ --base BTC --quote USDT --time 2024-01-01T13:00:00Z --price 86000 \ --action sell --position-size 0 --contracts 0 ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://www.pionex.com/docs/ai-kit-docs/zh-hant/skills/skills-guides/skills-guides-bot.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.