Skip to content

Command Reference

Every command accepts --help to show all of its flags; jv --version shows the version. Most commands support --pretty for indented JSON output. jv market list is an exception: it prints a table by default and only supports --json.

Command What it does
jv enable [--name <name>] [--timeout <seconds>] Authorizes in the browser, creating or renewing a wallet profile
jv wallet list Lists wallet profiles
jv wallet info Shows details of the active wallet profile
jv wallet switch [<name>] Switches the active wallet profile
jv wallet rename <old-name> <new-name> Renames a profile
jv wallet remove <name> Deletes a wallet profile (not the one currently in use)
Command What it does
jv market list [--json] Tradable markets: trading symbol, trading pair, margin asset, maximum leverage
jv price --symbol <symbol> Live price
Command What it does
jv order create --side <side> --symbol <symbol> -m <margin> [--leverage <multiplier>] [--limit-price <price>] [--ttl <seconds>] [PPO options] Market or limit order. With an existing position, the same side adds to it; for the opposite side, a margin equal to the position’s current margin closes the entire position, and a larger margin closes it first and then opens in the opposite direction. For details, see Trade from the Command Line
jv order close --order-id <order-id> Closes one position; a position you have reduced may be processed as a close followed by a reverse open, so confirm with jv orders list after closing
jv order close --all Closes all positions
jv order protect --order-id <order-id> --symbol <symbol> [PPO options] Adds PPO to an existing position without changing the position size
jv tp set --order-id <order-id> --price <price> --symbol <symbol> [--side short] [--ttl <seconds>] Take profit
jv sl set --order-id <order-id> --price <price> --symbol <symbol> [--side short] [--ttl <seconds>] Stop loss

<side> is long or short. PPO flags: --ppo, --ppo-expire (30m, 8h), --ppo-category (ATM, OTM), --ppo-tier (1 to 5). jv order protect does not need --ppo; the other three flags work the same way.

Command What it does
jv orders list [--all] [--position-side LONG] [--since 7d] [--until <time>] [--page <page>] [--limit <count>] Positions and order history
jv orders get <order-id> A single order
jv orders stats Total orders, open positions, and closed positions
jv limit-order list --wallet <wallet-address> [--status <status>] Limit orders and TP/SL orders
jv limit-order status <limitOrderId> Status of a single limit order
jv limit-order cancel <limitOrderId> Cancels a limit order or TP/SL order
jv job status <jobId> Market order execution result
Command What it does
jv deposit --token usdc --amount <amount> [--timeout <seconds>] [--no-wait] Deposits from Base: open the web page the command gives you and sign with your wallet
jv withdraw --token usdc --amount <amount> [--timeout <seconds>] Withdraws to Base: open the web page the command gives you and sign with your wallet
Command What it does
jv install [--ai <platform>] [--global] [--force] Installs the skill and MCP configuration; set <platform> to claude, cursor, or openclaw, or omit it to install all three
jv uninstall --ai <platform> [--global] Uninstalls; <platform> can also be all
jv mcp Starts the MCP server in stdio mode
jv update [--force] Upgrades to the latest version
Item Default
Leverage 50x
Order validity (--ttl) 3600 seconds
TP/SL validity (--ttl) 86400 seconds
PPO duration 30m
PPO category ATM
Wait time for authorization, deposits, and withdrawals (--timeout) 900 seconds
Wait for a market order’s execution result 60 seconds
Timeout for a single HTTP request 30 seconds
Variable Description
BASE_HTTP_RPC_URL Base mainnet RPC URL; required for jv enable and jv withdraw
JV_TIMEOUT Optional; timeout for a single HTTP request, in milliseconds

For the location of local files, see Install the jv CLI.

Error or symptom Cause Fix
Delegation key not found The active wallet profile has not been authorized yet Run jv enable
No vault profile for environment beta Not authorized yet, or the wrong wallet profile is selected Check with jv wallet list and switch with jv wallet switch, or run jv enable
A message that BASE_HTTP_RPC_URL is missing The variable was not set when running jv enable or jv withdraw Set it and retry
Token … not found for environment beta --symbol is not a tradable symbol Use the SYMBOL column of jv market list
Failed to fetch price … HTTP 404 jv price was given a symbol such as BTC Use the trading symbol, such as JVBTC
--side must be long or short The side is wrong Use long or short
OTM requires --ppo-tier (1-5) OTM was selected without a tier Add --ppo-tier
--ppo-expire must be 30m or 8h Invalid duration value Use only 30m or 8h
Specify exactly one of --order-id or --all jv order close was given both flags, or neither Give only one of them
Order … not found in Subgraph, Order … is not active Wrong order ID, or the position is already closed Check your current positions with jv orders list
A command that used to work starts returning authorization errors, for example containing deadline expired The authorization has expired Run jv enable again
An order command returns "status": "timeout" (error Client timeout after 60 seconds) or "status": "failed" No result within 60 seconds, or the CLI hit an error while querying the result; the order may already have been accepted or even filled Check with jv orders list and jv limit-order list first, then decide whether to place it again
Output is "success": false with expired in message The authorization, deposit, or withdrawal page was not completed in time Run the command again
"arrived": false The deposit is still in transit across chains Check your balance on the web app in a few minutes
Skill already exists at … A skill already exists at the jv install target location Add --force to overwrite it
Request timed out after 30000ms or other network errors (exit code 2) The network or service is slow to respond; the order request may already have been accepted For order commands, check with jv orders list and jv limit-order list before placing the order again; for query commands, retry directly, or increase JV_TIMEOUT