跳到內容

用命令列交易

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