Jupsy Bot Documentation
Welcome to the official developer and user documentation for Jupsy Bot — the high-performance Solana trading engine and copy trading suite engineered natively for Discord communities.
Sub-Second Execution
Direct low-latency swap routing via Jupiter Swap API with direct Versioned Transaction Solana RPC broadcasting.
Automated Copy Trading
Mirror any top Discord trader automatically with proportional sell exits, gas reserve protection, and instant DM notifications.
4,600+ Tokens DB
Automated 24-hour background token synchronization caching verified mint addresses with 0ms in-memory resolution.
Quick Start in 3 Easy Steps
Get up and running with Jupsy Bot in under two minutes inside any Discord server where Jupsy Bot is installed.
Configure Your API Key & RPC Endpoint
Run the /setup command in Discord. Click Configure API & RPC to input your free Jupiter API key and Helius Solana RPC URL.
/setup
Generate Your Dedicated Solana Wallet & Deposit SOL
Type /wallet to open your private wallet console. Click 📥 Deposit to view your public Solana address and scannable QR code. Send a small amount of SOL (e.g. 0.05 SOL) to get started.
/wallet
Perform Your First Swap or Start Copy Trading
Click 🟢 Buy Tokens in your /wallet to purchase any token (e.g. BONK, JUP, RAY) or follow an expert server trader with /copy-trade follow @trader.
/copy-trade follow user:@trader max_sol_amount:0.05
System Architecture & Security Model
Jupsy Bot is built with defense-in-depth principles to protect user funds, safeguard API credentials, and provide sub-second transaction routing.
| Component | Implementation Standard | Purpose |
|---|---|---|
| Private Key Storage | Fernet Symmetric AES-256 Encryption | User private keypairs are encrypted with server-level cryptographic secrets before persisting to SQLite/PostgreSQL. |
| RPC Transmission | HTTPS / TLS 1.3 to Helius Mainnet | Signed VersionedTransaction payloads are submitted directly to dedicated RPC nodes. |
| Balance Safeguard | Truncated 3-Decimal Formatting | Prevents rounding overshoots (e.g. `0.8339` SOL formats as `0.833` SOL instead of `0.834` SOL) to guarantee zero insufficient balance errors. |
| Gas Reserve Lock | 0.005 SOL Auto-Retention |
Both manual withdrawals and automated copy-trades preserve at least 0.005 SOL to pay for future network transaction fees. |
| Anti-Double-Click | Atomic UI State Lock | Swap confirmation buttons immediately disable on first click to prevent duplicate transaction broadcasting. |
/setup — API Keys & Helius RPC
Jupsy Bot utilizes dedicated per-user credentials to bypass rate limits and provide institutional-grade transaction confirmation speeds.
/setup
How /setup Works
Running /setup delivers an ephemeral message with current configuration statuses and an interactive Configure API & RPC button. Clicking this button opens a modal form with two secure inputs:
Pre-Filling & Validation Logic
If you have already configured one or both fields, the modal will automatically pre-fill your existing credentials and mark them optional. You can update one field without having to re-enter the other.
Getting a Free Jupiter API Key
Jupiter API keys unlock dedicated routing rate limits across 4,600+ Solana tokens.
Visit the Jupiter Developer Portal
Navigate to developers.jup.ag/portal ↗ and connect your Solana wallet.
Generate an API Key
Create a new project key. Keys start with the prefix jup_ (e.g. jup_live_7x9Q...).
Save in Discord via /setup
Paste the key into the Jupiter API Key field in the /setup modal.
Getting a Free Helius RPC Endpoint
Helius provides dedicated Solana RPC nodes with priority transaction broadcasting to minimize failed or dropped swaps during network congestion.
Sign Up on Helius Developer Portal
Go to dashboard.helius.dev ↗ and sign up for a free developer tier account.
Copy Your Mainnet RPC URL
Copy your HTTP RPC endpoint. It will look like:https://mainnet.helius-rpc.com/?api-key=YOUR_API_KEY
Paste into /setup
Paste your full Helius URL into the Helius RPC URL field in the /setup modal.
/wallet — The Wallet Console
The /wallet command is your central mission control inside Discord. It displays your public Solana address, live SOL balance, all non-zero SPL token holdings, and interactive action buttons.
/wallet
Depositing Funds & Scannable QR Codes
Clicking the 📥 Deposit button in /wallet renders a private embed containing:
- Your Full Public Key: Ready to copy with 1 click in Discord.
- Live Scannable QR Code: Compatible with Phantom, Solflare, Backpack, and Coinbase Wallet camera scanners.
- Clickable Solscan Link: Direct hyperlink to inspect your wallet address on Solscan.io ↗.
/wallet immediately after sending from Phantom or an exchange to see your updated SOL and token balances.
Withdrawals & Gas Retention Locks
Clicking the 📤 Withdraw button opens an interactive modal allowing you to transfer SOL or SPL tokens to any external Solana wallet address.
Withdrawal Protection Rules
| Field | Validation Rule | Description |
|---|---|---|
| Recipient Address | Valid Base58 Solana Public Key | Verified using Solana cryptography before submitting. Prevents burning funds to invalid strings. |
| Withdrawal Amount | amount > 0 and balance - amount >= 0.005 SOL |
A safety buffer of 0.005 SOL is always retained to cover rent and gas fees. |
| Confirmation Modal | Explicit 2-Step Confirmation | Displays recipient, amount, fee breakdown, with a green Confirm and gray Cancel button. |
Buying SPL Tokens with SOL
Buying any token takes seconds. Simply click 🟢 Buy Tokens in your /wallet:
Specify Token Symbol or Mint Address
Enter any ticker (e.g. BONK, JUP, WIF, PUMP, USDC) or paste any raw 44-character Solana mint address.
Enter SOL Amount & Slippage Tolerance
Input the amount of SOL to swap (e.g. 0.1) and your slippage percentage (default: 1.0%).
Review In-Place Swap Quote & Confirm
Jupsy Bot fetches the exact Jupiter routing quote and displays estimated output tokens. Click Confirm Swap. The transaction signs, broadcasts via Helius RPC, and confirms with a Solscan transaction hash receipt.
Selling SPL Tokens Back to SOL
Click 🔴 Sell Tokens in your /wallet. You will see an interactive menu of all SPL tokens currently held in your wallet:
- Select Token: Pick the token you wish to sell from your active holdings.
- Percentage or Fixed Amount: Choose 25%, 50%, 75%, 100% (ALL), or type an exact token quantity.
- Sub-Second Execution: Swaps execute directly against Jupiter DEX pools and return native SOL into your wallet.
4,600+ Tokens DB & Truncated Precision
Jupsy Bot features an automated 24-hour background synchronization engine that populates an in-memory token database of over 4,600+ verified Solana tokens.
Automated Solana Copy Trading Suite
Jupsy Bot's automated copy trading engine allows you to mirror the token purchases and sales of any top trader in your Discord server with institutional-grade safeguards.
Fixed SOL Buy Allocation
Regardless of whether the trader buys with 10 SOL or 100 SOL, your trade executes with your exact configured budget (e.g. 0.05 SOL).
Proportional Auto-Exits
When the trader sells 50% of their bag, Jupsy Bot automatically sells 50% of your bag for that specific token.
Direct Discord DM Receipts
Every mirrored transaction immediately sends you a private DM receipt with Solscan transaction links and execution prices.
/copy-trade follow — Mirroring a Trader
Start mirroring any Discord member in your server with customizable SOL limits and slippage tolerances.
/copy-trade follow user:@trader max_sol_amount:0.05 slippage_pct:1.5
Command Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
user |
Required Member |
— | The Discord user whose trades you want to mirror. |
max_sol_amount |
Optional Float |
0.1 SOL |
Maximum amount of SOL to spend per copied buy order (min: 0.001 SOL). |
slippage_pct |
Optional Float |
1.5% |
Maximum allowable slippage percentage for mirrored orders (0.1% - 50.0%). |
/setup and executed at least 1 prior test swap in /wallet before enabling copy trading.
Proportional Exits & Gas Retention
The copy trading engine uses smart proportion calculation to handle multi-step scale-outs:
Example: Proportional Scale-Out Workflow
- Buy Signal:
@Traderbuys 1,000,000 $BONK with 5 SOL. Follower buys 10,000 $BONK with their configured0.05 SOLlimit. - Partial Take-Profit:
@Tradersells 500,000 $BONK (50% of their bag). Jupsy Bot automatically calculates the 50% ratio and sells 5,000 $BONK (50% of follower's bag) into SOL. - Final Exit:
@Tradersells their remaining $BONK. Follower's remaining balance is sold automatically.
Managing Targets: List, Pause & Resume
You can manage your active copy trading targets at any time with dedicated commands:
/copy-trade list
Displays all traders you are currently copying, their active/paused status, total copied trades, and total SOL allocated.
/copy-trade pause user:@trader
Temporarily pauses mirroring a trader without losing your custom SOL allocation and slippage settings.
/copy-trade resume user:@trader
Re-activates mirrored trading for a previously paused target.
/copy-trade unfollow user:@trader
Completely removes a trader from your copy trading list.
/copy-trade leaderboard — Server Rankings
Discover top traders in your Discord server ranked by Net Realized Profit (SOL), Win Rate %, and Total Trade Volume.
/copy-trade leaderboard
1-Click Copy Trading via /pnl
When inspecting any trader via /pnl user:@trader, Jupsy Bot automatically renders a 👥 Copy Trade @Trader button at the bottom of their profile embed. Clicking this button opens a modal allowing you to configure your budget and start copying with zero typing required.
/pnl — Portfolio Analytics
The /pnl command calculates your comprehensive trading performance across all Solana swaps executed with Jupsy Bot.
/pnl
Metrics Calculated
| Metric | Formula / Details |
|---|---|
| Net Realized PnL | Total SOL Received from Sells - Total SOL Spent on Buys |
| Realized ROI % | (Net Realized PnL / Total SOL Cost Basis) * 100 |
| Win Rate % | (Profitable Closed Trades / Total Closed Trades) * 100 |
| Total Trade Volume | Aggregate SOL volume across all completed buy and sell transactions. |
Inspecting Other Traders (/pnl user)
Audit the verified track record of any server member before deciding to mirror their trades.
/pnl user:@trader
Token Breakdown Analysis (/pnl token)
Inspect your historical profit and loss on an individual token basis (e.g. BONK, JUP, WIF).
/pnl token:BONK
/logs — Transaction Audit History
Jupsy Bot logs every transaction in the database and formats your 20 most recent entries with dynamic local Discord timestamps (<t:timestamp:f>) and Solscan verification links.
/logs
Log Categories & Solscan Links
Activity logs are categorized cleanly into four main action types:
| Category | Action Trigger | Solscan Hyperlink Included |
|---|---|---|
BUY |
Token purchase via /wallet or automated copy trade. |
✅ Yes (Transaction Signature) |
SELL |
Token sale via /wallet or automated copy trade. |
✅ Yes (Transaction Signature) |
WITHDRAWAL |
SOL or SPL token transfer to external address. | ✅ Yes (Transaction Signature) |
COPY_TRADE |
Follow, unfollow, pause, or resume action. | — |
WALLET_CHECK) are logged silently in the database for security compliance but are filtered out from the Discord /logs embed so your transaction feed stays clean and readable.
Genesis NFT Pass & Rights
Holding a Jupsy Bot Genesis NFT unlocks lifetime premium features, governance participation, and server licensing rights.
0% Bot Swap Fees
Zero platform surcharges across all token swaps executed through your personal Discord wallet forever.
Server Whitelisting Rights
Authorize Jupsy Bot inside your own Discord servers and communities with custom branding options.
Phase 2+ Priority Access
Early access to upcoming DeFi features including Limit Orders, Dollar-Cost Averaging (DCA), and Yield Vaults.
Fee Structure Comparison
| Tier | Swap Platform Fee | Copy Trading Engine | Server Whitelisting |
|---|---|---|---|
| Public Free Tier | 0.5% | Standard Speed | Public Servers Only |
| Genesis NFT Pass Holder | 0.0% (Zero Fees) | Priority Parallel Execution | Unlimited Servers |
RPC & Swap Error Resolution
Jupsy Bot translates low-level Solana RPC errors into friendly, actionable diagnostic messages.
| Error Type | Root Cause | How to Resolve |
|---|---|---|
AccountNotFound |
Wallet has 0 SOL or recipient token account does not exist. | Deposit a small amount of SOL (e.g. 0.01 SOL) into your Jupsy wallet address. |
BlockhashNotFound |
Transaction expired during Solana cluster congestion. | Retry the swap. Ensure your Helius RPC URL in /setup is configured. |
SlippageExceeded |
Price moved beyond your maximum slippage tolerance. | Increase slippage percentage (e.g. from 1.0% to 2.5%) during high volatility. |
InsufficientBalance |
Attempting to swap or withdraw more SOL than available after reserving gas. | Leave at least 0.005 SOL in your wallet to cover network transaction fees. |
Managing Slippage in Fast-Moving Markets
When trading newly launched meme tokens or during major market volatility, prices can shift within milliseconds. If your swap fails with SlippageExceeded:
- Type a higher slippage tolerance (e.g.
2.0%or3.0%). - Verify your Helius RPC URL in
/setupto take advantage of priority fee routing.
Gas Locks & Minimum SOL Reserves
Solana requires a tiny amount of SOL (usually 0.000005 to 0.002 SOL) to pay for transaction signatures and token account rent. Jupsy Bot automatically enforces a 0.005 SOL safety reserve on all withdrawals and copy trades to ensure your wallet never becomes locked.
Cryptographic Specifications
Technical implementation details for security auditors and developers:
- Encryption Algorithm: Fernet Symmetric Key Cryptography (AES-128-CBC + HMAC-SHA256 authenticated envelope).
- Key Derivation: 256-bit cryptographically secure pseudorandom secret derived from environment configuration.
- Transaction Construction:
solders.transaction.VersionedTransactionwithMessageV0compiled instructions. - Auditability: Every trade hash and token mint is hyperlinked to official Solscan verification endpoints.
Frequently Asked Questions
No. Your private keys are encrypted with AES-256 and stored in the database. Transactions can only be initiated through your personal Discord user account interactions.
You can withdraw your entire SOL and token balances to your Phantom or Solflare wallet at any time with 0 platform fees using the /wallet Withdraw modal.
Jupsy Bot checks token mints against Jupiter's verified routing engine and enforces your max_sol_amount budget limit on every single buy order, capping your maximum downside per trade.