跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
设计与 UI

dex-execution

Solana DEX swap execution via Jupiter aggregator including quoting, transaction building, signing, and confirmation

agiprolabs · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add agiprolabs/claude-trading-skills --skill dex-execution

技能说明


name: dex-execution description: Solana DEX swap execution via Jupiter aggregator including quoting, transaction building, signing, and confirmation

DEX Execution — Solana Swap Execution via Jupiter

Execute token swaps on Solana through Jupiter, the dominant DEX aggregator routing across Raydium, Orca, Meteora, Phoenix, Lifinity, and 20+ other venues.

Overview

Jupiter aggregates liquidity across all major Solana DEXes to find optimal swap routes. A single swap may split across multiple pools and hop through intermediate tokens to minimize price impact. The Jupiter v6 API handles route discovery, transaction building, and fee optimization — your code handles quoting, user confirmation, signing, and submission.

Base URL: https://quote-api.jup.ag/v6

Execution Pipeline

Every swap follows this seven-step pipeline. Never skip steps 2-3 (display and confirm).

Step 1 — Get Quote

import httpx

params = {
    "inputMint": "So11111111111111111111111111111111111111112",   # SOL
    "outputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", # USDC
    "amount": 1_000_000_000,  # 1 SOL in lamports
    "slippageBps": 50,        # 0.5%
}
resp = httpx.get("https://quote-api.jup.ag/v6/quote", params=params)
quote = resp.json()

Step 2 — Display Quote to User

Always show these fields before proceeding:

FieldSource
Input amountquote["inAmount"] (in token decimals)
Output amountquote["outAmount"]
Minimum receivedquote["otherAmountThreshold"]
Price impactquote["priceImpactPct"]
Routequote["routePlan"] — DEXes used
SlippageThe slippageBps you requested

Step 3 — Require User Confirmation

⚠️  SWAP PREVIEW
    Selling:   1.000 SOL
    Buying:    ~142.50 USDC
    Min recv:  141.79 USDC (0.5% slippage)
    Impact:    0.01%
    Route:     Raydium V4 → USDC

    Proceed? [y/N]

NEVER proceed without explicit "yes" from the user.

Step 4 — Build Transaction

swap_body = {
    "quoteResponse": quote,
    "userPublicKey": "YourPubkeyBase58...",
    "wrapAndUnwrapSol": True,
    "dynamicComputeUnitLimit": True,
    "prioritizationFeeLamports": "auto",
}
resp = httpx.post("https://quote-api.jup.ag/v6/swap", json=swap_body)
swap_data = resp.json()
swap_tx = swap_data["swapTransaction"]  # base64-encoded transaction

Step 5 — Sign Transaction

import base64
from solders.transaction import VersionedTransaction
from solders.keypair import Keypair

raw_tx = base64.b64decode(swap_tx)
tx = VersionedTransaction.from_bytes(raw_tx)
keypair = Keypair.from_base58_string(os.environ["WALLET_PRIVATE_KEY"])
tx.sign([keypair])

Step 6 — Submit Transaction

rpc_url = os.environ.get("SOLANA_RPC_URL", "https://api.mainnet-beta.solana.com")
signed_bytes = bytes(tx)
payload = {
    "jsonrpc": "2.0", "id": 1,
    "method": "sendTransaction",
    "params": [
        base64.b64encode(signed_bytes).decode(),
        {"encoding": "base64", "skipPreflight": False,
         "maxRetries": 3, "preflightCommitment": "confirmed"}
    ],
}
resp = httpx.post(rpc_url, json=payload)
sig = resp.json()["result"]
print(f"Submitted: https://solscan.io/tx/{sig}")

Step 7 — Confirm Transaction

import time

for attempt in range(30):
    payload = {
        "jsonrpc": "2.0", "id": 1,
        "method": "getSignatureStatuses",
        "params": [[sig], {"searchTransactionHistory": False}],
    }
    resp = httpx.post(rpc_url, json=payload)
    status = resp.json()["result"]["value"][0]
    if status and status.get("confirmationStatus") in ("confirmed", "finalized"):
        print(f"Confirmed at slot {status['slot']}")
        break
    time.sleep(2)
else:
    print("Transaction not confirmed within 60s — check explorer")

Jupiter API v6 Endpoints

EndpointMethodPurpose
/quoteGETGet best-price quote with routing
/swapPOSTBuild a swap transaction from a quote
/swap-instructionsPOSTGet individual instructions (advanced)
/price?ids=token1,token2GETSimple price lookup (v2)
/tokensGETList all supported tokens

See references/jupiter_api.md for full parameter and response documentation.

Key Parameters

Slippage (slippageBps)

Token TypeRecommended RangeNotes
SOL, USDC, major tokens50-100 (0.5-1%)Stable liquidity
Mid-cap tokens100-300 (1-3%)Variable liquidity
PumpFun / meme tokens500-2000 (5-20%)Thin books, high volatility
New launches (<1h old)1000-3000 (10-30%)Extreme volatility

Dynamic Slippage

Set dynamicSlippage: true in the swap request to let Jupiter auto-adjust slippage based on current market conditions. Preferred for most use cases.

Priority Fees (prioritizationFeeLamports)

Priority fees determine transaction ordering within a block.

LevelmicroLamportsWhen to Use
Low10,000-50,000Normal conditions
Medium50,000-200,000Moderate congestion
High200,000-1,000,000High congestion / time-sensitive
Urgent1,000,000-5,000,000Meme coin launches, NFT mints
Auto"auto"Jupiter estimates for you

Use "auto" for most cases. For fine-grained control, query Helius getPriorityFeeEstimate.

Other Parameters

  • onlyDirectRoutes: Skip multi-hop routing. Faster but may get worse price.
  • asLegacyTransaction: Use legacy format instead of versioned transactions. Required for some older wallets.
  • maxAccounts: Limit accounts in transaction (default 64). Lower values reduce route options but improve confirmation reliability.
  • platformFeeBps: Integrator fee in basis points. Taken from output amount.
  • wrapAndUnwrapSol: Auto wrap/unwrap SOL ↔ wSOL (default true).
  • dynamicComputeUnitLimit: Auto-set compute budget based on simulation.

Priority Fee Estimation

# Using Helius
阅读完整来源 ↗