Jupiter CLI

CLI for interacting with Jupiter's products on Solana: Spot, Perps, Lend, Prediction Markets and more.

[!WARNING] This project is pre-v1 (early alpha) and should be considered unstable. Breaking changes may be introduced without warning. Please reach out to the team if you'd like to use or contribute to the CLI.

Install

Install via npm:

npm i -g @jup-ag/cli

Or use the install script to auto-detect the best method:

curl -fsSL https://raw.githubusercontent.com/jup-ag/cli/main/scripts/install.sh | bash

Quick Start

# Generate a new private key called 'key1'
jup keys add key1
# Or import from a JSON file generated via `solana-keygen`
jup keys add key1 --file /path/to/solana-keygen.json
# Or import from a seed phrase
jup keys add key1 --seed-phrase "word1 word2 ..." --derivation-path "m/44'/501'/0'/0'" # optional, defaults to "m/44'/501'/0'/0'"
# Or import from a private key (accepts hex, base58, base64, or JSON byte array)
jup keys add key1 --private-key <key>

# View your spot portfolio
jup spot portfolio
# Swap 1 SOL to USDC
jup spot swap --from SOL --to USDC --amount 1

# Open a 3x long SOL position with $10 USDC
jup perps open --asset SOL --side long --amount 10 --input USDC --leverage 3
# View your perps positions
jup perps positions

Docs

[!NOTE] This CLI is designed to be LLM friendly and all commands are non-interactive. Set JSON output mode globally for structured responses: jup config set --output json, or use -f json flag on individual commands.

Read the docs for specific guides, examples, and workflows:

• Setup: Installation of the CLI
• Config: CLI settings and configurations
• Keys: Private key management
• Spot: Spot trading, transfers, token search and portfolio data
• Perps: Perps trading (leveraged longs/shorts)

Changelog

See CHANGELOG.md for a detailed release history.