每個指令都可以加 --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 |