Swaps with Jupiter

Jupiter aggregates liquidity across Raydium, Orca, Meteora, and other Solana AMMs into a single swap API. Use it when you need best-price routing without maintaining pool graphs yourself.

Recipe

Quick-reference recipe card - copy-paste ready.

const quote = await fetch(
  `https://quote-api.jup.ag/v6/quote?inputMint=${inMint}&outputMint=${outMint}&amount=${amount}&slippageBps=50`
).then((r) => r.json());
 
const swap = await fetch("https://quote-api.jup.ag/v6/swap", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ quoteResponse: quote, userPublicKey: wallet, wrapAndUnwrapSol: true }),
}).then((r) => r.json());

When to reach for this:

• Building a wallet swap UI without curating pool lists.
• Backend rebalancing treasuries across SPL tokens.
• Routing through multiple AMM hops in one transaction.
• Getting serialized transactions for @solana/kit 7.0.0 signers.

Working Example

import { createSolanaRpc, address, lamports } from "@solana/kit";
import { getBase58Codec } from "@solana/codecs-strings";
 
const RPC = "https://api.mainnet-beta.solana.com";
const rpc = createSolanaRpc(RPC);
 
const inputMint = "So11111111111111111111111111111111111111112";
const outputMint = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
const amount = "50000000"; // 0.05 SOL
const slippageBps = 50;
const userPublicKey = "YOUR_WALLET_PUBKEY";
 
const quote = await fetch(
  `https://quote-api.jup.ag/v6/quote?inputMint=${inputMint}&outputMint=${outputMint}&amount=${amount}&slippageBps=${slippageBps}`
).then((r) => r.json());
 
const { swapTransaction } = await fetch("https://quote-api.jup.ag/v6/swap", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    quoteResponse: quote,
    userPublicKey,
    wrapAndUnwrapSol: true,
    dynamicComputeUnitLimit: true,
    prioritizationFeeLamports: "auto",
  }),
}).then((r) => r.json());
 
const txBytes = getBase58Codec().decode(swapTransaction);
// Sign txBytes with wallet, send via rpc.sendTransaction(...)
console.log("Expected out:", quote.outAmount);

What this demonstrates:

• Quote API returns outAmount, priceImpactPct, and routePlan.
• Swap API returns a base58-encoded versioned transaction ready to sign.
• dynamicComputeUnitLimit and prioritizationFeeLamports tune landing on Agave 4.1.1.

Deep Dive

How It Works

• Jupiter's router scans live pool state and builds a multi-hop route.
• The swap transaction bundles CPIs into each AMM program in route order.
• Token accounts, wSOL wrap/unwrap, and ATAs are handled in the instruction list.
• Versioned transactions may include address lookup tables for account compression.

Jupiter API Surface

TypeScript Notes

// Refresh quote if blockhash ages - quotes expire quickly
const MAX_QUOTE_AGE_MS = 30_000;
const quotedAt = Date.now();
// Re-quote before send if Date.now() - quotedAt > MAX_QUOTE_AGE_MS

Gotchas

• Stale quotes - Routes invalidate as reserves move. Fix: Re-fetch quote immediately before swap and set a max age window.
• Slippage too low - Volatile pairs fail with SlippageToleranceExceeded. Fix: Increase slippageBps or split into smaller swaps.
• Missing ATA - Output token account may not exist. Fix: Enable createAta options or pre-create ATA in a setup tx.
• wSOL confusion - Native SOL and wSOL are different mints. Fix: Use wrapAndUnwrapSol: true or manage wSOL ATA explicitly.
• Compute budget - Multi-hop routes exceed default 200k CU. Fix: Use dynamicComputeUnitLimit: true.
• Mainnet-only pools - Devnet has thin liquidity. Fix: Test routing on mainnet fork via Surfpool 0.12.0, not bare devnet.

Alternatives

FAQs

Related

• DeFi Basics on Solana - composability overview
• AMMs (Raydium, Orca, Meteora) - venues Jupiter routes through
• Jito & MEV - landing swaps under contention
• DeFi Integrations Best Practices - production swap policy

Stack versions: This page was written for Agave 4.1.1, Solana CLI 3.0.10, Anchor 0.32.1, anchor-lang 0.32.1, Rust 1.91.1, @solana/kit 7.0.0, Surfpool 0.12.0, and LiteSVM 0.6.x.