コマンドラインで取引する
以下の取引コマンドを使うには、先に認可を完了しておく必要があります。コマンドの結果はデフォルトで 1 行の 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 など |
ポジションのオープン時に 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 を返し、価格に達すると自動的に執行されます。
結果が不明確な場合
Section titled “結果が不明確な場合”注文系コマンド(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 closeはポジションの方向、レバレッジ、margin(累計で預け入れた証拠金)を読み取り、逆方向の注文を送信します。縮小したことのあるポジションでは、この証拠金がポジションの現在の証拠金より大きくなるため、決済後に逆方向へオープンする処理になる可能性があります。このようなポジションは Web 版で決済することをおすすめします。jv order closeで決済した後は、jv orders listでポジションが決済されていること、逆方向の新しいポジションがオープンされていないことを確認してください。--order-idと--allはどちらか一方を指定します。--allは 1 件ずつ順番に決済し、{"closed":[…],"failed":[…]}を 1 行出力します。1 件でも失敗すると終了コードは 3 になります。
注文番号は jv orders list の各注文の id です。
利確・損切り
Section titled “利確・損切り”--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)とはと保護期間・範囲・強度を参照してください。
ポジションのオープン時に保護を付ける:
| パラメーター | 値 | デフォルト |
|---|---|---|
--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 はまずプレミアムの見積もりを取得してから送信し、執行結果を最大 60 秒待ちます。stdout には送信の受付結果と執行結果の 2 行が出力されます。
注意:
- 既存のポジションに保護を追加するには
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 のいずれかです。