✓ Verified 💻 Development ✓ Enhanced Data

Solana Swaps

Swap tokens on Solana via Jupiter aggregator and check wallet balances.

Rating
4.7 (25 reviews)
Downloads
11,575 downloads
Version
1.0.0

Overview

Swap tokens on Solana via Jupiter aggregator and check wallet balances.

✨Key Features

1

Get Quote

2

Display Quote and Request Confirmation

3

Build Swap Transaction

4

Sign and Submit Transaction

Complete Documentation

View Source →

Solana Swaps

Manage your Solana wallet: check balances and swap tokens using the Jupiter aggregator.

Environment Variables

These environment variables are pre-configured and available for use:

VariableDescription
SOLANA_KEYPAIR_PATHPath to wallet keypair JSON file
JUPITER_API_KEYJupiter 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 and $JUPITER_API_KEY directly in commands.

Verify Setup

bash
# Check wallet address
solana address --keypair "$SOLANA_KEYPAIR_PATH"

# Check Solana CLI config
solana config get

Balance Checking

Check SOL Balance

bash
solana balance --keypair "$SOLANA_KEYPAIR_PATH"

List All Token Accounts

bash
spl-token accounts --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")

Check Specific Token Balance

bash
spl-token balance <TOKEN_MINT_ADDRESS> --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")

Common Token Mint Addresses

TokenSymbolMint AddressDecimals
Wrapped SOLSOLSo111111111111111111111111111111111111111129
USD CoinUSDCEPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v6
TetherUSDTEs9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB6
BonkBONKDezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB2635
JupiterJUPJUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN6
RaydiumRAY4k3Dyjzvzp8eMZWUXbBCjEvwSkkk59S5iCNLY3QrkX6R6

Token Swaps via Jupiter

CRITICAL: Always display swap details and wait for explicit user confirmation before executing any swap.

Step 1: Get Quote

Convert human-readable amounts to raw units:

  • SOL: multiply by 1,000,000,000 (10^9)
  • USDC/USDT: multiply by 1,000,000 (10^6)
  • BONK: multiply by 100,000 (10^5)
bash
# 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% slippage

# Get 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 .

Step 2: Display Quote and Request Confirmation

Parse the quote response and display to user:

  • Input: amount and token name
  • Output: expected amount and token name
  • Price impact percentage
  • Slippage tolerance
  • Minimum received (otherAmountThreshold)
IMPORTANT: Ask user "Do you want to proceed with this swap?" and wait for explicit confirmation ("yes", "proceed", "confirm") before continuing.

Step 3: Build Swap Transaction

After user confirms, request the swap transaction:

bash
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.json

# Extract the swap transaction
SWAP_TX=$(cat /tmp/jupiter_swap.json | jq -r '.swapTransaction')

Step 4: Sign and Submit Transaction

Use the jupiter-swap.mjs script to sign and submit:

bash
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.

Safety Rules

  • ALWAYS display swap details and wait for user confirmation before executing
  • NEVER execute swaps automatically without explicit approval
  • ALWAYS check balance before attempting swaps to ensure sufficient funds
  • WARN users if price impact exceeds 1%
  • WARN users if slippage is set above 1% (100 bps)
  • NEVER log, display, or transmit private key contents

Error Handling

ErrorCauseSolution
"Insufficient balance"Not enough input tokensCheck balance, reduce swap amount
"Slippage tolerance exceeded"Price moved during swapGet fresh quote, consider higher slippage
"Transaction expired"Blockhash too oldGet fresh quote and retry immediately
"Account not found"Missing token accountToken account will be created automatically
"Route not found"No liquidity for pairTry smaller amount or different token
"Platform fee not supported"Token2022 tokens block platform feesUse authenticated API with $JUPITER_API_KEY header

Retry Logic

If a swap fails due to network issues:

  • Wait 2-3 seconds
  • Get a fresh quote (prices may have changed)
  • Re-confirm with user showing new quote
  • Retry the swap

Example Interactions

Check Balance

User: "What's my SOL balance?"
  • Run: solana balance --keypair "$SOLANA_KEYPAIR_PATH"
  • Report: "Your wallet has X.XXX SOL"

Swap Tokens

User: "Swap 0.5 SOL for USDC"
  • Get wallet address
  • Fetch Jupiter quote for 0.5 SOL (500000000 lamports) -> USDC
  • Display quote details:
  • From: 0.5 SOL
  • To: ~XX.XX USDC (estimated)
  • Price Impact: X.XX%
  • Minimum Received: XX.XX USDC
  • Ask: "Do you want to proceed with this swap?"
  • Wait for confirmation
  • On "yes": Execute swap, report transaction link
  • On "no": Acknowledge cancellation

List All Tokens

User: "Show me all my tokens"
  • Run: spl-token accounts --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")
  • Format and display token list with balances

Installation

Terminal bash 

openclaw install solana-swaps
Copied!

💻Code Examples

solana config get

solana-config-get.txt
## Balance Checking

### Check SOL Balance

spl-token balance <TOKEN_MINT_ADDRESS> --owner $(solana address --keypair "$SOLANA_KEYPAIR_PATH")

spl-token-balance-tokenmintaddress---owner-solana-address---keypair-solanakeypairpath.txt
## Common Token Mint Addresses

| 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 |

## Token Swaps via Jupiter

**CRITICAL: Always display swap details and wait for explicit user confirmation before executing any swap.**

### Step 1: Get Quote

Convert human-readable amounts to raw units:
- SOL: multiply by 1,000,000,000 (10^9)
- USDC/USDT: multiply by 1,000,000 (10^6)
- BONK: multiply by 100,000 (10^5)

"https://api.jup.ag/swap/v1/quote?inputMint=${INPUT_MINT}&outputMint=${OUTPUT_MINT}&amount=${AMOUNT}&slippageBps=${SLIPPAGE_BPS}" | jq .

-httpsapijupagswapv1quoteinputmintinputmintoutputmintoutputmintamountamountslippagebpsslippagebps--jq-.txt
### Step 2: Display Quote and Request Confirmation

Parse the quote response and display to user:
- Input: amount and token name
- Output: expected amount and token name
- Price impact percentage
- Slippage tolerance
- Minimum received (otherAmountThreshold)

**IMPORTANT**: Ask user "Do you want to proceed with this swap?" and wait for explicit confirmation ("yes", "proceed", "confirm") before continuing.

### Step 3: Build Swap Transaction

After user confirms, request the swap transaction:

SWAP_TX=$(cat /tmp/jupiter_swap.json | jq -r '.swapTransaction')

swaptxcat-tmpjupiterswapjson--jq--r-swaptransaction.txt
### Step 4: Sign and Submit Transaction

Use the jupiter-swap.mjs script to sign and submit:
example.sh
# Check wallet address
solana address --keypair "$SOLANA_KEYPAIR_PATH"

# Check Solana CLI config
solana config get
example.sh
# 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% slippage

# Get 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 .
example.sh
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.json

# Extract the swap transaction
SWAP_TX=$(cat /tmp/jupiter_swap.json | jq -r '.swapTransaction')
example.sh
node "$(dirname "$0")/scripts/jupiter-swap.mjs" \
  --keypair "$SOLANA_KEYPAIR_PATH" \
  --transaction "$SWAP_TX"

Tags

#ai_and-llms

Quick Info

Category Development
Model Claude 3.5
Complexity One-Click
Author imthatcarlos
Last Updated 3/10/2026
🚀
Optimized for
Claude 3.5
🧠

Ready to Install?

Get started with this skill in seconds

openclaw install solana-swaps

Resources

📂
OpenClaw Skills
View on OpenClaw GitHub
→

Related Skills

✓ Verified 💻 Development

4claw

4claw — a moderated imageboard for AI agents.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.4 (118)
↓ 4,990
v1.0.0
✓ Verified 💻 Development

Aap Passport

Agent Attestation Protocol - The Reverse Turing Test.

🧠 Claude-Ready #ai_and-llms
)}
★ 4.3 (89)
↓ 4,621
v1.0.0
✓ Verified 💻 Development

Acestep Lyrics Transcription

Transcribe audio to timestamped lyrics using OpenAI Whisper or ElevenLabs Scribe API.

⚡ GPT-Optimized #ai_and-llms #api #script
)}
★ 3.8 (274)
↓ 17,648
v1.0.0
✓ Verified 💻 Development

Adaptive Suite

A continuously adaptive skill suite that empowers Clawdbot.

🧠 Claude-Ready #ai_and-llms #bot
)}
★ 4.7 (88)
↓ 1,625
v1.0.0