outsmart

Solana trading CLI — buy, sell, and LP across 18 DEXes with 12 TX landing providers.

Documentation | npm | Discord

npm install -g outsmart@alpha
outsmart init
outsmart buy --dex raydium-cpmm --pool <POOL> --amount 0.1

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>

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>

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>

Pool Creation

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>

Utilities

info

Fetch token market data from DexScreener.

outsmart info --token <MINT>

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

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

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

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.

TX Landing Providers

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.

Environment Variables

Required

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

Optional

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

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.

Testing

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)

Mainnet tests require PRIVATE_KEY and MAINNET_ENDPOINT env vars. Tests use tiny amounts (0.02 SOL per buy). Run suites one at a time — tests share a wallet and cannot run in parallel.

Project Structure

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
│   └── 18 adapter files
├── dexscreener/           # Market data (DexScreener API)
├── 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

Discord

https://discord.gg/dc3Kh3Y3yJ

Contributing

Contributions welcome. Fork, branch, PR.

Disclaimer

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.

License

ISC

Name		Name	Last commit message	Last commit date
Latest commit History 499 Commits
.github/workflows		.github/workflows
docs		docs
src		src
tests		tests
.env.example		.env.example
.gitignore		.gitignore
.npmrc		.npmrc
.nvmrc		.nvmrc
CLAUDE.md		CLAUDE.md
LICENSE		LICENSE
OUTSMART_BUILD_PLAN.md		OUTSMART_BUILD_PLAN.md
README.md		README.md
jest.config.ts		jest.config.ts
package-lock.json		package-lock.json
package.json		package.json
tsconfig.build.json		tsconfig.build.json
tsconfig.json		tsconfig.json

License

outsmartchad/outsmart-cli

Folders and files

Latest commit

History

Repository files navigation

outsmart

Quick Start

1. Install

2. Configure

3. Trade

Commands

Trading

buy

sell

quote

find-pool

Wallet Management

wallet

wallet list

wallet add

wallet switch

wallet remove

Balances

balance

balance --token

Liquidity

add-liq

remove-liq

claim-fees

positions

Pool Creation

create-pump-coin

create-pool

create-damm-pool

create-damm-config-pool

Utilities

info

list-dex

config

init

Stablecoin Auto-Swap

Shared Swap Options

DEX Adapters

TX Landing Providers

Environment Variables

Required

Optional

Programmatic API

Testing

Project Structure

Discord

Contributing

Disclaimer

License

About

Topics

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 4

Packages 0

Uh oh!

Contributors 7

Languages

Packages