Swaps com Jupiter

O Jupiter agrega liquidez entre Raydium, Orca, Meteora e outros AMMs Solana em uma única API de swap. Use-o quando precisar de roteamento de melhor preço sem manter os gráficos de pool você mesmo.

Receita

Cartão de receita de referência rápida - pronto para copiar e colar.

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());

Quando usar isso:

• Construindo uma interface de swap de carteira sem curadoria de listas de pools.
• Rebalanceamento de tesourarias entre tokens SPL no backend.
• Roteamento através de múltiplos saltos de AMM em uma única transação.
• Obtendo transações serializadas para signatários do @solana/kit 7.0.0.

Exemplo de Trabalho

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);
// Assine txBytes com a carteira, envie via rpc.sendTransaction(...)
console.log("Saída esperada:", quote.outAmount);

O que isso demonstra:

• A API de cotação retorna outAmount, priceImpactPct e routePlan.
• A API de swap retorna uma transação versionada codificada em base58 pronta para assinar.
• dynamicComputeUnitLimit e prioritizationFeeLamports ajustam o pouso no Agave 4.1.1.

Mergulho Profundo

Como Funciona

• O roteador do Jupiter escaneia o estado atual do pool e constrói uma rota de múltiplos saltos.
• A transação de swap agrupa CPIs em cada programa AMM na ordem da rota.
• Contas de token, encapsulamento/desencapsulamento de wSOL e ATAs são tratados na lista de instruções.
• Transações versionadas podem incluir tabelas de lookup de endereços para compressão de contas.

Superfície da API do Jupiter

Notas de TypeScript

// Atualiza a cota se o blockhash envelhecer - as cotas expiram rapidamente
const MAX_QUOTE_AGE_MS = 30_000;
const quotedAt = Date.now();
// Re-cota antes de enviar se Date.now() - quotedAt > MAX_QUOTE_AGE_MS

Armadilhas

• Cotas desatualizadas - Rotas invalidam à medida que as reservas se movem. Correção: Reobtenha a cota imediatamente antes do swap e defina uma janela de idade máxima.
• Slippage muito baixo - Pares voláteis falham com SlippageToleranceExceeded. Correção: Aumente slippageBps ou divida em swaps menores.
• ATA ausente - A conta de token de saída pode não existir. Correção: Habilite as opções createAta ou pré-crie o ATA em uma tx de configuração.
• Confusão de wSOL - SOL nativo e wSOL são mints diferentes. Correção: Use wrapAndUnwrapSol: true ou gerencie o ATA de wSOL explicitamente.
• Orçamento de computação - Rotas de múltiplos saltos excedem o limite padrão de 200k CU. Correção: Use dynamicComputeUnitLimit: true.
• Pools apenas em Mainnet - Devnet tem liquidez fina. Correção: Teste o roteamento em um fork da mainnet via Surfpool 0.12.0, não em devnet puro.

Alternativas

FAQs

Relacionado

• Noções Básicas de DeFi na Solana - visão geral de composabilidade
• AMMs (Raydium, Orca, Meteora) - locais pelos quais o Jupiter roteia
• Jito & MEV - pousando swaps sob contenção
• Melhores Práticas de Integrações DeFi - política de swap de produção

Versões da Stack: Esta página foi escrita para 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, e LiteSVM 0.6.x.