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.
Authorization and wallets
Section titled “Authorization and wallets”| 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) |
Market data
Section titled “Market data”| Command | What it does |
|---|---|
jv market list [--json] |
Tradable markets: trading symbol, trading pair, margin asset, maximum leverage |
jv price --symbol <symbol> |
Live price |
Trading
Section titled “Trading”| 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.
Queries
Section titled “Queries”| 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 |
Deposits and withdrawals
Section titled “Deposits and withdrawals”| 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 |
AI agents and maintenance
Section titled “AI agents and maintenance”| 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 |
Defaults
Section titled “Defaults”| 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 |
Environment variables
Section titled “Environment variables”| 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.
Common errors
Section titled “Common errors”| 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 |