跳到內容

指令速查

每個指令都可以加 --help 查看完整參數,jv --version 查看版本。多數指令支援 --pretty 輸出縮排格式的 JSON。jv market list 例外:它預設輸出表格,只支援 --json。

指令 作用
jv enable [--name <名稱>] [--timeout <秒數>] 在瀏覽器裡授權,建立或續期錢包設定檔
jv wallet list 列出錢包設定檔
jv wallet info 目前錢包設定檔的詳情
jv wallet switch [<名稱>] 切換目前的錢包設定檔
jv wallet rename <舊名稱> <新名稱> 改名
jv wallet remove <名稱> 刪除錢包設定檔(不能刪除目前正在使用的)
指令 作用
jv market list [--json] 可交易市場:交易代碼、交易對、保證金資產、最大槓桿
jv price --symbol <交易代碼> 即時價格
指令 作用
jv order create --side <方向> --symbol <交易代碼> -m <保證金> [--leverage <倍數>] [--limit-price <價格>] [--ttl <秒數>] [PPO 參數] 市價單或限價單。已有倉位時,同方向是加倉;反方向時,保證金等於倉位目前保證金是全部平倉,大於時會先平倉再反向開倉,詳見用命令列交易
jv order close --order-id <訂單編號> 平掉一個倉位;減過倉的倉位可能被處理成平倉後反向開倉,平倉後用 jv orders list 確認
jv order close --all 平掉全部倉位
jv order protect --order-id <訂單編號> --symbol <交易代碼> [PPO 參數] 為現有倉位加上 PPO,不改變倉位大小
jv tp set --order-id <訂單編號> --price <價格> --symbol <交易代碼> [--side short] [--ttl <秒數>] 停利
jv sl set --order-id <訂單編號> --price <價格> --symbol <交易代碼> [--side short] [--ttl <秒數>] 停損

<方向> 填 long 或 short。PPO 參數:--ppo、--ppo-expire(30m、8h)、--ppo-category(ATM、OTM)、--ppo-tier(1 到 5)。jv order protect 不需要 --ppo,其餘三個參數照用。

指令 作用
jv orders list [--all] [--position-side LONG] [--since 7d] [--until <時間>] [--page <頁>] [--limit <筆數>] 持倉和歷史訂單
jv orders get <訂單編號> 單一訂單
jv orders stats 訂單總數、持倉中、已平倉數量
jv limit-order list --wallet <錢包地址> [--status <狀態>] 限價單和停利停損單
jv limit-order status <limitOrderId> 單一限價單狀態
jv limit-order cancel <limitOrderId> 取消限價單或停利停損單
jv job status <jobId> 市價單執行結果
指令 作用
jv deposit --token usdc --amount <數量> [--timeout <秒數>] [--no-wait] 從 Base 充值:開啟指令提供的網頁,用錢包簽名
jv withdraw --token usdc --amount <數量> [--timeout <秒數>] 提領回 Base:開啟指令提供的網頁,用錢包簽名
指令 作用
jv install [--ai <平台>] [--global] [--force] 安裝 skill 和 MCP 設定,<平台> 填 claude、cursor 或 openclaw,不填就三個都裝
jv uninstall --ai <平台> [--global] 解除安裝,<平台> 還可以填 all
jv mcp 以 stdio 模式啟動 MCP 伺服器
jv update [--force] 升級到最新版本
項目 預設值
槓桿 50 倍
訂單有效期(--ttl) 3600 秒
停利停損有效期(--ttl) 86400 秒
PPO 期限 30m
PPO 類別 ATM
授權、充值、提領的等待時間(--timeout) 900 秒
市價單等待執行結果 60 秒
單一 HTTP 請求逾時 30 秒
變數 說明
BASE_HTTP_RPC_URL Base 主網 RPC 網址,jv enable 和 jv withdraw 必須設定
JV_TIMEOUT 選填,單一 HTTP 請求的逾時時間,單位毫秒

本機檔案的位置見安裝 jv CLI。

錯誤訊息或現象 原因 處理
Delegation key not found 目前的錢包設定檔還沒有授權 執行 jv enable
No vault profile for environment beta 還沒有授權,或者目前選取的錢包設定檔不對 用 jv wallet list 查看,jv wallet switch 切換,或者執行 jv enable
提示缺少 BASE_HTTP_RPC_URL 執行 jv enable 或 jv withdraw 時沒有設定這個變數 設定後重試
Token … not found for environment beta --symbol 不是可交易的代碼 填 jv market list 的 SYMBOL 欄
Failed to fetch price … HTTP 404 jv price 填了 BTC 這類代碼 填交易代碼,例如 JVBTC
--side must be long or short 方向寫錯 填 long 或 short
OTM requires --ppo-tier (1-5) 選了 OTM 但沒給檔位 加上 --ppo-tier
--ppo-expire must be 30m or 8h 期限取值不對 只能填 30m 或 8h
Specify exactly one of --order-id or --all jv order close 兩個參數都給了,或都沒給 只給其中一個
Order … not found in Subgraph、Order … is not active 訂單編號不對,或者倉位已經平掉 用 jv orders list 查看目前持倉
以前能用的指令開始報授權錯誤,例如含 deadline expired 授權已經到期 重新執行 jv enable
下單類指令回傳 "status": "timeout"(錯誤訊息 Client timeout after 60 seconds)或 "status": "failed" 60 秒內沒取得結果,或 CLI 查詢結果時出錯;訂單可能已經受理甚至成交 先用 jv orders list、jv limit-order list 核對,再決定要不要重新下單
輸出 "success": false,message 裡有 expired 授權、充值或提領頁面沒在時限內完成 重新執行指令
"arrived": false 充值還在跨鏈途中 過幾分鐘到網頁端查看餘額
Skill already exists at … jv install 的目標位置已經有 skill 加 --force 覆寫
Request timed out after 30000ms 或其他網路錯誤(結束代碼 2) 網路或服務回應慢;下單請求可能已經被受理 下單類指令先用 jv orders list、jv limit-order list 核對再重新下單;查詢類指令可以直接重試,也可以調大 JV_TIMEOUT