| name | solana-defi |
| description | Trade tokens on Solana via Jupiter and PumpPortal with an auto-provisioned wallet. Use when the user mentions Solana, DeFi, swaps, Jupiter, pump.fun, memecoins, SPL tokens, or Solana portfolio. ALWAYS use ~/scripts/ — never improvise. |
Solana DeFi Trading
name: solana-defi
version: 1.0.0
updated: 2026-03-04
author: InstaClaw
phase: 1
triggers:
keywords: [solana, defi, swap, jupiter, pump.fun, snipe, trade, token, spl, raydium, pumpportal, dexscreener, memecoin, bonk, wif, jup, sol]
phrases: ["buy some", "sell some", "swap tokens", "snipe new launches", "check my balance", "what's in my wallet", "portfolio", "watch for new tokens", "pump.fun", "trade on solana", "buy memecoin", "token price", "new token launch"]
NOT: [polymarket, kalshi, prediction market, stock market, base chain, ethereum]
MANDATORY RULES — Read Before Anything Else
These rules override everything else in this skill file. Violating them causes real financial harm. A real user's agent destroyed its own session by looping on failed trades 69 times until it couldn't respond. These rules prevent that.
Rule 0 — ALWAYS USE SCRIPTS: When a user mentions Solana trading, swaps, sniping, portfolio, or any related topic, IMMEDIATELY use the scripts in ~/scripts/. Do NOT improvise. Do NOT write ad-hoc Python or Node.js code for trading operations. Do NOT raw-dog curl calls to Jupiter or PumpPortal. You already have everything you need — scripts are pre-installed. Run the script first, show the output, then discuss. If unsure whether things are set up, run:
python3 ~/scripts/solana-balance.py check --json
Rule 1 — Maximum 3 Retries Per Operation:
If a trade, API call, or script fails 3 times in a row:
- STOP immediately
- Tell the user exactly what failed and why
- Ask if they want you to try a different approach
- Do NOT retry a 4th time under any circumstances
Rule 2 — Context Budget:
Never dump raw transaction data, full error stack traces, or complete API responses into the conversation. Always summarize:
- GOOD: "Bought 0.05 SOL of BONK at $0.00003 — tx: 4xK7m..."
- BAD: [pasting 200 lines of transaction JSON]
Keep total trading-related context under 50KB per session.
Rule 3 — Error Classification:
TRANSIENT (retry with backoff 5s → 15s → 45s → STOP):
- HTTP 429 (rate limit)
- Network timeout
- RPC node congestion
- "blockhash not found" (retry with fresh blockhash)
PERMANENT (do NOT retry, tell user immediately):
- Insufficient funds / balance
- Invalid mint address
- Wallet not found
- Signature verification failed
- "Program failed to complete" (bad instruction)
DANGEROUS (stop ALL trading, alert user):
- 3+ consecutive empty responses
- Session file exceeding 200KB
- Process killed by SIGKILL (out of memory)
- Same error message appearing 5+ times
Rule 4 — Position Sizing:
- Check user's configured max trade size (default: 0.1 SOL)
- Check user's daily loss limit (default: 0.5 SOL)
- NEVER exceed these limits
- If no limits configured, use defaults and inform user
- Read limits from:
python3 ~/scripts/solana-trade.py limits --json
Rule 5 — Confirmation Before Execution:
- ALWAYS tell the user what you're about to do before doing it
- Example: "I'm going to swap 0.1 SOL for BONK on Jupiter with 1% slippage. Estimated output: 3,450,000 BONK. Proceed?"
- Only skip confirmation if user has explicitly enabled auto-trade mode
Custody Modes: On-Box vs Secure Off-Box (READ THIS)
Your wallet is in ONE of two modes. The scripts detect which and route automatically; you never choose, and you must never try to override it.
Secure off-box mode (governed): your wallet's key lives in a secure signer OFF this box. There is NO private key on this box, and you must NEVER create one. Trades are sized in USD and go through the secure signer, which authorizes and price-bounds every swap so your funds are protected.
- Buy:
python3 ~/scripts/solana-trade.py buy --mint <MINT> --amount-usd 10 --json
- Sell:
python3 ~/scripts/solana-trade.py sell --mint <MINT> --amount-usd 10 --json
- A refusal is FINAL. The secure signer may decline a trade. There is no on-box key to fall back to. You must NEVER run
setup-solana-wallet.py generate, write a key into .env, hand-build a raw swap, or improvise any other way to move funds around a refusal. Tell the user the reason (the script returns a message), and retry ONLY ONCE later, and only if the script says "retryable": true.
- Refusal meanings:
unpriceable_input (no reliable price; suggest a more liquid token; do NOT retry), price_impact_too_high (thin liquidity; suggest a smaller size; do NOT retry), price_divergence / price_stale (prices unstable; retry once shortly), a budget / session / kill reason (an account limit; tell the user, do NOT retry). Direct pump.fun sniping is NOT available off-box; use standard buy/sell, which routes through the secure signer.
On-box mode (legacy): a key is in ~/.openclaw/.env and trades are sized in SOL (--amount). This is today's behavior and is unchanged. Never display the key.
Commands
Balance & Wallet
| Action | Command |
|---|
| Check balance | python3 ~/scripts/solana-balance.py check --json |
| SOL balance only | python3 ~/scripts/solana-balance.py sol --json |
| Token balances | python3 ~/scripts/solana-balance.py tokens --json |
| Wallet address | python3 ~/scripts/setup-solana-wallet.py address |
| Wallet status | python3 ~/scripts/setup-solana-wallet.py status --json |
Trading (Jupiter V6)
| Action | Command |
|---|
| Get quote | python3 ~/scripts/solana-trade.py quote --input SOL --output <MINT> --amount 0.1 --json |
| Buy token | python3 ~/scripts/solana-trade.py buy --mint <MINT> --amount 0.1 --slippage 100 --json |
| Sell token | python3 ~/scripts/solana-trade.py sell --mint <MINT> --amount ALL --slippage 100 --json |
| Check limits | python3 ~/scripts/solana-trade.py limits --json |
Sniping (PumpPortal)
| Action | Command |
|---|
| Buy on pump.fun | python3 ~/scripts/solana-snipe.py buy --mint <MINT> --amount 0.05 --slippage 2500 --json |
| Sell on pump.fun | python3 ~/scripts/solana-snipe.py sell --mint <MINT> --amount ALL --slippage 2500 --json |
| Watch launches | python3 ~/scripts/solana-snipe.py watch --min-sol 5 --max-age 60 --json |
Portfolio & Positions
| Action | Command |
|---|
| Portfolio summary | python3 ~/scripts/solana-positions.py summary --json |
| Position details | python3 ~/scripts/solana-positions.py detail --mint <MINT> --json |
| P&L report | python3 ~/scripts/solana-positions.py pnl --json |
| Trade history | python3 ~/scripts/solana-positions.py history --limit 20 --json |
Price Data (DexScreener)
| Action | Command |
|---|
| Token price | python3 ~/scripts/solana-balance.py price --mint <MINT> --json |
| Search token | python3 ~/scripts/solana-balance.py search --query "bonk" --json |
Wallet Management
Check Wallet Status
Before any trading operation, verify wallet setup:
- Run
python3 ~/scripts/setup-solana-wallet.py status --json
- If wallet exists: check SOL balance, report to user
- If no wallet: tell user "You don't have a wallet set up yet. Enable Solana DeFi Trading in your dashboard at instaclaw.io/dashboard."
NEVER display or log the private key
On a secure off-box wallet there is NO private key on this box to display, retrieve, or regenerate; if asked, say the key is held by the secure signer off the machine and is never exposed, and never run any command to create one. On a legacy on-box wallet the key is in ~/.openclaw/.env; still never display it (say it is stored securely on the VM and you cannot show it).
Common Token Mint Addresses
| Token | Mint Address |
|---|
| SOL (native) | So11111111111111111111111111111111111111112 |
| USDC | EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v |
| USDT | Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB |
| BONK | DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263 |
| WIF | EKpQGSJtjMFqKZ9KQanSqYXRcF8fBopzLHYxdM65zcjm |
| JUP | JUPyiwrYJFskUPiHa7hkeR8VUtAeFoSYbKedZNsDvCN |
Output Formatting
Trade Executed
✅ [BUY/SELL] [amount] [token] at $[price]
tx: [first 8 chars]... | confirmed in [X]s
Wallet balance: [remaining SOL] SOL
Trade Failed
❌ [action] failed: [1-line reason]
Attempt [X/3]. [Next action: retrying in Xs / stopping / asking you]
Portfolio Summary
📊 Your Portfolio (as of [time])
SOL: [balance] ($[usd])
[TOKEN1]: [balance] ($[usd]) [+/-X%]
[TOKEN2]: [balance] ($[usd]) [+/-X%]
Total: ~$[total_usd]
Tiered Capabilities
Tier 1 — Read Only (Default)
- Check wallet balance
- View token prices
- Search tokens
- View portfolio
- No trading, no risk
Tier 2 — Manual Trading (Requires user confirmation per trade)
- Swap tokens via Jupiter
- Buy/sell on pump.fun via PumpPortal
- All trades require explicit user confirmation
- Position sizing enforced
Tier 3 — Autonomous Monitoring (Requires auto_trade=true)
- Watch for new pump.fun launches
- Auto-buy within configured limits
- Monitor and auto-sell based on rules
- Stop after 3 failed trades or daily loss limit hit
- Report all activity to user
Cross-Skill Integration
Prediction Markets + Trading
- Use Polymarket/Kalshi odds to inform token trades
- "Polymarket shows 85% chance of [event]. Buy [related token]?"
Web Search + Trading
Before buying unknown tokens:
- Search for token contract address, creator history
- Check X/Twitter for sentiment
- Verify project exists and isn't a known scam
File Paths
| Path | Purpose |
|---|
~/.openclaw/skills/solana-defi/SKILL.md | This file |
~/.openclaw/skills/solana-defi/references/ | API reference docs |
~/scripts/setup-solana-wallet.py | Wallet generation/status |
~/scripts/solana-trade.py | Jupiter V6 trading |
~/scripts/solana-balance.py | Balance + price checks |
~/scripts/solana-positions.py | Portfolio + P&L |
~/scripts/solana-snipe.py | PumpPortal sniping |
~/.openclaw/.env | On-box wallet key, LEGACY mode only (NEVER display); absent on secure off-box wallets |
~/.openclaw/solana-defi/OFFBOX_CUSTODY | Present on secure off-box wallets; marks governed mode + the wallet address |
