Skip to main content
The Jupiter CLI (jup) lets you interact with Jupiter’s products from the command line. Trade spot, open perps positions, earn yield, and more.
The CLI is pre-v1 (early alpha) and should be considered unstable. Breaking changes may be introduced without warning.

Install

npm i -g @jup-ag/cli
For other install methods (install script, standalone binary), see the CLI repository.

Usage

The CLI covers Jupiter products like Spot (swaps, portfolio, transfers), Perps (leveraged longs/shorts), and Lend (earn yield on deposits). For the full command reference, key management, configuration, and examples, see the full CLI documentation in the public CLI repository.

Ways to Use

Terminal

The most direct way. Install, add a key, and start trading:
jup keys add mykey
jup spot swap --from SOL --to USDC --amount 1

Telegram

Use the CLI through OpenClaw, an open-source AI assistant that runs locally and connects to Telegram and other chat apps (WhatsApp, Discord, Slack, Signal).
  1. Install OpenClaw:
    curl -fsSL https://openclaw.ai/install.sh | bash
    
  2. Connect your Telegram account by following the OpenClaw setup guide
  3. Install the Jupiter CLI:
    npm i -g @jup-ag/cli
    
  4. Add a key:
    jup keys add mykey
    
  5. Message your OpenClaw bot on Telegram:
    “Swap 1 SOL to USDC”
    OpenClaw executes the CLI command on your behalf and returns the result in chat.
For a more lightweight starting point, check out miniclaw, a minimal open-source personal AI assistant you can run locally with Telegram.

AI Agents

The CLI is designed to be LLM-friendly. All commands are non-interactive and support JSON output for structured, parseable responses.
jup spot swap --from SOL --to USDC --amount 1 -f json
AI agents (Claude Code, Cursor, Codex, etc.) can invoke CLI commands directly through shell access. Point your agent at the CLI documentation on GitHub for complete command references and JSON response schemas.
Set an API key from Portal for higher rate limits when running automated workflows:
jup config set --api-key <your-key>

Resources

CLI Documentation

Full command reference, key management, configuration, and examples.

Developer Portal

Get an API key for higher rate limits.