交易員對接概覽
Jasper Vault 提供命令列工具 jv(npm 套件 jaspervault_cli),可以在終端機、腳本或 AI agent 裡交易永續合約。
| 功能 | 指令 |
|---|---|
| 查看可交易市場和即時價格 | jv market list、jv price |
| 永續合約市價單、限價單,加倉、減倉、平倉 | jv order create、jv order close |
| 停利停損 | jv tp set、jv sl set |
| 永續合約保護(PP):開倉時附帶 PPO,或為現有倉位單獨加上 | --ppo 系列參數、jv order protect |
| 從 Base 充值、提領回 Base:指令提供網頁網址,在網頁上用錢包簽名 | jv deposit、jv withdraw |
| 查詢持倉、限價單、停利停損單和市價單執行結果 | jv orders、jv limit-order、jv job status |
- 命令列:在終端機或腳本裡直接執行
jv,結果以 JSON 輸出,方便程式處理。見用命令列交易和撰寫腳本和交易機器人。 - AI agent:
jv mcp是一個 MCP 伺服器。Claude Code、Cursor 等 AI 使用者端接入後,可以用自然語言下單。見用 AI agent 交易。
兩種用法共用同一份本機授權,授權一次即可。CLI 預設連線 Jasper Vault 正式環境,這個環境在 CLI 裡叫 beta。
執行 jv enable 後:
- CLI 在你的電腦上隨機產生一把新私鑰,稱為委託 key。它和你的錢包私鑰沒有關係。
- CLI 提供一個網址。你在瀏覽器裡開啟,連接錢包,簽署一則授權訊息,把委託 key 登記為你錢包的授權簽署者。這一步只是簽名,錢包不會送出轉帳交易,錢包私鑰也始終留在錢包裡。
- 之後開倉、平倉、設定停利停損,都由委託 key 在本機簽名,不再彈出錢包。
委託 key 能做什麼
Section titled “委託 key 能做什麼”CLI 用委託 key 簽名的操作包括:
- 授權時建立你在 Jasper Vault 上的帳戶
- 開倉、加倉、減倉、平倉,包括限價單和停利停損單
- 為倉位購買 PPO
合約接受委託 key 簽名的範圍比 CLI 用到的更大,還包括追加保證金、把資金轉入 PP 預付充值餘額、建立選擇權報價(offer)等操作。
這些操作都會動用你帳戶裡的資金,錯誤或惡意的指令可能造成虧損。在授權到期之前,取得這把 key 的人可以用你的帳戶進行這些操作。請把它當作能動用你帳戶資金的憑證來保管。
委託 key 不能做什麼
Section titled “委託 key 不能做什麼”委託 key 不能簽署提領。合約要求提領簽名來自錢包本人,委託 key 簽署的提領會被拒絕。jv withdraw 也是開啟網頁,讓你在瀏覽器裡用錢包簽名。
有效期與撤銷
Section titled “有效期與撤銷”- 授權有到期時間,寫在授權訊息的
deadline欄位裡,簽名前可以在錢包的簽名請求裡看到。到期後合約不再接受這把 key 的簽名,下單會失敗。目前是簽名後 7 天。 - 到期後再執行一次
jv enable,用錢包重新簽名即可續期,CLI 會繼續使用同一把 key。 - CLI 目前沒有撤銷授權的指令。刪除本機的 key 檔案或錢包設定檔只會刪掉本機檔案,不會讓鏈上的授權失效。
保管好本機 key 檔案
Section titled “保管好本機 key 檔案”委託 key 以明文儲存在 ~/.jaspervault/profiles/<錢包設定檔名稱>/keys.json。CLI 會把檔案權限設為只有目前使用者可讀寫,但在 Windows 上可能設定不成功。
- 不要把這個檔案或其中的內容傳給任何人,也不要貼進 AI 對話。
- 不要把
~/.jaspervault/放進 Git 儲存庫、雲端同步資料夾或共用磁碟。 - 懷疑檔案已經外洩時,盡快在網頁端或用
jv withdraw把資金提回 Base。提領需要錢包本人簽名,委託 key 簽不了。
- Node.js 18 或更高版本
- 瀏覽器錢包,例如 MetaMask、Rabby
- Base 鏈上用於充值的資產,以及支付 gas 的 ETH
交易前請先閱讀重要風險提示。
- 安裝 jv CLI,完成授權
- 用 CLI 充值與提領
- 用命令列交易,或者用 AI agent 交易
- 撰寫程式化交易前先看撰寫腳本和交易機器人,指令和錯誤訊息可以查指令速查