用命令行交易
下面的交易命令都要先完成授权。命令结果默认输出单行 JSON,加 --pretty 输出缩进格式。
持仓期间会按资金费率收付资金费,保证金不足时仓位会被强平,规则见强平机制。
查询市场和价格
Section titled “查询市场和价格”SYMBOL是交易代码,下单和查价时--symbol填这一列。目前有 JVBTC、JETH、SKHY、XAU、TQQQ、CL、CRCL、MU、NVDA、TSLA。MARGIN是这个市场的保证金资产,MAX_LEVERAGE是最大杠杆。- 市场列表随 CLI 版本一起发布,新上线的市场要运行
jv update升级后才会出现。 - 加
--json输出 JSON:
查询实时价格:
price 是价格,priceWei 是放大 10^18 倍后的整数。--symbol 要填交易代码,填 BTC 会查不到价格,命令以退出码 2 结束。
开仓:jv order create
Section titled “开仓:jv order create”| 参数 | 说明 |
|---|---|
--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,到价后自动执行。
结果不明确时
Section titled “结果不明确时”下单类命令(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 核对。
加仓、减仓与平仓
Section titled “加仓、减仓与平仓”已经有仓位时,同一交易代码的新订单按方向和保证金处理:
| 新订单 | 结果 |
|---|---|
| 同方向 | 加仓 |
| 反方向,保证金等于仓位当前的保证金 | 全部平仓 |
| 反方向,保证金大于仓位当前的保证金 | 先全部平仓,再用多出来的部分开一张反方向的新仓位;多出来的部分太小时只平仓 |
| 反方向,保证金小于仓位当前的保证金 | 再按仓位数量(保证金 × 杠杆 ÷ 开仓价)比较:小于原仓位是减仓,剩下的太少时全部平仓;等于是全部平仓;大于同样是先平仓再反向开仓 |
反方向下单前请算清保证金和杠杆,否则可能在平仓之后被反向开仓:
- 杠杆填得比原仓位高时,保证金虽然小,仓位数量也可能超过原仓位。减仓时
--leverage要填原仓位的杠杆(jv orders list里的leverage)。 jv orders list里的margin是累计存入的保证金:加仓时变大,减仓时不变。减过仓以后,它比仓位当前的保证金大,不能直接用来计算减仓或平仓的保证金。CLI 目前查不到仓位当前的保证金,减过仓的仓位建议在网页端继续减仓或平仓。
例如一张没有减过仓、20 倍、保证金 100 的 JVBTC 多单,减掉一半:
平仓:
jv order close读取仓位的方向、杠杆和margin(累计存入的保证金),提交一张反方向单。减过仓的仓位,这个保证金会大于仓位当前的保证金,可能被处理成平仓后反向开仓。这类仓位建议在网页端平仓。- 用
jv order close平仓后,用jv orders list确认仓位已经平掉,并且没有新开的反向仓位。 --order-id和--all二选一。--all按顺序逐个平仓,输出一行{"closed":[…],"failed":[…]},只要有一个失败,退出码就是 3。
订单号是 jv orders list 里每条订单的 id。
--side默认是long。空单必须加--side short,否则 CLI 会按多单的方向和仓位账户签名。- 触发后平掉整个仓位,不会反向开仓。
- 默认 24 小时有效(
--ttl 86400),到期前没有触发需要重新设置。 - 返回一行 JSON,带
limitOrderId。止盈止损单和限价单一样,用jv limit-order查询和取消。
永续合约保护(PP):PPO 参数
Section titled “永续合约保护(PP):PPO 参数”在 CLI 里,永续合约保护(PP)通过 PPO 期权实现:多单配看跌期权(PUT),空单配看涨期权(CALL),不用手动选择。概念和费用见什么是永续合约保护(PP)和保护期限、范围与强度。
开仓时附带保护:
| 参数 | 取值 | 默认 |
|---|---|---|
--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 先取保费报价再提交,最多等 60 秒拿执行结果,stdout 输出提交回执和执行结果两行。
注意:
- 给已有仓位加保护请用
jv order protect。jv order create --ppo会同时加仓。 - 对已有 PPO 的仓位加仓或减仓时,如果这次不带
--ppo,原有的 PPO 会被取消;想保留保护,这次操作也要带上--ppo。CLI 没有单独取消 PPO 的命令。 jv order close平仓时不带 PPO。
- 每条订单除了原始字段,还加了可读字段:
margin(保证金)、size(仓位数量)、entryPriceUsd(开仓价)、leverage(杠杆)、createdTime(创建时间)。 --since、--until接受7d、1w、2h、2025-01-01这样的日期,或 Unix 时间戳。分页用--page和--limit。--position-side只在当前这一页里筛选,返回的total不受它影响。
限价单和止盈止损单:
状态有 PENDING、TRIGGERED、EXECUTING、COMPLETED、FAILED、EXPIRED、CANCELLED。
市价单的执行结果:
最多等 60 秒,status 是 completed、failed、timeout 或 not_found 之一。