用命令列交易
下面的交易指令都要先完成授權。指令結果預設輸出單行 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 之一。