gem-hunter
Language: TypeScript
Agent-first CLI for trading on Solana — 18 DEX adapters, 12 SWQoS TX landing processors. Buy, sell, lp, snipe, create pool, launch coin, and stream real-time onchain events from your terminal.
The most complete Solana DEX CLI and toolkit for builders, traders, and AI agents
Documentation | npm | Discord
outsmart unifies every major Solana DEX protocol into a single CLI and Node.js library. 18 on-chain adapters (Raydium, Meteora, Orca, PumpFun, PumpSwap, and more), 2 swap aggregators (Jupiter Ultra, DFlow), 12 concurrent TX landing providers, real-time event streaming via Yellowstone gRPC or WebSocket, and an LP manager with auto-rebalancing and fee compounding — all from one package.
For builders — import { getDexAdapter, LpManager, EventStream } from "outsmart" and ship your own strategies. Typed event streams, per-DEX vault parsing, and a unified adapter interface mean you write the logic — outsmart handles the protocol plumbing across 18 DEXes.
For AI agents — use the CLI to interact with any major Solana DeFi protocol autonomously. Swap, manage LP positions, stream real-time events, and execute complex strategies — all from a single command.
# From npm (recommended) npm install -g outsmart@alpha # Or from source git clone https://github.com/outsmartchad/outsmart-cli.git cd outsmart-cli npm install --legacy-peer-deps npm run build
outsmart init
Prompts for your wallet key and RPC endpoint. Writes config to ~/.outsmart/config.env. You only need to do this once.
# Buy 0.1 SOL worth of a token (token auto-detected from pool) outsmart buy --dex raydium-cpmm --pool <POOL> --amount 0.1 # Sell 100% of held balance outsmart sell --dex raydium-cpmm --pool <POOL> --pct 100 # Swap aggregator (no pool needed, just token mint) outsmart buy --dex jupiter-ultra --token <MINT> --amount 0.1 # Check your balances outsmart balance
Example output:
buying on raydium-cpmm...
TX sent: 5zwjta... — confirming...
dex: raydium-cpmm
tx: 5zwjtaMj8LCzf4cY7Kt2QU2CAcAn3BAwvpVCbTjsR3qJ...
confirmed: true
in: 0.001 SOL
out: 2.001886 USELESS
pool: Q2sPHPdUWFMg7M7wwrQKLrn619cAucfRsmhVJffodSp
Buy tokens with SOL (or a quote token).
outsmart buy --dex <name> --pool <POOL> --amount <SOL> outsmart buy --dex raydium-cpmm --pool <POOL> --amount 0.1 outsmart buy --dex jupiter-ultra --token <MINT> --amount 0.5
| Flag | Description |
|---|---|
-d, --dex <name> |
DEX adapter name (required) |
-a, --amount <sol> |
SOL amount to spend (required) |
-p, --pool <address> |
Pool address (required for on-chain DEXes) |
-t, --token <mint> |
Token mint (auto-detected from pool; required for aggregators) |
Sell tokens for SOL. Specify what percentage of your balance to sell.
outsmart sell --dex <name> --pool <POOL> --pct <1-100> outsmart sell --dex raydium-cpmm --pool <POOL> --pct 100 outsmart sell --dex jupiter-ultra --token <MINT> --pct 50
| Flag | Description |
|---|---|
-d, --dex <name> |
DEX adapter name (required) |
--pct <percentage> |
Percentage of balance to sell, 1-100 (required) |
-p, --pool <address> |
Pool address (required for on-chain DEXes) |
-t, --token <mint> |
Token mint (auto-detected from pool; required for aggregators) |
Get the current on-chain price from a pool.
outsmart quote --dex raydium-cpmm --pool <POOL>
Discover a pool for a token pair on a specific DEX.
outsmart find-pool --dex raydium-cpmm --token <MINT>
Add liquidity to a pool.
outsmart add-liq --dex meteora-damm-v2 --pool <POOL> --amount-sol 1.0 outsmart add-liq --dex meteora-dlmm --pool <POOL> --amount-sol 0.5 --amount-token 1000
| Flag | Description |
|---|---|
-d, --dex <name> |
DEX adapter name (required) |
-p, --pool <address> |
Pool address (required) |
--amount-sol <amount> |
Amount of SOL to deposit |
--amount-token <amount> |
Amount of non-SOL token to deposit |
--strategy <type> |
Distribution: spot | curve | bid-ask (DLMM only, default: spot) |
--bins <count> |
Number of bins (DLMM only, default: 50, max: 70) |
Remove liquidity from a pool.
outsmart remove-liq --dex meteora-damm-v2 --pool <POOL> --pct 100
Claim accumulated swap fees from LP positions.
outsmart claim-fees --dex meteora-damm-v2 --pool <POOL>
List LP positions in a pool.
outsmart positions --dex meteora-damm-v2 --pool <POOL>
Start LP position management. See LP Manager for full details and programmatic API.
# Start managing a DLMM position (auto-rebalance + compound) outsmart lp-manage --dex meteora-dlmm --pool <POOL> --dry-run # Manage a specific position outsmart lp-manage --dex meteora-dlmm --pool <POOL> --position <POSITION> # DAMM v2 — compound-only (full-range, no rebalancing needed) outsmart lp-manage --dex meteora-damm-v2 --pool <POOL> # Custom thresholds outsmart lp-manage --dex meteora-dlmm --pool <POOL> \ --bins 30 --strategy curve --compound-interval 15 \ --il-threshold 5 --stop-loss 20
| Flag | Description | Default |
|---|---|---|
--dex <name> |
meteora-dlmm or meteora-damm-v2 (required) |
|
--pool <address> |
Pool address (required) | |
--position <address> |
Specific position (default: all in pool) | |
--bins <count> |
Bins for new position after rebalance (DLMM) | 50 |
--strategy <type> |
spot | curve | bid-ask (DLMM) |
spot |
--compound-interval <min> |
Compound fees every N minutes (0=off) | 30 |
--il-threshold <pct> |
Exit if IL exceeds N% | 10 |
--stop-loss <pct> |
Exit if price drops N% from entry (0=off) | 0 |
--dry-run |
Log actions without executing | false |
--ws |
Use WebSocket streaming (free) | auto |
Find the best LP pool for a token.
outsmart lp-find --token <MINT> outsmart lp-find --token <MINT> --dex meteora-dlmm --json
Create a new PumpFun token with a bonding curve.
outsmart create-pump-coin --name "My Token" --symbol "MYTKN" --uri "https://ipfs.io/ipfs/Qm..."
Create a new PumpSwap AMM pool with initial liquidity.
outsmart create-pool --base <MINT> --quote So111...112 --base-amount 1000000 --quote-amount 1
Create a Meteora DAMM v2 custom pool with full fee configuration.
outsmart create-damm-pool --base <MINT> --base-amount 1000000 --quote-amount 0.5 outsmart create-damm-pool --base <MINT> --base-amount 1000000 --quote-amount 0.5 \ --max-fee 5000 --min-fee 100 --fee-mode 1 --dynamic-fee
Create a Meteora DAMM v2 pool using an existing on-chain config.
outsmart create-damm-config-pool --base <MINT> --base-amount 1000000 --quote-amount 0.5 \ --config <CONFIG_ADDRESS>
See Event Streaming for full details, programmatic API, and supported DEXes.
# Stream all DEX swaps (auto-selects WebSocket if no gRPC endpoint configured) outsmart stream --preset all-dex-swaps # Force WebSocket mode (free, no gRPC endpoint needed) outsmart stream --preset all-dex-swaps --ws # Stream specific DEXes outsmart stream --preset pumpswap outsmart stream --preset raydium outsmart stream --preset meteora # Stream new pool creations outsmart stream --preset new-pools # Stream PumpFun bonding curve events outsmart stream --preset pumpfun-bonding
Available presets: all-dex-swaps, new-pools, pumpfun-bonding, pumpswap, raydium, meteora, other-dexes, wallet-trades
gRPC mode (default if configured): requires GRPC_URL and GRPC_XTOKEN env vars. Lowest latency (~200ms).
WebSocket mode (--ws flag or auto-selected): uses your standard MAINNET_ENDPOINT RPC. Free, higher latency (~1-3s).
Show the active wallet address and SOL balance.
outsmart wallet
label: default
address: tstXr3NbiMd6FFZF2qbPzxJqxCGXuSjpZVvdjeXiPv1
balance: 0.377743 SOL
Show all saved wallets with their balances. Active wallet marked with *.
outsmart wallet list
LABEL ADDRESS SOL
──────────────────────────────────────────────────────────────────────────
* default tstXr3NbiMd6FFZF2qbPzxJqxCGXuSjpZVvdjeXiPv1 0.3777
trading 7xKXt... 1.2340
* = active wallet
Add a new wallet. Prompts for the private key.
outsmart wallet add --label trading
Switch the active wallet. All subsequent commands use the new wallet.
outsmart wallet switch trading
Remove a saved wallet (with confirmation prompt).
outsmart wallet remove trading
Show SOL + stablecoin balances for the active wallet.
outsmart balance
Wallet: tstXr3NbiMd6FFZF2qbPzxJqxCGXuSjpZVvdjeXiPv1
SOL 0.377743
USDC 0.000001
USDT 0
USD1 0
Check the balance of a specific token.
outsmart balance --token <MINT>
List all registered DEX adapters and their capabilities.
outsmart list-dex outsmart list-dex --cap canSell
View or generate configuration.
outsmart config show # Show current env config (sensitive values masked) outsmart config env # Print a .env template
Interactive setup — prompts for wallet key and RPC endpoint.
outsmart init
Warning: Work in progress — currently devnet only. See PERCOLATOR.md for full CLI reference and programmatic API.
outsmart perp create-market --price 150 --lp 2 outsmart perp long -m <MARKET> -s 0.1 outsmart perp keeper --pool <POOL> --market <MARKET> --dex raydium-cpmm
All swap commands (buy, sell) accept these options:
| Option | Description | Default |
|---|---|---|
--slippage <bps> |
Slippage tolerance in basis points | 300 (3%) |
--priority <microLamports> |
Priority fee per compute unit | from env |
--tip <sol> |
MEV tip in SOL | 0.001 |
--cu <units> |
Compute unit limit | auto |
--jito |
Use Jito bundle submission | false |
--quote <mint> |
Quote token mint | WSOL |
Some pools use stablecoins (USDC, USDT, USD1) as the quote token instead of SOL. The CLI handles this automatically — no extra steps needed.
On buy: detects the stablecoin quote from the pool, swaps SOL → stablecoin, then buys the token.
On sell: sells the token for stablecoin, then swaps the proceeds back to SOL.
# LaunchLab pool quoted in USD1 — just specify SOL amount as usual outsmart buy --dex raydium-launchlab --pool <POOL> --amount 0.1 # → auto-swaps 0.1 SOL → USD1 → buys token outsmart sell --dex raydium-launchlab --pool <POOL> --pct 100 # → sells token → USD1 → auto-swaps USD1 → SOL
Uses Jupiter Ultra if JUPITER_API_KEY is set, otherwise falls back to on-chain DEX pools. Get a free key at portal.jup.ag (optional).
18 adapters covering every major Solana DEX protocol:
| Adapter | Protocol | Buy | Sell | Price | LP | Extra | Tested |
|---|---|---|---|---|---|---|---|
| raydium-amm-v4 | AMM v4 | ✅ | ✅ | ✅ | findpool | ✅ | |
| raydium-cpmm | CPMM | ✅ | ✅ | ✅ | findpool | ✅ | |
| raydium-clmm | CLMM | ✅ | ✅ | ✅ | findpool | ✅ | |
| raydium-launchlab | Launchlab | ✅ | ✅ | ✅ | findpool, auto-swap | ✅ | |
| meteora-damm-v1 | Dynamic AMM | ✅ | ✅ | ✅ | findpool | — | |
| meteora-damm-v2 | CpAmm | ✅ | ✅ | ✅ | full | findpool, create pool | ✅ |
| meteora-dlmm | DLMM | ✅ | ✅ | ✅ | full | ✅ | |
| meteora-dbc | DBC | ✅ | ✅ | ✅ | ✅ | ||
| pumpfun | Bonding Curve | ✅ | ✅ | ✅ | create coin | ✅ | |
| pumpfun-amm | PumpSwap AMM | ✅ | ✅ | ✅ | create pool | ✅ | |
| orca | Whirlpool | ✅ | ✅ | ✅ | ✅ | ||
| byreal-clmm | CLMM | ✅ | ✅ | ✅ | auto-swap | ✅ | |
| pancakeswap-clmm | CLMM | ✅ | ✅ | ✅ | ✅ | ||
| fusion-amm | Fusion | ✅ | ✅ | ✅ | ✅ | ||
| futarchy-amm | Futarchy | ✅ | ✅ | ✅ | auto-swap | ✅ | |
| futarchy-launchpad | Launchpad | fund/claim | — | ||||
| jupiter-ultra | Ultra API | ✅ | ✅ | aggregator | ✅ | ||
| dflow | Intent API | ✅ | ✅ | aggregator | ✅ |
All ✅ adapters confirmed on Solana mainnet with real transactions.
Use outsmart as a library in your own bots:
import { getDexAdapter, listDexAdapters } from "outsmart"; // Import only the adapters you need import "outsmart/dist/dex/raydium-cpmm"; import "outsmart/dist/dex/jupiter-ultra"; const cpmm = getDexAdapter("raydium-cpmm"); // Buy const result = await cpmm.buy({ tokenMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", amountSol: 0.1, opts: { slippageBps: 300, tipSol: 0.001 }, }); console.log("TX:", result.txSignature); console.log("Received:", result.amountOut); // Sell const sellResult = await cpmm.sell({ tokenMint: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v", percentage: 100, opts: { slippageBps: 300 }, }); // Get price const price = await cpmm.getPrice!("POOL_ADDRESS"); console.log("Price:", price.price); // List adapters const adapters = listDexAdapters();
For AI agent integration (MCP server, OpenClaw workflows), see outsmart-agent.
Real-time DEX event streaming with two backends — gRPC (Yellowstone/Geyser, lowest latency) and WebSocket (free, uses standard RPC). Both produce the same typed events from 18+ DEX programs.
// gRPC mode (fastest, requires Yellowstone endpoint) import { EventStream } from "outsmart"; const stream = new EventStream({ grpcUrl: process.env.GRPC_URL, grpcXToken: process.env.GRPC_XTOKEN, }); // WebSocket mode (free, uses standard RPC) import { WsEventStream } from "outsmart"; const stream = new WsEventStream({ rpcUrl: process.env.MAINNET_ENDPOINT, // any Solana RPC }); // Both emit the same events with the same API: stream.on("Swap", (event) => { console.log(`${event.dex} ${event.direction} ${event.mint}`); console.log(` in: ${event.amountIn}, out: ${event.amountOut}`); console.log(` pool: ${event.pool}, trader: ${event.trader}`); }); stream.on("NewPool", (event) => { console.log(`New pool on ${event.dex}: ${event.pool}`); console.log(` ${event.tokenA} / ${event.tokenB}`); }); stream.on("BondingComplete", (event) => { console.log(`Bonding complete: ${event.mint} → ${event.migrationPool}`); }); // Large swap alerts (configurable threshold, default 10 SOL) stream.on("LargeSwap", (event) => { console.log(`Whale alert: ${event.swap.amountIn} on ${event.swap.dex}`); }); // Catch-all listener stream.on("*", (event) => { /* any event */ }); await stream.start("all-dex-swaps"); // Custom subscriptions (gRPC only) import { subscribePoolActivity } from "outsmart"; await stream.startCustom(subscribePoolActivity(["POOL_ADDRESS"])); // Stop await stream.stop();
| Event | Fields |
|---|---|
Swap |
dex, pool, trader, direction, mint, amountIn, amountOut, priceAfter, reserveBase, reserveQuote, isAggregated |
NewPool |
dex, pool, tokenA, tokenB, initialReserveA, initialReserveB, creator |
BondingComplete |
mint, bondingCurve, migrationPool |
LargeSwap |
swap (full SwapEvent), estimatedUsdValue |
All swap events use per-DEX vault account layouts with pre/post token balance diffing for accurate amounts:
Automated liquidity position management for Meteora DLMM (concentrated, bin-based) and DAMM v2 (full-range). Monitors positions, auto-rebalances when out of range, compounds fees, and exits on risk thresholds.
import { LpManager, selectBestPool } from "outsmart"; import "outsmart/dist/dex/meteora-dlmm"; // Find best pool for a token const pools = await selectBestPool("DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263"); console.log("Top pool:", pools[0].pair, "APR:", pools[0].estimatedApr + "%"); // Start management const manager = new LpManager({ poolAddress: "POOL_ADDRESS", dex: "meteora-dlmm", rebalanceBins: 50, compoundIntervalMin: 30, ilThresholdPct: 10, dryRun: false, }); manager.on("event", (event) => { console.log(`[${event.type}] ${event.message}`); }); await manager.start(); // Check stats const stats = manager.getStats(); console.log("Rebalances:", stats.totalRebalances, "Compounds:", stats.totalCompounds); // Stop await manager.stop();
DLMM strategy — Monitors bin positions for out-of-range. When price exits the active bins, removes liquidity, claims fees, and opens a new position centered on current price. Cooldown prevents thrashing.
DAMM v2 strategy — Full-range positions never go out of range, so no rebalancing needed. Periodically claims accumulated fees and re-deposits them to compound returns.
Risk management — Estimates impermanent loss from entry price; exits position if IL exceeds threshold. Optional stop-loss exits on price drops.
Pool selector — Scores Meteora pools by volume/TVL ratio, estimated fee APR, TVL sweet spot ($10k-$1M), and pool age. Returns ranked results.
12 providers with concurrent, race, random, and sequential submission strategies:
| Provider | Env Var |
|---|---|
| Jito | JITO_API_KEY |
| bloXroute | BLOXROUTE_AUTH_HEADER |
| Helius Sender | HELIUS_API_KEY |
| Nozomi | NOZOMI_API_KEY |
| Blockrazor | BLOCKRAZOR_API_KEY |
| NextBlock | NEXTBLOCK_API_KEY |
| 0slot | ZERO_SLOT_API_KEY |
| Soyas | SOYAS_API_KEY |
| Astralane | ASTRALANE_API_KEY |
| Stellium | STELLIUM_API_KEY |
| Flashblock | FLASHBLOCK_API_KEY |
| Node1 | NODE1_API_KEY |
Set any provider's API key and it's automatically enabled. The orchestrator sends your transaction through all enabled providers simultaneously for the fastest possible landing.
| Variable | Description |
|---|---|
PRIVATE_KEY |
Base58-encoded wallet private key |
MAINNET_ENDPOINT |
Solana mainnet RPC endpoint |
| Variable | Description | Default |
|---|---|---|
TX_LANDING_MODE |
concurrent | race | random | sequential |
concurrent |
DEFAULT_TIP_SOL |
MEV tip in SOL | 0.001 |
DEFAULT_SLIPPAGE_BPS |
Slippage in basis points | 300 |
DEFAULT_PRIORITY_FEE |
Priority fee in microLamports per CU | 4000 |
DEVNET_ENDPOINT |
Solana devnet RPC endpoint (for Percolator) | not set |
JUPITER_API_KEY |
Jupiter Ultra API key (portal.jup.ag) | works without key |
DFLOW_API_KEY |
DFlow intent API key (pond.dflow.net) | required for dflow |
GRPC_URL |
Yellowstone gRPC endpoint (for gRPC keeper) | not set |
GRPC_XTOKEN |
Yellowstone gRPC auth token | not set |
npm run test:unit # 43 CI-safe unit tests (no RPC/SOL needed) npm run test:registry # Registry smoke test npm run test:raydium # Raydium adapters (mainnet) npm run test:meteora # Meteora adapters (mainnet) npm run test:pumpfun # PumpFun + PumpSwap (mainnet) npm run test:orca # Orca Whirlpool (mainnet) npm run test:clmm # Byreal + PancakeSwap CLMM (mainnet) npm run test:fusion # Fusion + Futarchy AMM (mainnet) npm run test:api # Jupiter Ultra + DFlow (mainnet) npm run test:percolator # Percolator perps (devnet) — see PERCOLATOR.md
Mainnet tests require PRIVATE_KEY and MAINNET_ENDPOINT env vars. Tests use tiny amounts (0.002 SOL per buy). Run suites one at a time — tests share a wallet and cannot run in parallel.
src/
├── cli.ts # CLI entry point (Commander.js)
├── index.ts # Library entry point
├── dex/
│ ├── types.ts # IDexAdapter interface
│ ├── index.ts # DexRegistry singleton
│ ├── shared/clmm-base.ts
│ ├── percolator/
│ │ ├── adapter.ts # PercolatorAdapter (20 methods)
│ │ ├── ws-keeper.ts # WebSocket oracle keeper (8 DEX types)
│ │ ├── grpc-keeper.ts # gRPC oracle keeper (Yellowstone/Geyser)
│ │ └── core/ # Vendored @percolator/core SDK
│ └── 18 adapter files
├── lp-manager/
│ ├── index.ts # LpManager orchestrator (action loop, event emission)
│ ├── types.ts # Config, strategy, position state types
│ ├── monitor.ts # Position monitoring (poll + stream hybrid)
│ ├── risk.ts # IL threshold, stop-loss exit
│ ├── pool-selector.ts # Pool scoring by volume/TVL/APR
│ └── strategies/
│ ├── dlmm-strategy.ts # DLMM rebalance + compound
│ └── damm-strategy.ts # DAMM v2 compound
├── streaming/
│ ├── event-stream.ts # EventStream class (auto-reconnect, ping keepalive)
│ ├── ws-event-stream.ts # WsEventStream class (free WebSocket alternative)
│ ├── tx-formatter.ts # Raw gRPC protobuf → FormattedTransaction
│ ├── tx-parser.ts # Per-DEX swap/pool/bonding parsers
│ ├── programs.ts # 18 DEX program IDs
│ ├── subscriptions.ts # 11 subscription preset builders
│ ├── discriminators.ts # Instruction discriminator constants
│ └── types.ts # Typed event interfaces
├── helpers/
│ ├── config.ts # Wallet, connection, env loading
│ ├── wallets.ts # Multi-wallet management
│ └── logger.ts # Structured logger
└── transactions/
├── send-rpc.ts # sendAndConfirmVtx (standard swaps)
└── landing/
├── orchestrator.ts # Multi-provider concurrent submission
├── nonce-manager.ts # Durable nonce for dedup
├── tip-accounts.ts # Tip account registry
└── providers/ # 12 provider implementations
Contributions welcome. Fork, branch, PR.
This software is provided "as is", without warranty of any kind. Use at your own risk. The authors take no responsibility for any financial loss. Users are responsible for ensuring compliance with applicable laws.
Never share your private keys. Wallet keys are stored in ~/.outsmart/ with owner-only permissions.
ISC