Quick Start

From zero to your first trade in under a minute.

1. Open the bot — Go to @Viper_Sol_Bot on Telegram and tap Start.
2. Create a wallet — The bot automatically generates a new encrypted Solana wallet. You can also create Base, BSC, and Ethereum wallets from the wallet menu.
3. Fund your wallet — Send SOL (Solana), ETH (Base/Ethereum), or BNB (BSC) to your wallet address from any exchange or wallet.
4. Buy a token — Paste any Solana, Base, BSC, or Ethereum token contract address (CA) into the chat. Viper auto-detects the chain, shows token info and quick-buy buttons. Tap a preset amount or enter a custom one.
5. Track your position — Use /positions to see your holdings, current value, and unrealized P&L.
6. Sell — From your positions, tap a token and choose a sell percentage (25%, 100%, or custom).

Home Screen

What you see when you open the bot.

The home screen (/start) shows your Solana, Base, BSC, and Ethereum wallet info at a glance:

Menu Buttons

The home screen includes quick-access buttons for all major features: Buy, Sell, Positions, Orders, Copy Trade, Call Channels, Swap USDC, Wallet, Settings, History, and more.

The /balance Command

Send /balance to see SOL and token balances across all your wallets on every chain — Solana, Base, BSC, and Ethereum — in a single message.

Buying Tokens

Multiple ways to buy any Solana, Base, BSC, or Ethereum token.

Paste a Contract Address

The fastest way to buy: paste any Solana, Base, BSC, or Ethereum token contract address (CA) directly into the chat. Viper auto-detects the chain and shows a token info card with:

• Token name, symbol, and price
• Market cap and liquidity
• Quick-buy buttons with your preset amounts (SOL, ETH, or BNB)

Tap a preset button to execute instantly, or tap Custom to enter a specific amount.

Using the /buy Command

For direct execution: /buy <token_mint> <amount>

The chain is auto-detected from the contract address. Use SOL amounts for Solana tokens, ETH amounts for Base tokens, and BNB amounts for BSC tokens.

How It Works

1. Viper deducts the platform fee from your SOL, ETH, or BNB amount.
2. The remaining amount is swapped for the token — via Jupiter V2 (Solana), 0x Protocol (Base), 0x Protocol with PancakeSwap V2/V3 (BSC), or 0x Protocol with Uniswap V2/V3 + SushiSwap (Ethereum).
3. The trade is recorded to your history for P&L tracking.
4. You get a confirmation message with the amount received, price, and a Solscan (Solana), Basescan (Base), BscScan (BSC), or Etherscan (Ethereum) link.

Selling Tokens

Sell all or part of any position on Solana, Base, BSC, or Ethereum.

From Positions

The easiest way to sell: go to /positions, select the token, and tap a sell percentage button (25%, 100%, or custom).

Using the /sell Command

/sell <token_mint> <percentage>

Example: /sell EPjFWdd5... 100 (sells 100% of your holdings).

Auto-Cancel Limit Orders

When you sell a token, Viper automatically checks if you have active limit sell orders for that same token. If any orders exceed your remaining balance after the sell, they are automatically cancelled. The sell confirmation shows how many orders were cancelled.

Positions

Track your holdings and unrealized P&L.

Use /positions to see all tokens you hold across Solana, Base, BSC, and Ethereum in one combined view. Each position shows:

• Token name, symbol, and amount
• Current USD value
• Average entry price and cost basis
• Unrealized P&L in native units (SOL, ETH, or BNB) and percentage

Actions Per Token

For each position, you can:

• Buy more — Quick-buy with preset amounts
• Sell — Choose a percentage (25%, 100%, custom)
• Limit Order — Create a limit buy or sell directly from the position
• Hide — Remove dust or spam tokens from your positions view (tokens remain on-chain)

Sorting

Toggle between sorting by USD value (highest first) or alphabetically by symbol.

Pending Limit Orders

If you have active limit sell orders, Viper shows them in your positions with a note so you know your full holdings including tokens reserved for pending orders.

Token Lookup

Get instant info on any Solana, Base, BSC, or Ethereum token.

Paste any Solana, Base, BSC, or Ethereum contract address into the chat and Viper will auto-detect the chain and display a token info card with:

• Token name, symbol, and current price
• Market cap and fully diluted value
• 24h price change
• Liquidity (if available)
• Quick-buy buttons with your preset amounts

You can also use /price <token_mint> for a price-only lookup without buy buttons.

Trade History

Lifetime P&L and closed trade log.

Use /history to see your realized trading performance across all chains. The history view shows:

• Lifetime P&L — Total realized profit/loss broken out per chain (SOL, ETH, and BNB)
• Win/Loss stats — Number of winning and losing trades, with win rate percentage
• Last 10 closed trades — Combined from all chains, sorted by date, with token, cost, proceeds, and P&L for each

When Is a Position "Closed"?

A position is considered closed when you sell all (or more than 95%) of your peak holdings for that token. This triggers a realized P&L calculation based on your total cost basis vs total proceeds.

Wallet Toggle

By default, history shows only trades from your active wallet. Tap Show All Wallets to see combined history across all your wallets.

Swap USDC

Convert between SOL/ETH/BNB and USDC directly — with zero platform fees.

Use the Swap USDC button on the main menu to swap between your native token (SOL, ETH, or BNB) and USDC. This is useful for parking profits in a stablecoin or converting USDC back to trade with.

How It Works

1. Select a chain — Choose Solana, Base, BSC, or Ethereum.
2. See your balances — Viper shows your current SOL/ETH/BNB and USDC balances.
3. Pick a direction — SOL → USDC, USDC → SOL (or ETH variants on Base, BNB variants on BSC).
4. Choose an amount — Use a percentage button (25%, 50%, 75%, 100%) or enter a custom amount.
5. Confirm — Tap Swap and the trade executes instantly.

Routing

Gas Reserve

When swapping 100% of a native token (SOL, ETH, or BNB), Viper automatically reserves a small amount for gas fees:

• Solana: 0.005 SOL reserved
• Base: 0.0005 ETH reserved
• BSC: 0.001 BNB reserved
• Ethereum: 0.001 ETH reserved

When swapping USDC, the full amount is used since gas is paid in the native token.

USDC Balance on Home Screen

Your USDC balance is displayed on the home screen alongside your SOL/ETH/BNB balance whenever it's at least $0.01.

Limit Orders

Automated price-triggered buy and sell orders.

Limit orders let you set a price target and have Viper execute the trade automatically when that price is reached — 24/7, even when you're offline.

Creating an Order

Use /limit or tap Orders from the main menu. Then:

1. Select Buy or Sell.
2. Enter the token contract address.
3. Set the amount (SOL for Solana buys, ETH for Base/Ethereum buys, BNB for BSC buys, tokens or percentage for sells).
4. Set the trigger price in USD.
5. Choose an expiry (24h, 72h, 1 week, or 30 days).
6. Confirm the order.

How Orders Execute

Viper continuously polls prices on all chains. When your trigger price is hit, the swap executes automatically:

• Solana — Prices polled via Jupiter, execution via Jupiter Swap V2.
• Base — Prices polled via Uniswap V3/V4 Quoter, execution via 0x Protocol.
• BSC — Prices polled via PancakeSwap V2/V3, execution via 0x Protocol.
• Ethereum — Prices polled via Uniswap V2/V3 + SushiSwap, execution via 0x Protocol.

Funds stay in your wallet until the order triggers — no escrow or lockup.

Editing Orders

You can edit an active order's trigger price, amount, or expiry without cancelling and recreating it. Go to /limit and tap the order to see edit options.

Stop Loss

When creating a sell limit order, you can tap the Stop Loss button to set up downside protection — choose Fixed or Trailing type and configure how much to sell (50%, 100%, or custom %). See Stop Loss for details.

Cancelling Orders

Cancel individual orders from the order list, or cancel all orders at once.

Stop Loss

Protect your positions with automatic downside selling.

Stop Loss creates a limit sell order that triggers automatically when a token's price drops to your floor — either a fixed price target or a trailing percentage from the highest price seen.

Stop Loss Types

Setting a Stop Loss

From /positions, select a token and tap 📉 Limit Order, then:

1. Switch to Sell direction.
2. Tap the Stop Loss button. Choose Fixed or Trailing.
3. Fixed: Set a trigger price below the current price — this is your floor.
   Trailing: Set the trailing percentage (e.g., 20% = sell when price drops 20% from its high).
4. Choose how much to sell: 50%, 100%, or a custom percentage.
5. Choose an expiry period (24h, 72h, 1 week, or 30 days).
6. Tap CREATE ORDER.

How Fixed Stop Loss Works

• When the token's price drops to or below your stop loss price, Viper executes the sell automatically.
• If the current price is already at or below your stop loss price, you'll get a warning. Enter the same price again to confirm.
• Stop loss prices must be below the current price — entering a price above current is rejected.

How Trailing Stop Loss Works

• Viper tracks the highest price seen since the order was created (high water mark).
• The trigger price is always high water mark × (1 − trailing %). As the price rises, the trigger rises with it — but it never moves down.
• When the price drops to the trigger level, Viper executes the sell.

Take Profit

Lock in gains on every trade.

Take Profit (TP) is available on every buy path. Copy trades and call channel auto-buys create TP orders automatically. For manual buys, set a limit sell order from the position card. Viper monitors prices 24/7 and sells when your target is hit.

How It Works

1. Auto buys (copy trades & call channels): After the buy executes, Viper waits 2 seconds for on-chain state to settle, then creates a limit sell order at your configured TP target.
2. Manual buys: Open the position card and tap Limit Sell to set a take-profit price target.
3. When the token reaches the target, the sell executes automatically.

Configuration

"Initials" Mode

Instead of selling a fixed percentage, Initials mode sells just enough tokens to recover your initial SOL investment. The rest rides as pure profit.

Copy Trading — Setup

Mirror any wallet's trades automatically.

Copy trading monitors a target wallet in real-time via WebSocket. When the target buys or sells a token, Viper automatically mirrors the trade for you. Copy trading works on Solana, Base, BSC, and Ethereum.

Adding a Copy Trade

Use /copy or tap Copy Trade from the main menu, then Add.

1. Choose the chain: Solana, Base, BSC, or Ethereum.
2. Enter the target wallet address you want to copy.
3. Choose a sizing mode: Percentage (mirror a % of their trade size) or Fixed (use a fixed SOL/ETH amount per trade).
4. For percentage mode, set min and max limits to control your exposure.
5. Optionally add a label (e.g., "Smart Money Wallet").

Sizing Modes

Copy Trading — Managing

Pause, edit, or remove copy trades.

From the /copy menu, you can manage all your active copy trades:

• Pause/Resume — Temporarily stop copying without removing the configuration.
• Toggle sell copying — Choose whether to also mirror sell transactions, or only copy buys.
• Edit sizing — Change percentage, fixed amount, or min/max limits.
• Edit label — Rename for organization.
• Stop Loss settings — Enable automatic stop loss on every copied buy. Choose Fixed (trigger at a % below buy price) or Trailing (trigger when price drops a % from its high). Set the percentage and how much to sell (50%, 100%, or custom).
• Remove — Delete the copy trade entirely.

Call Channels — Setup

Auto-buy tokens when they're called in Telegram channels.

Call Channels let you subscribe to Telegram alpha channels. When a new contract address is posted (Solana, Base, BSC, or Ethereum), Viper auto-buys with your configured amount.

Adding a Channel

Use /calls or tap Call Channels from the main menu, then Add Channel.

1. Choose which chain(s) to auto-buy on — Solana, Base, BSC, Ethereum, or any combination (auto-selected if you only have one wallet).
2. Enter the channel's @handle (e.g., @alpha_calls).
3. Set the buy amount per call (SOL for Solana, ETH for Base/Ethereum, BNB for BSC).
4. Optionally enable Take Profit (see Take Profit).
5. Optionally enable Stop Loss — choose Fixed (% below buy price) or Trailing (% from high), set the percentage, and how much to sell when triggered.

Deduplication

Viper prevents duplicate buys with smart dedup:

History Seeding

When you add a channel, Viper scans the past 180 days of messages (configurable) and records all CAs it finds. This prevents the bot from buying old calls when you first subscribe.

Call Channels — Take Profit

Automatically set sell targets for call channel buys.

Each call channel subscription can have its own Take Profit (TP) configuration. When enabled, Viper automatically creates a limit sell order after every auto-buy.

Enabling TP

Enable during channel setup or go to /calls → select a channel → TP toggle.

Settings

• PNL Target — Presets: 50%, 100%, 200%, 300%, 500%, or enter a custom percentage.
• Sell Amount — How much to sell: 25%, 50%, 75%, 100%, or Initials (recover initial investment only).

See Take Profit for full details on how TP orders work.

Call Channels — Managing

Pause, delete, or edit channel subscriptions.

Pause vs Delete

Cooldown

There is a short cooldown between auto-buys per user (default: 5 seconds) to prevent rapid-fire execution if multiple CAs are posted at once.

Create & Import Wallets

Generate new wallets or import existing ones.

Create a New Wallet

Use /newwallet or tap New Wallet from the wallet menu. Choose Solana or Base — a new keypair is generated and encrypted immediately. The public address is displayed for funding. When creating or importing a Base wallet, BSC and Ethereum wallets are automatically created as companions using the same private key.

Import an Existing Wallet

Use /import in a direct message to the bot (not in a group).

• Solana — Paste your base-58 encoded private key.
• Base — Paste your hex private key. BSC and Ethereum wallets are automatically created using the same key.
• The message containing your private key is deleted immediately for security.
• The key is encrypted with your unique encryption key (derived from your Telegram ID + the bot's master secret).
• The imported wallet becomes your active wallet automatically.

Switch & Manage Wallets

Manage multiple wallets from one account.

Use /wallet to open the wallet manager. Wallets are organized by chain. You can:

• View all wallets — See each wallet's public key and balance (SOL, ETH, or BNB).
• Switch active wallet — Tap any wallet to make it active for that chain. Each chain has its own active wallet.
• Rename wallets — Add labels for easy identification.

The /listwallets Command

Send /listwallets to see all your wallets at a glance — each wallet's public address and native balance (SOL, ETH, or BNB) with the active wallet highlighted.

Withdraw

Send SOL, ETH, BNB, or tokens to any external address.

From the wallet menu, tap Withdraw to transfer funds out of your bot wallet.

1. Select what to withdraw: SOL/ETH/BNB or a specific token.
2. Choose an amount: 25%, 50%, 75%, 100%, or enter a custom amount.
3. Enter the destination wallet address.
4. Confirm the transaction.

After confirmation, you'll receive a Solscan (Solana), Basescan (Base), BscScan (BSC), or Etherscan (Ethereum) link to track the transfer.

Export Private Key

Retrieve your wallet's private key securely.

Use /export in a direct message to the bot.

• If you have a PIN set, you'll need to enter it first.
• The private key is displayed in a message that auto-deletes after 30 seconds.
• This exports the key for your currently active wallet.

Claim SOL

Reclaim rent from empty token accounts.

Every token you hold on Solana requires a token account, which costs ~0.002 SOL in rent. When you sell 100% of a token, the account remains open with a zero balance.

Use the Claim SOL button in the wallet menu (or /claim) to close all empty token accounts and reclaim that rent.

To close a single specific token account, use /burn <token_mint>.

Slippage

Control price impact tolerance on swaps.

Slippage is the maximum acceptable price difference between the quoted price and the execution price. Use /settings to configure.

You can set separate slippage values for buys and sells. This is useful because sell transactions for low-liquidity tokens often need higher slippage.

Priority Fee

Control transaction priority on the Solana network.

Higher priority fees increase the likelihood of your transaction being included in the next block. Configure via /settings.

Buy & Sell Presets

Customize your quick-action buttons.

Buy Presets

When you look up a token (by pasting a CA), you see 4 quick-buy buttons with preset amounts. Each chain has separate presets:

Solana: 0.1 SOL · 0.5 SOL · 1.0 SOL · 2.0 SOL

Base: 0.001 ETH · 0.005 ETH · 0.01 ETH · 0.05 ETH

BSC: 0.01 BNB · 0.05 BNB · 0.1 BNB · 0.5 BNB

Ethereum: 0.001 ETH · 0.005 ETH · 0.01 ETH · 0.05 ETH

Customize these in /settings → Buy Options. Changes apply immediately to all buy cards.

Sell Presets

Your positions show 2 quick-sell percentage buttons. The defaults are:

25% · 100%

Customize per chain in /settings → Sell Options (same as buy presets).

PIN Security

Protect sensitive operations with a PIN.

Set a 4–6 digit PIN with /setpin. Once set, you'll need to enter it before:

• Exporting your private key (/export)
• Withdrawing funds from your wallet

Your PIN is stored as a bcrypt hash (12 rounds) — it cannot be reversed. The messages you type your PIN into are automatically deleted for security.

You can change your PIN at any time by running /setpin again.

MEV Protection

Protect your trades from sandwich attacks and front-running.

MEV (Maximal Extractable Value) protection shields your transactions from being exploited by bots that detect pending swaps and manipulate prices around them — commonly known as sandwich attacks and front-running.

Per-Chain Breakdown

Solana

Solana transactions are protected via two mechanisms:

• Jito private relay — Your transaction is routed through Jito's private mempool, keeping it invisible to sandwich bots until it reaches validators.
• Jupiter Beam — Jupiter's private transaction submission endpoint, which keeps your swap invisible to mempool scanners until it lands on-chain.

MEV protection on Solana is on by default and can be toggled via /settings → MEV Protection.

Ethereum

Ethereum transactions route through Flashbots Protect, a private RPC that sends your transaction directly to block builders — bypassing the public mempool entirely. MEV protection is on by default and can be toggled via /settings → Ethereum → MEV Protection.

Base / BSC

MEV protection is not currently available on Base or BSC. Transactions are submitted via standard RPCs. While sandwich attacks are less common on these chains due to shorter block times, they are not fully protected.

How to Toggle

Open /settings, select the chain (Solana or Ethereum), and tap MEV Protection to toggle between on and off. When off, transactions use standard RPCs instead of Jito's private relay / Jupiter Beam (Solana) or Flashbots Protect (Ethereum).

Referral Program

Trade cheaper — together.

Share your referral link and both you and your friend get a permanent fee discount.

How It Works

1. Get your code — Open /referral to see your unique referral link.
2. Share it — Send the link to a friend. When they start the bot via your link, they're linked to you.
3. Both save — Once linked, both users trade at 0.2% instead of the standard 0.25% — no time limit.

Entering a Code

If someone shared their referral link with you, just click it to open the bot. The referral is applied automatically on your first /start.

Fee Structure

Simple, transparent pricing.

Where Fees Apply

The platform fee is collected on every trade, regardless of how it was triggered:

• Manual buys and sells
• Limit order executions
• Copy trade executions
• Call channel auto-buys
• Trigger order fills

How Fees Are Collected

• Buys: The fee is deducted from your SOL (Solana), ETH (Base), or BNB (BSC) before the swap. If you buy with 1 SOL at 0.25%, the swap uses 0.9975 SOL.
• Sells: The fee is deducted from the SOL, ETH, or BNB you receive after the swap.

The same fee rate applies on Solana, Base, BSC, and Ethereum. There are no hidden fees, subscription costs, or withdrawal charges.

Fee-Free: USDC Swaps

USDC swaps are completely free. No platform fee is charged when swapping between SOL/ETH/BNB and USDC on any chain. See Swap USDC for details.