跳转到内容

命令速查

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