每个命令都可以加 --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 |