Viper Documentation

Welcome to Viper

The fastest multi-chain trading bot, built entirely on Telegram.

Viper lets you trade any Solana, Base, BSC, Ethereum, Hyperliquid, or Robinhood token directly from Telegram. No browser extensions, no separate wallet apps — just paste a contract address and go.

Key Features

• Instant Swaps — Jupiter executes Solana swaps, and 0x executes EVM swaps. Pricing providers vary by chain; see Buying Tokens for the current breakdown.
• Stablecoin Swaps — Convert between SOL/ETH/BNB/HYPE and USDC or USDT — and swap USDC ↔ USDT — on all five original chains with zero platform fees (Robinhood swaps ETH ↔ USDG instead — see below).
• Bridge — Move SOL, ETH, BNB, HYPE, USDC, or USDT between Solana, Base, BSC, Ethereum, Hyperliquid, Robinhood, and other supported chains via the 0x cross-chain API.
• Prediction Markets — Trade supported outcomes and auto-claim winnings. GX/Saba markets are YES-only, use market orders only, and cannot be sold before resolution.
• Limit Orders — Set price targets on Solana, Base, BSC, Ethereum, Hyperliquid, and Robinhood, and Viper executes automatically, 24/7.
• Copy Trading — Configure copied buys across all six chains. If copy sells are enabled, a target sell liquidates the entire token balance in your wallet.
• Call Channel Auto-Buy — Subscribe to Telegram alpha channels and auto-buy when new tokens are called on Solana, Base, BSC, Ethereum, Hyperliquid, and Robinhood.
• Take Profit — Automatically create sell orders after call channel buys.
• Multi-Wallet — Create or import multiple wallets for Solana, Base, BSC, Ethereum, Hyperliquid, and Robinhood, and switch between them.
• Self-Custodial — Private keys are Fernet-encrypted (AES-128-CBC + HMAC-SHA256) and never stored in plaintext.
• Referral Discounts — Share your link and both users receive the lower eligible spot rate.

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 creates one Solana wallet and one shared EVM wallet for Base, BSC, Ethereum, Hyperliquid, and Robinhood.
3. Fund your wallet — Send SOL (Solana), ETH (Base/Ethereum/Robinhood), BNB (BSC), or HYPE (Hyperliquid) to your wallet address from any exchange or wallet.
4. Buy a token — Paste any Solana, Base, BSC, Ethereum, Hyperliquid, or Robinhood 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 total portfolio value, balances, wallet addresses, fee tier, and referral link:

Menu Buttons

The home screen uses this fixed five-row keyboard:

• Row 1: Buy | Positions | Perps
• Row 2: Predict | Limit Orders | Bridge
• Row 3: Call Channels | Copy Trade | Swap Stables
• Row 4: Trending | Wallet(s) | Referral
• Row 5: History | Settings | Refresh

Tap Buy or paste a token's contract address to start a trade.

The /balance Command

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

Buying Tokens

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

Paste a Contract Address

The fastest way to buy: paste any Solana, Base, BSC, Ethereum, Hyperliquid, or Robinhood 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, BNB, or HYPE)

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, Ethereum, and Robinhood tokens, BNB amounts for BSC tokens, and HYPE amounts for Hyperliquid tokens.

Search by Ticker

Don't have the contract address? Type a token's ticker or symbol into the chat — with or without a leading $ (for example PEPE or $PEPE) — and Viper runs a DexScreener search for it.

• A single clear match routes you straight into that token's buy card, the same as pasting a contract address.
• Multiple matches show a pick-list of up to 5 candidates — each with symbol, name, chain, and liquidity — so you can tap the right one before buying.
• No match returns a "no token found" message.

How It Works

1. Viper deducts the platform fee from your SOL, ETH, BNB, or HYPE amount.
2. The remaining amount is swapped for the token. Jupiter Swap V2 executes Solana swaps; 0x executes EVM swaps.
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), Etherscan (Ethereum), HyperEVMScan (Hyperliquid), or Blockscout (Robinhood) link.

Execution and Pricing Providers

Execution: Jupiter Swap V2 executes Solana swaps. 0x executes EVM swaps on Base, BSC, Ethereum, Hyperliquid, and Robinhood.

Pricing providers: Solana uses Jupiter Price API v3; Base uses Uniswap V4, Uniswap V3, Uniswap V2, and Aerodrome; BSC uses PancakeSwap V3 and PancakeSwap V2; Ethereum uses Uniswap V4, Uniswap V3, and Uniswap V2; and Hyperliquid uses HyperSwap V3 and Kittenswap. Ethereum has no direct Sushi pricing implementation.

Robinhood: Robinhood uses Uniswap V3 pricing by default. It uses Uniswap V4 only when wider-range RPC configuration supports discovery; configured Uniswap V2 quoting is nonfunctional. Its token-price fallback uses 0x and then DexScreener.

Selling Tokens

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

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, Ethereum, Hyperliquid, and Robinhood 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, BNB, or HYPE) and percentage

Transferred-in tokens: if you added a token via ➕ Add Token (or transferred it in from another wallet), the bot has no cost basis for the transferred balance. Until you make your first bot-executed buy, the position shows Avg Entry: N/A with zero P&L — there's no real entry price to compare against. Once you buy, Avg Entry and P&L start tracking from that real buy. Selling still drains the full on-chain balance (transferred-in plus bot-bought), and "Sell 100%" works as expected.

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.

Hidden Tokens

Tap the Hide button on any position to remove a token from your positions view without selling it. Hidden tokens are tracked per wallet and per chain.

To review or restore hidden tokens, enable Show hidden tokens in /settings → Display. With the toggle on, hidden positions reappear with a 🙈 prefix and an inline Unhide link that restores them in one tap.

Hiding a token is display-only — the token stays in your wallet and remains tradeable through token lookup. Manual hiding is separate from automatic dust hiding (see below).

Dust Tokens

Tokens worth less than roughly $0.10 are hidden from the positions view by default to keep the list focused on meaningful holdings. Dust tokens remain in your wallet and reappear automatically in /positions if their USD value rises back above the threshold.

To show dust in your positions list, enable Show dust positions in /settings → Display.

Token Lookup

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

Paste any Solana, Base, BSC, Ethereum, Hyperliquid, or Robinhood 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.

Best-Effort Token Safety

GoPlus checks are best-effort. Buying is blocked when a definitive known honeypot is reported or when buy or sell tax is 50% or more. A failed, unavailable, or indeterminate check does not block buying; the check fails open. Treat the result as one signal rather than a guarantee. Robinhood is unsupported by GoPlus upstream.

Trending

Discover the hottest tokens across every chain.

Use /trending to see the top trending DEX tokens right now across Solana, Base, BSC, Ethereum, Hyperliquid, and Robinhood. The default view is an aggregate leaderboard combining all six chains, ranked by on-chain trading activity.

Drill Down by Chain

The aggregate view opens first. Tap a chain chip — Solana, Base, BSC, Ethereum, Hyperliquid, or Robinhood — to drill into that chain's trending list on its own. Tap the aggregate chip again to return to the combined view.

Timeframe Toggle

Switch the ranking window with the 1h, 6h, and 24h toggle. Each timeframe re-ranks the list by activity over that period, so you can spot fast movers (1h) or sustained momentum (24h).

Buy in One Tap

Each token row carries a 💰 Buy link and a 📊 Chart link. Tap 💰 Buy to open that token's buy card — the same card you reach from a contract-address lookup, with token info and amount presets — then tap a preset amount or enter a custom one to trade instantly. Tap 📊 Chart to view the live DexScreener chart.

Trade History

Lifetime P&L and closed trade log.

Use /history to see 6 chain buckets for Solana, Base, BSC, Ethereum, Hyperliquid, and Robinhood, plus optional Predict History when prediction-market activity is available. The history view shows:

• Lifetime P&L — Total realized profit/loss broken out across the six named chain buckets
• 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.

Perps History

Tap 📊 Perps History to open a Hyperliquid-perps-specific view showing your all-time net-of-fees realized PnL (sum of closed PnL minus fees, including funding payments when available), per-position win/loss counts and win rate, and a paged log of closed positions (10 per page, newest first).

Swap Stables

Convert between SOL/ETH/BNB/HYPE and a stablecoin, including supported jupUSD routes — with zero platform fees.

Use the Swap Stables button on the main menu to swap between your native token and a supported stable. Solana supports SOL ↔ jupUSD, USDC ↔ jupUSD, and USDT ↔ jupUSD alongside its USDC/USDT routes. Robinhood's sole stablecoin is USDG (Paxos), so Robinhood offers native ETH ↔ USDG — no USDT leg or stable-to-stable swap.

How It Works

1. Select a chain — Choose Solana, Base, BSC, Ethereum, Hyperliquid, or Robinhood.
2. See your balances — Viper shows native, USDC, and USDT balances, plus jupUSD on Solana or USDG on Robinhood.
3. Pick a direction — choose a supported native/stable or stable/stable route, including jupUSD routes on Solana and native ↔ USDG on Robinhood.
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, BNB, or HYPE), Viper automatically holds back a small amount for gas fees:

Solana: a fixed 0.01 SOL is reserved for transaction fees and account rent.

Base, BSC, Ethereum, Hyperliquid & Robinhood: the reserve is dynamic. It tracks the current network gas price — roughly 3× the estimated cost of one swap — so a sudden fee spike can't leave your wallet unable to cover gas, and it's capped so it never holds back more than needed. It never falls below a floor of 0.0025 ETH on Base, 0.001 BNB on BSC, 0.0025 ETH on Ethereum, 0.02 HYPE on Hyperliquid, or 0.0025 ETH on Robinhood; when gas is cheap you'll see close to the floor, and when gas is high the reserve rises automatically.

When swapping a stablecoin (USDC, USDT, jupUSD, or USDG), the full amount is used since gas is paid in the native token.

Stablecoin Balances on Home Screen

USDC, USDT, Solana jupUSD, and Robinhood USDG balance rows are hidden only when formatted as $0.00; the separate $0.10 dust threshold does not apply.

Bridge

Move funds across chains via the 0x cross-chain API — between Solana, Base, BSC, Ethereum, Hyperliquid, Robinhood, and other supported chains.

Use the 🌉 Bridge button on the main menu, or send /bridge, to start a guided cross-chain transfer. Bridges are routed through the 0x cross-chain API, an aggregator that finds the best route across underlying bridges and DEX paths.

Supported Routes

• Source chains: Solana, Base, BSC, Ethereum, Hyperliquid, Robinhood (your bot wallet sends the funds).
• Destination chains: Solana, Base, BSC, Ethereum, Hyperliquid, Robinhood, plus EVM destinations Arbitrum, Optimism, Unichain, Polygon, Monad, Sonic, Worldchain, Abstract, Mantle, Mode, Avalanche, Ink, Linea, Berachain, Scroll, Blast, and Plasma — and Tron (non-EVM). Coverage tracks 0x's supported routes for the selected source chain — the list expands as 0x adds chains.
• Tokens: Native (SOL / ETH / BNB / HYPE), USDC, or USDT between the five core chains that share USDC/USDT (Solana, Base, BSC, Ethereum, Hyperliquid). Robinhood is also a core source/destination chain but has no canonical USDC/USDT — it carries native ETH and USDG (Paxos) instead. Extended EVM destinations support native and USDC; Blast, Plasma, and Tron are native-only.

How It Works

1. Pick the source chain — the chain you're sending FROM.
2. Pick the source token — native, USDC, or USDT, or USDG on Robinhood.
3. Enter an amount — preset percentages (25 / 50 / 75 / Max) or a custom value.
4. Pick the destination chain — paginated, 9 per page.
5. Pick the destination token — native, USDC, or USDT, or USDG on Robinhood (availability depends on the destination chain — see Tokens above).
6. Pick the destination address — your bot wallet on the destination chain (default, when available), or paste a custom address.
7. Review the quote — expected receive amount, minimum receive, slippage, ETA, and bot fee.
8. Confirm — the bot broadcasts on the source chain, then polls 0x for status updates.

Bridge History

Send /bridges to see your completed transfers — bridges that finished, failed, were refunded, or partially settled — in a paginated list, most recent first. Each numbered row shows the date and the conversion (for example, Base 259 USDC → Solana 258.40 USDC); tap a row to expand its detail view, including the source and destination transaction links, the bridge tool used, the received amount, and any error details. In-flight transfers appear on the live status card while the bridge is still in progress.

Quote Freshness

0x quotes are time-sensitive. If the cached quote is older than ~30 seconds at confirm-time, Viper automatically refetches a fresh quote before broadcasting. If the new quote's buyAmount has dropped by more than 2% compared to the cached value, the confirm is aborted and you'll see a "Quote moved — review and confirm again" message so you can re-confirm at the new rate.

Minimums

Bridges have a hard $5 USD minimum. Viper shows a soft advisory on the destination-chain screen when the picked amount falls below it, and enforces the floor at confirm time: a sub-$5 bridge is blocked before any quote is fetched with Minimum bridge size is $5. When the amount can't be priced in USD (for example a native-token amount with no fresh price), the gate fails open and 0x's own per-route minimum applies — if a quote then comes back with the empty "None of the available routes" error, the bot translates it to Amount is below the minimum bridge size for this route. so you know exactly why the route failed.

Safety

• AllowanceHolder allowlist (EVM): a 0x quote is only signed if its transaction to matches the canonical 0x AllowanceHolder contract — the same address across all 5 EVM chains — and any ERC-20 approval spender must equal that same AllowanceHolder.
• Validate-before-sign: chain ID, from address, value, and approval address are checked before any signature.
• Address validation: destination address format is enforced per chain — Solana base58 for Solana, hex for EVM. Pasting a Solana address for an EVM destination (or vice versa) is rejected.
• Idempotency: double-tapping Confirm toasts "Already submitting" and the second tap is ignored.
• Edit-while-submitting: once a bridge is in flight, you can't edit upstream parameters or cancel the builder — the on-chain transaction has already been dispatched.

Perps Transfer

Your Hyperliquid perps hub — open positions, manage trades, and move USDC in and out of your margin.

Send /perps (or tap ⚡ Perps on the main menu) to open your Hyperliquid perps hub. New to perpetual futures? Read Perps Explained first — it defines every term and setting in plain language.

The Hub

Opening /perps shows your perps account at a glance:

• Account value & unrealized PnL — your total perps equity, with combined open-position profit or loss right at the top.
• Free margin & margin used — how much margin is available for new positions versus locked behind open ones.
• 📋 In orders — on cross-margin accounts, the margin currently reserved by your resting (open) orders. Shown only when that reserved amount is meaningful.
• Open positions — each position shows its direction (Long/Short), leverage, unrealized PnL, and ROE% (return on the margin you put up). Tap a position chip to expand its details — entry price, mark price, liquidation price, size, and margin.
• 📈 New Position — open the order ticket to place a trade (see below).
• 🔥 Markets — browse every Hyperliquid perp market, sorted by Volume, Gainers, Losers, Open Interest, or Funding. Page through the list and tap any coin to open its order ticket pre-seeded with that market.
• 📋 Orders — view and manage every resting (open) order across all your markets in one place (see Your Resting Orders below).
• ↻ Refresh — pull fresh balances and prices.
• 🟢 Quick BTC Long / 🔴 Quick BTC Short — one-tap shortcuts that open a BTC position immediately using your saved Quick Settings defaults, exactly like /perps_long btc / /perps_short btc (see Instant-fire commands below).
• ⬆️ Deposit / ⬇️ Withdraw — sub-menus for moving USDC in and out of your margin (see Transfers below).

Opening a Position

Tap 📈 New Position, pick a market (or type a symbol to search), and the order ticket opens. From the ticket you set up the trade — every field is explained in Perps Explained:

1. Choose ⚡ Market (fills now) or 📊 Limit (rests until your price is reached).
2. Pick 🟢 Long or 🔴 Short.
3. Set your Margin in USD — tap a shortcut (25% / 50% / Max of your free margin) or enter a custom amount.
4. Set your Leverage (up to the market's maximum). Notional = margin × leverage.
5. Choose Cross or Isolated margin.
6. Optionally tap 🎯 Add TP / SL to set a Take-Profit and/or Stop-Loss that arm the moment your position opens.
7. Review the live preview — estimated entry, liquidation price, and fee — then tap Open.

Your Resting Orders

Tap 📋 Orders on the hub to see every resting (open) perps order across all your markets in one paginated list — page through it and tap an order chip to select it. Once an order is selected you can:

• ✏️ Edit — for limit orders, reopens the order ticket pre-filled with that order's values; editing cancels the original order first (freeing the margin it had reserved), then places the replacement at your new settings. For TP/SL triggers, Edit prompts for a new trigger price and performs the same cancel-and-replace.
• Cancel — cancel just that one order.
• ✕ Cancel All — cancel every resting perps order in one tap.

Equities

Beyond crypto perps, the 🔥 Markets browser has a 📈 Equities sub-view for live HIP-3 markets. TSLA, AAPL, and crude oil are examples; Examples can change as markets update. Tap an available market to open its order ticket.

• Isolated margin only — these markets always trade with isolated margin (the most you can lose is the margin you assign to that one position); there's no cross-margin option.
• Live venue fee multiplier — HIP-3 markets use the same Viper builder fee as main perps. The venue can add a live venue fee multiplier, shown before you open.
• Separate margin balance — their margin is a separate pool from your main perps USDC. Fund it with the Move to Equities margin row in the ⬆️ Deposit menu, and pull it back with the Move from Equities margin row in the ⬇️ Withdraw menu. Your Equities margin shows as a ↳ Equities sub-row on /start, /positions, and the perps hub.

Instant-fire commands

/perps_long <ticker> and /perps_short <ticker> use your saved Quick Settings. Add an amount and an x-suffixed leverage to override them; for example, /perps_short eth 50 5x uses $50 margin at 5×. Viper asks for confirmation before a position flip, at 25x leverage or higher, or at $5,000 notional or higher by default.

Quick Settings

Tap ⚙️ Settings on the /perps hub to open Perps Quick Settings, where you set the defaults the instant-fire commands use:

• Default amount — the margin (USD) a one-command order puts up when you don't pass an amount inline.
• Default leverage — the multiplier applied when you don't pass leverage inline.
• Default margin mode — Cross or Isolated for instant-fire positions.
• Default slippage — the slippage allowance used for the market fill.

Transfers

The ⬆️ Deposit and ⬇️ Withdraw sub-menus move USDC between your HyperEVM wallet and your Hyperliquid perps margin. These are native Hyperliquid transfers — they do not route through the 0x cross-chain bridge or any external bridge — so they're fast and low-cost.

• 💵 Deposit USDC → perps — move USDC from your HyperEVM wallet into your perps margin.
• 💵 Perps USDC → wallet — move free perps margin back to your HyperEVM wallet.
• ⛽ Deposit HYPE to Core — fund a small amount of HYPE on your Hyperliquid Core account. This is the gas that withdrawals use; if your Core gas is 0, a withdrawal can stall partway. Top it up before withdrawing.

Each transfer screen shows the Available balance for that action — pick a preset (25% / 50% / 75% / Max) or enter a custom amount, then confirm. Viper submits the transfer and confirms it landed by polling your Hyperliquid balances.

Want to fund your margin from another chain? Bridge USDC to your Hyperliquid wallet with /bridge, then use /perps to deposit it into your perps account.

Core → Wallet Recovery

The ⬇️ Withdraw sub-menu also offers one-tap recovery buttons when you hold leftover balances on your Hyperliquid Core account:

• ♻️ Core USDC → wallet — appears if a withdrawal ever left USDC parked on Core (for example, if Core gas ran out mid-transfer). Finishes the withdrawal and sends the USDC to your HyperEVM wallet.
• ♻️ Core HYPE → wallet — appears when you hold HYPE on Core. Sweeps your Core HYPE back to your HyperEVM wallet, keeping a small HYPE gas reserve so future withdrawals can still settle.

Minimums

Opening an order requires a $10 USD minimum notional (notional = margin × leverage), so a smaller position is rejected before it is placed. Reduce-only closes are exempt — you can always close out below $10.

Deposits have a $5 USD minimum — Hyperliquid will not credit a smaller deposit. Withdrawals have no minimum.

Perps Explained

New to perpetual futures? Here's every term and setting in plain language.

The basics

• Perpetual future (perp) — a contract that tracks a coin's price and never expires. You can bet the price goes up (long) or down (short) without owning the coin.
• Margin — the money (USDC) you put up to open a position. It's your collateral, not a fee.
• Free / available margin — margin that isn't backing any open position yet. New positions draw from this.
• Margin used — margin currently locked behind your open positions.
• Leverage — a multiplier on your margin. At 10× leverage, $500 of margin controls a $5,000 position. Higher leverage means bigger gains and bigger losses, and a liquidation price closer to the current price.
• Position size (notional) — the total value of your position. Notional = margin × leverage. So $500 margin at 10× = a $5,000 position.

Margin modes

• Cross margin — all your free margin backs the position. Harder to liquidate, but a bad position can draw down your whole account.
• Isolated margin — only the margin you assign to that one position is at risk. The most you can lose is that allocation.

Risk & price terms

• Liquidation price — the price at which your losses use up your margin and the position is force-closed. Stay aware of it; higher leverage moves it closer.
• ROE (return on equity) — your profit or loss as a percentage of the margin you put up (leverage-aware). A +13% ROE on $500 margin is +$65 — even if the coin only moved a little.
• Funding — a small periodic payment exchanged between longs and shorts to keep the perp price near the real coin price. Sometimes you pay it, sometimes you receive it.

Order types

• Market order — fills immediately at the current price (with a little slippage allowance).
• Limit order — only fills at the price you set or better; it rests until then.
• Reduce-only — an order that can only shrink or close a position, never flip or grow it. Closing uses reduce-only.
• Take-profit (TP) — auto-closes the position once it reaches a profit target you choose.
• Stop-loss (SL) — auto-closes the position once it falls to a loss limit you choose, to cap the downside.

Fees

Hyperliquid charges venue fees. Viper can add a configurable builder fee, 0.05% by default when enabled; referral discounts do not apply. HIP-3 markets use the same Viper builder fee and can add a live venue multiplier. Your order ticket shows the current estimate before you open.

Managing & exiting a position

• Close — exits the whole position immediately at market.
• Reduce — closes part of the position (25/50/75% or a custom amount).
• Add to position — tap ➕ Add to re-open the order ticket pre-seeded with that position's coin and side, with leverage and margin mode locked (so adding can't accidentally re-lever or flip the whole position); you then choose market vs limit and a size, the same as opening a new position.
• Adjust leverage — changes the multiplier on an open position; this also moves its liquidation price.
• Add / remove margin (isolated only) — moves margin in or out of one isolated position to push its liquidation price further away or free up collateral.
• Set TP / SL — adds a take-profit or stop-loss trigger to an already-open position. A take-profit can close a chosen portion of the position (you pick 25/50/75/100% or a custom %), so it can be a partial exit; a stop-loss always closes the full position. Either triggers at market once your trigger price is reached.
• Cancel orders — removes resting limit orders or TP/SL triggers you no longer want.

Prediction Markets (Beta)

Trade supported event outcomes and claim winnings on Jupiter prediction markets.

Use /predict (or tap Predict) on Solana. From the Predict hub, you can review your USDC and jupUSD balances and open positions, sell an eligible position, or claim a resolved win manually.

Browse Markets

Open an event to view 10 markets per page, with previous and next buttons when more are available. GX/Saba markets are YES-only, use market orders only, and cannot be sold before resolution. Other markets may offer both sides and early sells.

Buying Shares

Open a market to see its available outcomes and current prices, choose an amount in USDC, then confirm. A YES share at $0.70 implies a 70% market-implied probability. Viper also previews the estimated payout if your outcome wins.

Selling a Position

When a market supports early exits, open the position and tap Sell. GX/Saba positions do not show this option and settle only at resolution.

Auto-Claim

Auto-claim is on by default and can be changed in /settings. If the bot misses a claim, Jupiter's 24-hour keeper provides a backstop.

Shareable Market Links

Every market has a shareable deep link. Share it and anyone who taps the link opens that market's card directly in the bot — useful for sharing calls or discussing specific markets in your community.

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/Robinhood buys, BNB for BSC buys, HYPE for Hyperliquid 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

Polling is the default order-monitoring mode. Base, Ethereum, and Hyperliquid can instead use new-heads WebSocket monitoring when Base WSS URLs are configured, Ethereum WSS URLs are configured, or Hyperliquid WSS URLs are configured; each falls back to polling when WebSocket monitoring is unavailable. BSC always polls.

Robinhood orders poll every 5 seconds. They use new-heads WebSocket monitoring only when Robinhood WSS URLs are configured and new-heads monitoring is enabled; the fallback remains 5-second polling.

Jupiter Swap V2 executes Solana swaps. 0x executes EVM swaps; pricing providers are Jupiter on Solana, Uniswap V4/V3/V2 and Aerodrome on Base, PancakeSwap V3/V2 on BSC, Uniswap V4/V3/V2 on Ethereum, HyperSwap V3 and Kittenswap on Hyperliquid, and qualified Uniswap pricing on Robinhood.

Optional Jupiter Trigger

Jupiter Trigger is optional. Eligible Trigger orders escrow funds while Trigger is enabled. Stablecoin-legged orders continue to poll. Polling remains active for stablecoin-legged orders and when Trigger is disabled; funds remain in your wallet until execution.

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 continuously and sells when your target is hit.

How It Works

1. Call channel auto-buys: 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. Copy-trade auto-buys: Viper creates the configured TP order after detecting the copied buy, without the call-channel delay.
3. Manual buys: Open the position card and tap Limit Sell to set a take-profit price target.
4. 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 native (SOL/ETH/BNB/HYPE) investment. The rest rides as pure profit.

Copy Trading — Setup

Configure copied buys and optional full-balance sells.

Copy trading monitors a target wallet and sizes copied buys for you. Copy trading works on Solana, Base, BSC, Ethereum, Hyperliquid, and Robinhood.

Adding a Copy Trade

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

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

Robinhood monitoring: Robinhood copy monitoring uses new-heads WebSocket only when Robinhood WSS URLs are configured; the new-heads order setting does not apply. Its default is HTTP polling every 3 seconds, with HTTP polling every 3 seconds after WebSocket failure as the fallback.

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 target sells also liquidate your full balance of that token, or copy buys only.
• 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 (see below).
• Remove — Delete the copy trade entirely.

Stop Loss on Copy Trades

Each copy trade supports an optional stop loss that runs on every position the copy opens for you. Two trigger types are available:

• Fixed — sell when the token price falls a set percentage below the copy's entry price.
• Trailing — sell when the price falls a set percentage from the highest price seen since entry (the trigger auto-raises with rallies).

The sell percentage is configurable (50%, 100%, or custom). Stop loss composes with take profit on the same copy — whichever triggers first wins. On partial sells, the remaining position continues to track the same trigger.

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, Ethereum, Hyperliquid, or Robinhood), 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, Hyperliquid, Robinhood, or any combination (auto-selected if you only have one wallet).
2. Enter the channel's @handle (e.g., @alpha_calls) or paste its public link (e.g., https://t.me/alpha_calls).
3. Set the buy amount per call (SOL for Solana, ETH for Base/Ethereum, BNB for BSC, HYPE for Hyperliquid, ETH for Robinhood).
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.

Stop Loss on Call Channels

Each call channel you track can run a stop loss on every auto-bought position, configured per channel. The two trigger types mirror copy trading:

• Fixed — sell on a percentage drop below entry.
• Trailing — sell on a percentage drop from the highest price seen since entry.

The sell percentage is configurable (50%, 100%, or custom). Stop loss composes with take profit on the same channel — whichever fires first executes.

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

Create & Import Wallets

Generate new wallets or import existing ones.

Create a New Wallet

Tap New Wallet and choose Solana, Base, BSC, Ethereum, Hyperliquid, or Robinhood. A new keypair is generated and encrypted immediately. Creating, importing, or selecting any EVM wallet activates the same address on Base, BSC, Ethereum, Hyperliquid, and Robinhood.

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.
• EVM — Paste your hex private key once for Base, BSC, Ethereum, Hyperliquid, and Robinhood.
• 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, BNB, or HYPE).
• Switch active wallet — Solana switches independently. Selecting an EVM wallet activates the same address on Base, BSC, Ethereum, Hyperliquid, and Robinhood.
• 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, BNB, or HYPE) with the active wallet highlighted.

Withdraw

Send SOL, ETH, BNB, HYPE, 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/HYPE 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), Etherscan (Ethereum), HyperEVMScan (Hyperliquid), or Blockscout (Robinhood) link to track the transfer.

Move Everything

Sweep an entire wallet's holdings to a new or external address in one tap.

From the wallet menu, tap 🧹 Move Everything to evacuate a wallet's balances — useful when rotating to a fresh wallet or moving funds out quickly.

1. Choose a scope: a single chain, all EVM chains at once, or Solana.
2. Choose a destination: create a brand-new bot wallet, or type any external address.
3. Review the preview — it lists exactly what will be moved and what's skipped — then confirm.
4. If you have a PIN set, enter it to authorize the move.

Each sweep moves your native balance, supported stables such as USDC, USDT, and Robinhood USDG, and every token the bot tracks for you — plus other on-chain SPL tokens on Solana. Untracked EVM tokens are excluded. Open limit and stop-loss orders are cancelled first so their reserved funds are freed.

Hyperliquid perps positions and margin are excluded. Close positions and withdraw margin first, then run Move Everything for the remaining HyperEVM wallet assets.

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 message includes a 🗑 Delete now button for instant removal, and also auto-deletes after 15 seconds as a fallback.
• If you have active wallets on more than one chain, /export first asks which wallet's private key you want to export and shows a button per chain. With wallets on only one chain, it exports that wallet directly.

Burn Tokens

Remove unwanted Solana tokens and reclaim rent.

Use /burn on Solana only. It lists nonzero, non-stable tokens and lets you select up to 20 at once.

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 /claim to close eligible empty accounts and reclaim their rent.

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.

Slippage is set in basis points via /settings — 100 bps = 1%, 1000 bps = 10%. There are no pre-defined tiers; enter the value that matches your token's volatility.

On Solana

Solana swaps use a fixed 1% (100 bps) default. In /settings, you can set a different fixed value and use it for both buys and sells.

On Base, BSC, Ethereum, Hyperliquid & Robinhood

BSC defaults to 3%. Base, Ethereum, Hyperliquid, and Robinhood default to 1%. Each EVM chain stores one slippage value for buys and sells; change it in /settings.

Stablecoin Swaps

Stablecoin swaps (native↔USDC/USDT and USDC↔USDT) use a separate slippage value, set once and applied on every chain. It defaults to 25 bps (0.25%). Configure via /settings → 🪙 Stablecoin Slippage. Robinhood's native↔USDG swap uses this same stablecoin 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.

Display

Control what appears on your positions page.

The Display sub-menu in /settings has two toggles that filter your /positions list. Both default to off — the same behaviour Viper has always had.

Show dust positions

When off (default): tokens worth less than ~$0.10 are hidden from the positions list.

When on: dust tokens appear alongside your meaningful holdings so you can review small balances before claiming rent, burning, or consolidating.

Show hidden tokens

When off (default): tokens you've hidden via the Hide button stay out of the positions list.

When on: hidden positions render with a 🙈 prefix and an inline Unhide link. Tap it to restore the token to your regular positions view.

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.1 BNB · 0.25 BNB · 0.5 BNB · 1.0 BNB

Ethereum: 0.05 ETH · 0.1 ETH · 0.25 ETH · 1.0 ETH

Hyperliquid: 0.1 HYPE · 0.5 HYPE · 1.0 HYPE · 5.0 HYPE

Robinhood: 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.

To remove your PIN entirely, tap the 🗑️ Remove PIN button in /settings. You'll need to enter your current PIN to confirm the removal.

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 MEV protection uses alternative submission paths selected by execution path and deployment configuration:

• Jito path — submits a Jito bundle when that path is selected and configured.
• Jupiter /execute or Beam path — uses Jupiter submission when that alternative is selected and supported.

These paths are alternatives, not a stacked Jito-plus-Beam route. Standard Jupiter submission is the fallback.

Ethereum

Ethereum only: Flashbots Protect is used when MEV protection and a protected RPC are configured. If protected submission fails, it falls back to public RPC; privacy is not guaranteed after fallback. Ethereum also uses adaptive fee history and pre-simulation.

Base / BSC / Hyperliquid / Robinhood

MEV protection is not currently available on Base, BSC, Hyperliquid, or Robinhood. 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 Solana or Ethereum, and tap MEV Protection. Availability still depends on the selected execution path and deployment configuration; standard submission remains the fallback.

Referral Program

Lower eligible spot rates — together.

Share your referral link and both users receive the lower eligible spot rate.

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 pay 0.20% instead of 0.25% on eligible spot trades.

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

Fees depend on the product you use.

Eligible spot includes manual swaps, limit orders, call-channel trades, copy trades, and trigger orders.