jupiter

Jupiter Aggregator

Jupiter finds the best swap routes across all Solana DEXes, plus limit orders and DCA (Dollar Cost Averaging).

Commands

Swaps

/jup swap <amount> <from> to <to>    Execute swap via Jupiter
/jup quote <amount> <from> to <to>   Get quote without executing
/jup route <from> <to> <amount>      Show detailed route info

Limit Orders

/jup limit create <sell> <from> for <buy> <to>   Create limit order
/jup limit cancel <order_pubkey>                  Cancel limit order
/jup limit list                                   List your open orders
/jup limit history                                Order history

DCA (Dollar Cost Averaging)

/jup dca create <total> <from> to <to> every <interval>   Create DCA
/jup dca close <dca_pubkey>                               Close DCA
/jup dca list                                             List active DCAs
/jup dca deposit <dca_pubkey> <amount>                    Add funds
/jup dca withdraw <dca_pubkey>                            Withdraw funds

Examples

Swaps

/jup swap 1 SOL to USDC
/jup quote 100 USDC to JUP
/jup route SOL BONK 1

Limit Orders

/jup limit create 1 SOL for 250 USDC        # Sell 1 SOL when price hits $250
/jup limit create 100 USDC for 0.5 SOL      # Buy SOL at $200
/jup limit list
/jup limit cancel ABC123...

DCA

/jup dca create 10 SOL to USDC every 1 day   # DCA 10 SOL into USDC daily
/jup dca create 1000 USDC to JUP every 1 hour # Accumulate JUP hourly
/jup dca list
/jup dca close XYZ789...

Features

• Best route across 20+ DEXes
• Automatic route splitting
• MEV protection
• Priority fee support
• Limit Orders - set target prices
• DCA - automated periodic swaps

Tools Available

Swap Tools

Tool	Description
solana_jupiter_swap	Execute swap
solana_jupiter_quote	Get quote (no execution)

Limit Order Tools

Tool	Description
solana_jupiter_limit_order_create	Create limit order
solana_jupiter_limit_order_cancel	Cancel order
solana_jupiter_limit_orders_list	List open orders
solana_jupiter_limit_order_get	Get order details
solana_jupiter_limit_order_history	Order history
solana_jupiter_trade_history	Trade fill history

DCA Tools

Tool	Description
solana_jupiter_dca_create	Create DCA order
solana_jupiter_dca_close	Close DCA
solana_jupiter_dca_deposit	Add funds
solana_jupiter_dca_withdraw	Withdraw funds
solana_jupiter_dca_list	List active DCAs
solana_jupiter_dca_get	Get DCA details
solana_jupiter_dca_balance	Check balances
solana_jupiter_dca_fills	Fill history

TypeScript API

import {
  // Swaps
  executeJupiterSwap,
  getJupiterQuote,

  // Limit Orders
  createJupiterLimitOrder,
  cancelJupiterLimitOrder,
  listJupiterLimitOrders,
  getJupiterLimitOrder,
  getJupiterLimitOrderHistory,
  getJupiterTradeHistory,

  // DCA
  createJupiterDCA,
  closeJupiterDCA,
  depositJupiterDCA,
  withdrawJupiterDCA,
  listJupiterDCAs,
  getJupiterDCA,
  getJupiterDCABalance,
  getJupiterDCAFillHistory,
} from 'clodds/solana/jupiter';

// Swap example
const swap = await executeJupiterSwap(connection, keypair, {
  inputMint: 'So11111111111111111111111111111111111111112',
  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
  amount: '1000000000', // 1 SOL
  slippageBps: 50,
});

// Limit order example
const order = await createJupiterLimitOrder(connection, keypair, {
  inputMint: 'So11111111111111111111111111111111111111112',
  outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
  inAmount: '1000000000',   // Sell 1 SOL
  outAmount: '250000000',   // For 250 USDC (min)
});

// DCA example
const dca = await createJupiterDCA(connection, keypair, {
  inputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
  outputMint: 'JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN',
  inAmount: '100000000',           // Total 100 USDC
  inAmountPerCycle: '10000000',    // 10 USDC per swap
  cycleSecondsApart: 3600,         // Every hour
});

Environment Variables

SOLANA_PRIVATE_KEY=<base58 or JSON array>
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com  # optional