コンテンツにスキップ

コマンド早見表

各コマンドに --help を付けると全パラメーターを確認でき、jv --version でバージョンを確認できます。ほとんどのコマンドは --pretty によるインデント付き JSON の出力に対応しています。jv market list は例外で、デフォルトで表を出力し、--json にのみ対応しています。

コマンド 説明
jv enable [--name <名前>] [--timeout <秒数>] ブラウザーで認可し、ウォレットプロファイルを作成または更新
jv wallet list ウォレットプロファイルを一覧表示
jv wallet info 現在のウォレットプロファイルの詳細
jv wallet switch [<名前>] 現在のウォレットプロファイルを切り替え
jv wallet rename <旧名前> <新名前> 名前を変更
jv wallet remove <名前> ウォレットプロファイルを削除(現在使用中のものは削除不可)
コマンド 説明
jv market list [--json] 取引可能なマーケット:シンボル、取引ペア、証拠金資産、最大レバレッジ
jv price --symbol <シンボル> リアルタイム価格
コマンド 説明
jv order create --side <売買方向> --symbol <シンボル> -m <証拠金> [--leverage <倍率>] [--limit-price <価格>] [--ttl <秒数>] [PPOオプション] 成行注文または指値注文。既存のポジションがある場合、同じ方向ならポジション追加です。逆方向の場合、証拠金がポジションの現在の証拠金と等しければ全決済、大きければまず決済してから逆方向にオープンします。詳しくはコマンドラインで取引するを参照
jv order close --order-id <注文ID> 1 つのポジションを決済。縮小したことのあるポジションは、決済後に逆方向へオープンする処理になる可能性があるため、決済後に jv orders list で確認
jv order close --all すべてのポジションを決済
jv order protect --order-id <注文ID> --symbol <シンボル> [PPOオプション] 既存のポジションに PPO を追加。ポジションサイズは変わりません
jv tp set --order-id <注文ID> --price <価格> --symbol <シンボル> [--side short] [--ttl <秒数>] 利確
jv sl set --order-id <注文ID> --price <価格> --symbol <シンボル> [--side short] [--ttl <秒数>] 損切り

<売買方向> には long または short を指定します。PPO パラメーター:--ppo、--ppo-expire(30m、8h)、--ppo-category(ATM、OTM)、--ppo-tier(1 から 5)。jv order protect には --ppo は不要で、残りの 3 つのパラメーターはそのまま使えます。

コマンド 説明
jv orders list [--all] [--position-side LONG] [--since 7d] [--until <時刻>] [--page <ページ>] [--limit <件数>] 保有ポジションと過去の注文
jv orders get <注文ID> 個別の注文
jv orders stats 注文の総数、保有中と決済済みの件数
jv limit-order list --wallet <ウォレットアドレス> [--status <ステータス>] 指値注文と利確・損切り注文
jv limit-order status <limitOrderId> 個別の指値注文のステータス
jv limit-order cancel <limitOrderId> 指値注文または利確・損切り注文をキャンセル
jv job status <jobId> 成行注文の執行結果
コマンド 説明
jv deposit --token usdc --amount <数量> [--timeout <秒数>] [--no-wait] Base から入金:コマンドが出力した Web ページを開き、ウォレットで署名
jv withdraw --token usdc --amount <数量> [--timeout <秒数>] Base へ出金:コマンドが出力した Web ページを開き、ウォレットで署名

AI エージェントとメンテナンス

Section titled “AI エージェントとメンテナンス”
コマンド 説明
jv install [--ai <プラットフォーム>] [--global] [--force] スキルと MCP 設定をインストール。<プラットフォーム> には claude、cursor、openclaw のいずれかを指定し、省略すると 3 つすべてをインストール
jv uninstall --ai <プラットフォーム> [--global] アンインストール。<プラットフォーム> には all も指定可能
jv mcp stdio モードで MCP サーバーを起動
jv update [--force] 最新バージョンにアップグレード
項目 デフォルト値
レバレッジ 50 倍
注文の有効期間(--ttl) 3600 秒
利確・損切りの有効期間(--ttl) 86400 秒
PPO の期間 30m
PPO のカテゴリー ATM
認可、入金、出金の待機時間(--timeout) 900 秒
成行注文の執行結果の待機 60 秒
1 件の HTTP リクエストのタイムアウト 30 秒
変数 説明
BASE_HTTP_RPC_URL Base メインネットの RPC アドレス。jv enable と jv withdraw では設定が必須
JV_TIMEOUT 任意。1 件の HTTP リクエストのタイムアウト時間(ミリ秒)

ローカルファイルの場所は jv CLI のインストールを参照してください。

エラーまたは現象 原因 対処
Delegation key not found 現在のウォレットプロファイルがまだ認可されていない jv enable を実行
No vault profile for environment beta まだ認可していない、または選択中のウォレットプロファイルが正しくない jv wallet list で確認して jv wallet switch で切り替えるか、jv enable を実行
BASE_HTTP_RPC_URL がないというメッセージ jv enable または jv withdraw の実行時にこの変数が設定されていない 設定してから再試行
Token … not found for environment beta --symbol が取引可能なシンボルではない jv market list の SYMBOL 列の値を指定
Failed to fetch price … HTTP 404 jv price に BTC のようなコードを指定した JVBTC などのシンボルを指定
--side must be long or short 方向の指定が誤っている long または short を指定
OTM requires --ppo-tier (1-5) OTM を選んだがティアを指定していない --ppo-tier を追加
--ppo-expire must be 30m or 8h 期間の値が正しくない 30m または 8h のみ指定可能
Specify exactly one of --order-id or --all jv order close に 2 つのパラメーターを両方指定した、またはどちらも指定していない どちらか一方だけを指定
Order … not found in Subgraph、Order … is not active 注文番号が正しくない、またはポジションがすでに決済されている jv orders list で現在の保有ポジションを確認
以前は使えたコマンドで認可エラーが出るようになった(例:deadline expired を含む) 認可の有効期限が切れている jv enable を再実行
注文系コマンドが "status": "timeout"(エラー Client timeout after 60 seconds)または "status": "failed" を返す 60 秒以内に結果を取得できなかった、または CLI が結果を照会する際にエラーが発生した。注文はすでに受け付けられている、あるいは約定している可能性がある まず jv orders list、jv limit-order list で確認してから、再注文するかどうかを判断
"success": false が出力され、message に expired が含まれる 認可、入金、出金のページが期限内に完了しなかった コマンドを再実行
"arrived": false 入金がまだクロスチェーンで移動中 数分後に Web 版で残高を確認
Skill already exists at … jv install のインストール先にすでにスキルがある --force を付けて上書き
Request timed out after 30000ms またはその他のネットワークエラー(終了コード 2) ネットワークまたはサービスの応答が遅い。注文リクエストはすでに受け付けられている可能性がある 注文系コマンドは、まず jv orders list、jv limit-order list で確認してから再注文。照会系コマンドはそのまま再試行するか、JV_TIMEOUT を大きくしてもかまいません