コンテンツにスキップ

コマンドラインで取引する

以下の取引コマンドを使うには、先に認可を完了しておく必要があります。コマンドの結果はデフォルトで 1 行の 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 で終了します。

ポジションのオープン:jv order create

Section titled “ポジションのオープン:jv order create”
# 成行でロング:証拠金 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 など ポジションのオープン時に Perpetual Protect(PP)を付けます。後述を参照

コマンドは stderr に見積もりを 1 行出力します。例:Estimated: ~0.031214 JVBTC @ $64,073.95 (~$2,000 JVUSD total, 20x)。

  • 成行注文:送信後、執行結果を最大 60 秒待ちます。stdout には 2 行の JSON が出力されます。1 行目は送信の受付結果で jobId を含み、2 行目は執行結果です。"status": "completed" はオンチェーンで約定したことを示し、transactionHash を含みます。結果が completed でない場合、コマンドは終了コード 3 で終了しますが、注文が約定していないとは限りません。後述の「結果が不明確な場合」を参照してください。
  • 指値注文:すぐに limitOrderId を含む 1 行の JSON を返し、価格に達すると自動的に執行されます。

注文系コマンド(jv order create、jv order close、jv order protect、jv tp set、jv sl set)には重複送信を防ぐ仕組みがなく、同じコマンドを 2 回実行すると 2 件の注文になります。明確に成功したと言えるのは次の場合だけです。

  • 成行注文と 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 では現在、ポジションの現在の証拠金を照会できません。縮小したことのあるポジションは、引き続き Web 版で縮小または決済することをおすすめします。

例えば、一度も縮小していない、レバレッジ 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(累計で預け入れた証拠金)を読み取り、逆方向の注文を送信します。縮小したことのあるポジションでは、この証拠金がポジションの現在の証拠金より大きくなるため、決済後に逆方向へオープンする処理になる可能性があります。このようなポジションは Web 版で決済することをおすすめします。
  • jv order close で決済した後は、jv orders list でポジションが決済されていること、逆方向の新しいポジションがオープンされていないことを確認してください。
  • --order-id と --all はどちらか一方を指定します。--all は 1 件ずつ順番に決済し、{"closed":[…],"failed":[…]} を 1 行出力します。1 件でも失敗すると終了コードは 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)です。期限までにトリガーされなかった場合は、設定し直す必要があります。
  • limitOrderId を含む 1 行の JSON を返します。利確・損切り注文は指値注文と同様に、jv limit-order で照会・キャンセルします。

Perpetual Protect(PP):PPO パラメーター

Section titled “Perpetual Protect(PP):PPO パラメーター”

CLI では、Perpetual Protect(PP)は PPO オプションで実現されています。ロングにはプットオプション(PUT)、ショートにはコールオプション(CALL)が組み合わされるため、手動で選ぶ必要はありません。概念と費用は Perpetual Protect(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。1 ティアごとに 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 には送信の受付結果と執行結果の 2 行が出力されます。

注意:

  • 既存のポジションに保護を追加するには jv order protect を使ってください。jv order create --ppo はポジションの追加も同時に行います。
  • PPO が付いているポジションを追加・縮小するときに、その操作で --ppo を付けないと、既存の PPO はキャンセルされます。保護を維持したい場合は、その操作にも --ppo を付けてください。CLI には PPO だけをキャンセルするコマンドはありません。
  • jv order close で決済するときは PPO は付きません。
jv orders list                          # 現在のポジション(デフォルトでは未決済のみ、1 ページ 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 のいずれかです。