outsmart

The most complete Solana DEX CLI and toolkit for builders, traders, and AI agents

Documentation | npm | Discord

Table of Contents

• About
• Quick Start
• Commands

• Shared Swap Options
• Stablecoin Auto-Swap
• DEX Adapters
• Programmatic API
• Event Streaming (Programmatic)
• LP Manager
• TX Landing Providers
• Environment Variables
• Testing
• Project Structure
• Contributing
• Disclaimer
• License

About

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.

Quick Start

1. Install

# 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

2. Configure

outsmart init

Prompts for your wallet key and RPC endpoint. Writes config to ~/.outsmart/config.env. You only need to do this once.

3. Trade

# 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

Commands

Trading

buy

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

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

quote

Get the current on-chain price from a pool.

outsmart quote --dex raydium-cpmm --pool <POOL>

find-pool

Discover a pool for a token pair on a specific DEX.

outsmart find-pool --dex raydium-cpmm --token <MINT>

Liquidity

add-liq

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

Remove liquidity from a pool.

outsmart remove-liq --dex meteora-damm-v2 --pool <POOL> --pct 100

claim-fees

Claim accumulated swap fees from LP positions.

outsmart claim-fees --dex meteora-damm-v2 --pool <POOL>

positions

List LP positions in a pool.

outsmart positions --dex meteora-damm-v2 --pool <POOL>

lp-manage

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 |

lp-find

Find the best LP pool for a token.

outsmart lp-find --token <MINT>
outsmart lp-find --token <MINT> --dex meteora-dlmm --json

create-pump-coin

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

Create a new PumpSwap AMM pool with initial liquidity.

outsmart create-pool --base <MINT> --quote So111...112 --base-amount 1000000 --quote-amount 1

create-damm-pool

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-damm-config-pool

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>

Event Streaming

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 GRPCURL and GRPCXTOKEN env vars. Lowest latency (~200ms).

WebSocket mode (--ws flag or auto-selected): uses your standard MAINNET_ENDPOINT RPC. Free, higher latency (~1-3s).

Wallet Management

wallet

Show the active wallet address and SOL balance.

outsmart wallet

label:   default
  address: tstXr3NbiMd6FFZF2qbPzxJqxCGXuSjpZVvdjeXiPv1
  balance: 0.377743 SOL

wallet list

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

wallet add

Add a new wallet. Prompts for the private key.

outsmart wallet add --label trading

wallet switch

Switch the active wallet. All subsequent commands use the new wallet.

outsmart wallet switch trading

wallet remove

Remove a saved wallet (with confirmation prompt).

outsmart wallet remove trading

Balances

balance

Show SOL + stablecoin balances for the active wallet.

outsmart balance

Wallet: tstXr3NbiMd6FFZF2qbPzxJqxCGXuSjpZVvdjeXiPv1
SOL        0.377743   USDC       0.000001   USDT       0   USD1       0

balance --token

Check the balance of a specific token.

outsmart balance --token <MINT>

Utilities

list-dex

List all registered DEX adapters and their capabilities.

outsmart list-dex
outsmart list-dex --cap canSell

config

View or generate configuration.

outsmart config show        # Show current env config (sensitive values masked)
outsmart config env         # Print a .env template

init

Interactive setup — prompts for wallet key and RPC endpoint.

outsmart init

Perpetual Futures (Percolator)

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

Shared Swap Options

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 |

Stablecoin Auto-Swap

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 JUPITERAPIKEY is set, otherwise falls back to on-chain DEX pools. Get a free key at portal.jup.ag (optional).

DEX Adapters

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.

Programmatic API

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.

Event Streaming

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.

Programmatic API

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

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

Supported DEXes

All swap events use per-DEX vault account layouts with pre/post token balance diffing for accurate amounts:

• PumpSwap — buy/sell/create pool (sequential discriminator pairing)
• PumpFun — buy/sell/create/bonding complete (BuyExactSolIn, CreateV2 discriminators)
• Raydium — CLMM, CPMM, AMM V4, LaunchLab
• Meteora — DAMM V2, DLMM, DBC, DAMM V1
• Orca — Whirlpool swap v1 & v2
• PancakeSwap — CLMM
• Byreal — CLMM
• Fusion AMM
• Futarchy AMM

LP Manager

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.

Programmatic API

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();

How It Works

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.

TX Landing Providers

12 providers with concurrent, race, random, and sequential submission strategies:

| Provider | Env Var | |----------|---------| | Jito | JITOAPIKEY | | bloXroute | BLOXROUTEAUTHHEADER | | Helius Sender | HELIUSAPIKEY | | Nozomi | NOZOMIAPIKEY | | Blockrazor | BLOCKRAZORAPIKEY | | NextBlock | NEXTBLOCKAPIKEY | | 0slot | ZEROSLOTAPI_KEY | | Soyas | SOYASAPIKEY | | Astralane | ASTRALANEAPIKEY | | Stellium | STELLIUMAPIKEY | | Flashblock | FLASHBLOCKAPIKEY | | Node1 | NODE1APIKEY |

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.

Environment Variables

Required

| Variable | Description | |----------|-------------| | PRIVATE_KEY | Base58-encoded wallet private key | | MAINNET_ENDPOINT | Solana mainnet RPC endpoint |

Optional

| Variable | Description | Default | |----------|-------------|---------| | TXLANDINGMODE | concurrent \| race \| random \| sequential | concurrent | | DEFAULTTIPSOL | MEV tip in SOL | 0.001 | | DEFAULTSLIPPAGEBPS | Slippage in basis points | 300 | | DEFAULTPRIORITYFEE | Priority fee in microLamports per CU | 4000 | | DEVNETENDPOINT | Solana devnet RPC endpoint (for Percolator) | not set | | JUPITERAPIKEY | Jupiter Ultra API key (portal.jup.ag) | works without key | | DFLOWAPIKEY | 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

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