跳转到内容

用命令行交易

下面的交易命令都要先完成授权。命令结果默认输出单行 JSON,加 --pretty 输出缩进格式。

持仓期间会按资金费率收付资金费,保证金不足时仓位会被强平,规则见强平机制。

jv market list
SYMBOL  PAIR                 MARGIN  MAX_LEVERAGE
JVBTC   BTC/USDC             JVUSD   100x
JETH    ETH/USDC             JVUSD   50x
…
  • SYMBOL 是交易代码,下单和查价时 --symbol 填这一列。目前有 JVBTC、JETH、SKHY、XAU、TQQQ、CL、CRCL、MU、NVDA、TSLA。
  • MARGIN 是这个市场的保证金资产,MAX_LEVERAGE 是最大杠杆。
  • 市场列表随 CLI 版本一起发布,新上线的市场要运行 jv update 升级后才会出现。
  • 加 --json 输出 JSON:
{"environment":"beta","markets":[{"symbol":"JVBTC","pair":"BTC/USDC","marginAsset":"JVUSD","maxLeverage":100},{"symbol":"JETH","pair":"ETH/USDC","marginAsset":"JVUSD","maxLeverage":50},…]}

查询实时价格:

jv price --symbol JVBTC
{"symbol":"JVBTC","price":"64073.95","priceWei":"64073950000000000000000","source":"quote_center","timestamp":"2026-11-18T12:08:06.954Z"}

price 是价格,priceWei 是放大 10^18 倍后的整数。--symbol 要填交易代码,填 BTC 会查不到价格,命令以退出码 2 结束。

# 市价开多:保证金 100,20 倍杠杆
jv order create --side long --symbol JVBTC -m 100 --leverage 20

# 限价开空:价格到 68000 时触发,2 小时内有效
jv order create --side short --symbol JVBTC -m 50 --leverage 10 --limit-price 68000 --ttl 7200
参数 说明
--side 方向,long 或 short,必填
--symbol 交易代码,必填
-m、--margin 保证金数量,必填,单位是这个市场的保证金资产(jv market list 的 MARGIN 列)
--leverage 杠杆,不填时默认 50 倍;不要超过这个市场的 MAX_LEVERAGE
--limit-price 限价;不填就是市价单
--ttl 订单签名的有效期,单位秒,默认 3600。限价单在有效期内没有触发就会过期
--ppo 等 开仓时附带永续合约保护(PP),见下文

命令会在 stderr 打印一行预估,例如 Estimated: ~0.031214 JVBTC @ $64,073.95 (~$2,000 JVUSD total, 20x)。

  • 市价单:提交后最多等 60 秒拿执行结果。stdout 输出两行 JSON:第一行是提交回执,带 jobId;第二行是执行结果,"status": "completed" 表示已经上链成交,并带 transactionHash。结果不是 completed 时,命令以退出码 3 结束,但订单不一定没有成交,见下文「结果不明确时」。
  • 限价单:立即返回一行 JSON,带 limitOrderId,到价后自动执行。

下单类命令(jv order create、jv order close、jv order protect、jv tp set、jv sl set)没有防重复提交的机制,同一条命令运行两次就是两笔订单。只有下面几种情况算明确成功:

  • 市价单和 jv order protect 的执行结果是 "status": "completed";
  • 限价单、止盈止损单返回了 limitOrderId;
  • jv order close 输出的 failed 为空。

其他情况,包括退出码 2(请求超时或网络错误)、"status": "timeout"、"status": "failed",订单都可能已经被受理,甚至已经成交。重新提交前,先用 jv orders list 和 jv limit-order list 核对。

已经有仓位时,同一交易代码的新订单按方向和保证金处理:

新订单 结果
同方向 加仓
反方向,保证金等于仓位当前的保证金 全部平仓
反方向,保证金大于仓位当前的保证金 先全部平仓,再用多出来的部分开一张反方向的新仓位;多出来的部分太小时只平仓
反方向,保证金小于仓位当前的保证金 再按仓位数量(保证金 × 杠杆 ÷ 开仓价)比较:小于原仓位是减仓,剩下的太少时全部平仓;等于是全部平仓;大于同样是先平仓再反向开仓

反方向下单前请算清保证金和杠杆,否则可能在平仓之后被反向开仓:

  • 杠杆填得比原仓位高时,保证金虽然小,仓位数量也可能超过原仓位。减仓时 --leverage 要填原仓位的杠杆(jv orders list 里的 leverage)。
  • jv orders list 里的 margin 是累计存入的保证金:加仓时变大,减仓时不变。减过仓以后,它比仓位当前的保证金大,不能直接用来计算减仓或平仓的保证金。CLI 目前查不到仓位当前的保证金,减过仓的仓位建议在网页端继续减仓或平仓。

例如一张没有减过仓、20 倍、保证金 100 的 JVBTC 多单,减掉一半:

jv order create --side short --symbol JVBTC -m 50 --leverage 20

平仓:

jv order close --order-id 42   # 平掉订单 42
jv order close --all           # 平掉全部持仓
  • jv order close 读取仓位的方向、杠杆和 margin(累计存入的保证金),提交一张反方向单。减过仓的仓位,这个保证金会大于仓位当前的保证金,可能被处理成平仓后反向开仓。这类仓位建议在网页端平仓。
  • 用 jv order close 平仓后,用 jv orders list 确认仓位已经平掉,并且没有新开的反向仓位。
  • --order-id 和 --all 二选一。--all 按顺序逐个平仓,输出一行 {"closed":[…],"failed":[…]},只要有一个失败,退出码就是 3。

订单号是 jv orders list 里每条订单的 id。

# 多单 42:止盈 70000,止损 60000
jv tp set --order-id 42 --price 70000 --symbol JVBTC
jv sl set --order-id 42 --price 60000 --symbol JVBTC

# 空单 43:必须加 --side short
jv tp set --order-id 43 --price 58000 --symbol JVBTC --side short
jv sl set --order-id 43 --price 66000 --symbol JVBTC --side short
  • --side 默认是 long。空单必须加 --side short,否则 CLI 会按多单的方向和仓位账户签名。
  • 触发后平掉整个仓位,不会反向开仓。
  • 默认 24 小时有效(--ttl 86400),到期前没有触发需要重新设置。
  • 返回一行 JSON,带 limitOrderId。止盈止损单和限价单一样,用 jv limit-order 查询和取消。

在 CLI 里,永续合约保护(PP)通过 PPO 期权实现:多单配看跌期权(PUT),空单配看涨期权(CALL),不用手动选择。概念和费用见什么是永续合约保护(PP)和保护期限、范围与强度。

开仓时附带保护:

jv order create --side long --symbol JVBTC -m 100 --leverage 20 --ppo
jv order create --side long --symbol JVBTC -m 100 --leverage 20 --ppo --ppo-expire 8h --ppo-category OTM --ppo-tier 3
参数 取值 默认
--ppo 开启保护 不开启
--ppo-expire 30m 或 8h 30m
--ppo-category ATM:行权价等于当前价;OTM:行权价偏离当前价 ATM
--ppo-tier 1 到 5,每档偏离 0.1%,第 5 档偏离 0.5% 选 OTM 时必填,选 ATM 时忽略

给已有仓位单独加保护,不改变仓位大小:

jv order protect --order-id 42 --symbol JVBTC
jv order protect --order-id 42 --symbol JVBTC --ppo-expire 8h --ppo-category OTM --ppo-tier 2

jv order protect 先取保费报价再提交,最多等 60 秒拿执行结果,stdout 输出提交回执和执行结果两行。

注意:

  • 给已有仓位加保护请用 jv order protect。jv order create --ppo 会同时加仓。
  • 对已有 PPO 的仓位加仓或减仓时,如果这次不带 --ppo,原有的 PPO 会被取消;想保留保护,这次操作也要带上 --ppo。CLI 没有单独取消 PPO 的命令。
  • jv order close 平仓时不带 PPO。
jv orders list                          # 当前持仓(默认只列未平仓的,每页 20 条)
jv orders list --all --since 7d         # 最近 7 天的全部订单,包括已平仓的
jv orders list --position-side SHORT    # 只看空单
jv orders get 42                        # 单个订单
jv orders stats                         # 订单总数、持仓中和已平仓的数量
  • 每条订单除了原始字段,还加了可读字段:margin(保证金)、size(仓位数量)、entryPriceUsd(开仓价)、leverage(杠杆)、createdTime(创建时间)。
  • --since、--until 接受 7d、1w、2h、2025-01-01 这样的日期,或 Unix 时间戳。分页用 --page 和 --limit。
  • --position-side 只在当前这一页里筛选,返回的 total 不受它影响。

限价单和止盈止损单:

jv wallet info                                          # 查看钱包地址 eoa
jv limit-order list --wallet 0x你的钱包地址 --status PENDING
jv limit-order status <limitOrderId>
jv limit-order cancel <limitOrderId>

状态有 PENDING、TRIGGERED、EXECUTING、COMPLETED、FAILED、EXPIRED、CANCELLED。

市价单的执行结果:

jv job status <jobId>

最多等 60 秒,status 是 completed、failed、timeout 或 not_found 之一。