Swap tokens on Solana via Jupiter aggregator and check wallet balances. Use when user wants to swap tokens, check SOL/token balance, or get swap quotes.
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Manage your Solana wallet: check balances and swap tokens using the Jupiter aggregator.
These environment variables are pre-configured and available for use:
| Variable | Description |
|---|---|
| Path to wallet keypair JSON file |
| Jupiter API key for authenticated requests (avoids platform fees, required for Token2022/pump.fun tokens) |
Note: These are already set in the skill config. Just use
$SOLANA_KEYPAIR_PATH$JUPITER_API_KEY# Check wallet address solana address --keypair "$SOLANA_KEYPAIR_PATH"Check Solana CLI config
solana config get
solana balance --keypair "$SOLANA_KEYPAIR_PATH"
spl-token accounts --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")
spl-token balance <TOKEN_MINT_ADDRESS> --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")
| Token | Symbol | Mint Address | Decimals |
|---|---|---|---|
| Wrapped SOL | SOL | So11111111111111111111111111111111111111112 | 9 |
| USD Coin | USDC | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v | 6 |
| Tether | USDT | Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB | 6 |
| Bonk | BONK | DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 | 5 |
| Jupiter | JUP | JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN | 6 |
| Raydium | RAY | 4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R | 6 |
CRITICAL: Always display swap details and wait for explicit user confirmation before executing any swap.
Convert human-readable amounts to raw units:
# Example: Get quote for swapping 1 SOL to USDC INPUT_MINT="So11111111111111111111111111111111111111112" OUTPUT_MINT="EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" AMOUNT="1000000000" # 1 SOL in lamports SLIPPAGE_BPS="50" # 0.5% slippageGet quote with API key authentication
curl -s -H "x-api-key: $JUPITER_API_KEY"
"https://api.jup.ag/swap/v1/quote?inputMint=${INPUT_MINT}&outputMint=${OUTPUT_MINT}&amount=${AMOUNT}&slippageBps=${SLIPPAGE_BPS}" | jq .
Parse the quote response and display to user:
IMPORTANT: Ask user "Do you want to proceed with this swap?" and wait for explicit confirmation ("yes", "proceed", "confirm") before continuing.
After user confirms, request the swap transaction:
USER_PUBKEY=$(solana address --keypair "$SOLANA_KEYPAIR_PATH")Save quote response to file
QUOTE_FILE="/tmp/jupiter_quote.json" curl -s -H "x-api-key: $JUPITER_API_KEY"
"https://api.jup.ag/swap/v1/quote?inputMint=${INPUT_MINT}&outputMint=${OUTPUT_MINT}&amount=${AMOUNT}&slippageBps=${SLIPPAGE_BPS}" > "$QUOTE_FILE"Request swap transaction
curl -s -X POST
-H "x-api-key: $JUPITER_API_KEY"
-H "Content-Type: application/json"
"https://api.jup.ag/swap/v1/swap"
-d "{ "quoteResponse": $(cat $QUOTE_FILE), "userPublicKey": "${USER_PUBKEY}", "dynamicComputeUnitLimit": true, "prioritizationFeeLamports": { "priorityLevelWithMaxLamports": { "maxLamports": 5000000, "priorityLevel": "high" } } }" > /tmp/jupiter_swap.jsonExtract the swap transaction
SWAP_TX=$(cat /tmp/jupiter_swap.json | jq -r '.swapTransaction')
Use the jupiter-swap.mjs script to sign and submit:
node "$(dirname "$0")/scripts/jupiter-swap.mjs" \ --keypair "$SOLANA_KEYPAIR_PATH" \ --transaction "$SWAP_TX"
The script will output the transaction signature and a Solscan link.
| Error | Cause | Solution |
|---|---|---|
| "Insufficient balance" | Not enough input tokens | Check balance, reduce swap amount |
| "Slippage tolerance exceeded" | Price moved during swap | Get fresh quote, consider higher slippage |
| "Transaction expired" | Blockhash too old | Get fresh quote and retry immediately |
| "Account not found" | Missing token account | Token account will be created automatically |
| "Route not found" | No liquidity for pair | Try smaller amount or different token |
| "Platform fee not supported" | Token2022 tokens block platform fees | Use authenticated API with $JUPITER_API_KEY header |
If a swap fails due to network issues:
User: "What's my SOL balance?"
solana balance --keypair "$SOLANA_KEYPAIR_PATH"User: "Swap 0.5 SOL for USDC"
User: "Show me all my tokens"
spl-token accounts --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")No automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.