交易员对接概览
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 交易
- 写程序化交易前先看写脚本和交易机器人,命令和报错可以查命令速查