Documentation

Welcome to AbuBeast, your AI-powered Solana trading companion. This guide will walk you through everything you need to know to get started and make the most of the platform.

AbuBeast is a non-custodial trading bot that uses advanced AI algorithms to execute trades on the Solana blockchain. It connects directly to your wallet and trades on your behalf while you remain in full control of your funds at all times.

Before you can access the trading dashboard, you need to create an account. This is a simple process that takes less than a minute.

1. 1Visit the AbuBeast homepage and click "Launch Terminal" or navigate to the signup page.
2. 2Enter your display name, email address, and create a strong password (at least 8 characters).
3. 3Confirm your password and click "Create Account".
4. 4You will be automatically logged in and redirected to the dashboard.

Once your account is created, you can log in at any time using your email and password. Your account allows you to save settings, track your trading history, and manage your preferences across sessions.

After logging in, you need to connect your Solana wallet to view your portfolio data and enable trading. AbuBeast supports three popular wallets:

1. 1Click the "Connect Wallet" button in the top right corner of the dashboard.
2. 2A dropdown will appear showing available wallets. Select your preferred wallet.
3. 3Your wallet extension will open a prompt asking you to approve the connection.
4. 4Once approved, your wallet address will appear in the navbar and your portfolio data will load.

The dashboard is your central hub for monitoring all trading activity. Once your wallet is connected, you will see several key sections:

• Bot Status Card— Shows whether automated trading is active or paused, along with today's key stats (trades, volume, P&L, win rate).
• Portfolio Chart — A visual representation of your portfolio performance over time, with 1-day, 1-week, and 1-month views.
• Session Key Panel — Displays the status of your active session key and remaining time.
• Live Activity Feed — Real-time log of all bot actions including trades, alerts, and wallet syncs.
• AI Intelligence — Shows the current AI market bias (bullish/bearish) and confidence level.
• Status Metrics — Bottom bar showing security score, execution latency, gas savings, and network health.

AbuBeast fetches your portfolio data directly from the Solana blockchain using your connected wallet address. Here is how it works:

How We Fetch Wallet Data

When you connect your wallet, AbuBeast queries the Solana RPC endpoint to retrieve your token accounts, SOL balance, and recent transaction history. This data is read-only — we never request write access unless you authorize a trade.

1. 1Your wallet public key is sent to our backend via a secure HTTPS connection.
2. 2We query the Solana RPC node (Mainnet-Beta by default) for all token accounts associated with your address.
3. 3Token balances are fetched along with current market prices from on-chain price oracles (Pyth, Switchboard).
4. 4Portfolio allocation is calculated as dollar value of each token divided by total portfolio dollar value.

Portfolio Allocation Calculation

Portfolio allocation shows what percentage of your total holdings each token represents. The formula is straightforward:

For example, if you hold 10 SOL worth $1,500 and your total portfolio is worth $5,000, your SOL allocation would be 30%. This is recalculated every time prices update, giving you a real-time view of how your funds are distributed.

Historical Portfolio Allocation

AbuBeast tracks your portfolio allocation over time by taking periodic snapshots. These snapshots are stored securely and allow you to see how your allocation has changed — for example, whether you have been gradually increasing your SOL position or diversifying into other tokens. You can view historical allocation data in 1-day, 1-week, and 1-month intervals from the Portfolio Chart section.

Understanding your profit and loss (P&L) is essential to evaluating your trading performance. AbuBeast calculates P&L at multiple levels:

Per-Trade P&L

For each trade executed by the bot, we calculate the P&L by comparing the entry price with the exit price, accounting for fees and slippage:

Daily P&L

Daily P&L is the sum of all individual trade P&Ls for the day, plus any unrealized gains or losses from open positions. This is what you see in the "P&L Today" metric on the dashboard.

Historical P&L

Historical P&L tracks your cumulative profit and loss over time. AbuBeast stores daily snapshots of your portfolio value, allowing you to see your total returns over any period. The historical P&L chart on the dashboard shows your portfolio value trajectory, making it easy to identify trends and evaluate long-term performance.

Unrealized vs Realized P&L

Realized P&L comes from completed trades where you have already bought and sold. Unrealized P&L is the current profit or loss on tokens you still hold, based on current market prices. The dashboard shows both so you always know your complete financial picture.

AbuBeast provides several performance metrics to help you evaluate how well your trading strategies are working:

• Win Rate — The percentage of trades that were profitable. Calculated as: (Winning Trades / Total Trades) × 100.
• Average Return per Trade — The mean P&L across all trades, giving you an idea of typical trade performance.
• Sharpe Ratio — Measures risk-adjusted returns. A higher Sharpe ratio means better returns relative to the risk taken. Calculated as: (Average Return - Risk-Free Rate) / Standard Deviation of Returns.
• Max Drawdown — The largest peak-to-trough decline in your portfolio value, showing your worst-case scenario during a given period.
• Total Volume — The total USD value of all trades executed by the bot.
• Execution Latency — Average time from trade signal to on-chain confirmation, measured in milliseconds.

Historical Performance Metrics

All performance metrics are tracked historically. You can view how your win rate, Sharpe ratio, and other metrics have changed over time. This helps you understand whether your strategies are improving or if adjustments are needed. Historical data is available in daily, weekly, and monthly granularity.

Managing risk is just as important as generating returns. AbuBeast provides comprehensive risk analysis:

• Value at Risk (VaR) — Estimates the maximum potential loss over a given time period at a specific confidence level (typically 95%). For example, a 1-day VaR of $500 at 95% confidence means there is only a 5% chance of losing more than $500 in a day.
• Volatility — Measures how much your portfolio value fluctuates. Higher volatility means higher risk but also potentially higher returns.
• Beta— Measures your portfolio's sensitivity to overall Solana market movements. A beta of 1.0 means your portfolio moves in line with SOL. Greater than 1.0 means more volatile than the market.
• Max Drawdown Duration — How long it took to recover from the worst drawdown, helping you understand potential recovery timelines.
• Sortino Ratio — Similar to Sharpe ratio but only considers downside volatility, giving a more accurate picture of risk-adjusted returns for strategies with asymmetric return distributions.

Historical Risk Analysis

Risk metrics are computed using rolling windows of historical data. AbuBeast recalculates these daily and stores the results, allowing you to see how your portfolio's risk profile has evolved over time. You can view historical risk data across daily, weekly, and monthly timeframes to identify trends and make informed decisions about your risk tolerance.

Diversification helps reduce risk by spreading your investments across different tokens. AbuBeast measures diversification using several approaches:

Concentration Score

We calculate a concentration score using the Herfindahl-Hirschman Index (HHI). A lower score indicates better diversification:

Correlation Analysis

True diversification isn't just about holding many tokens — it's about holding tokens that don't move in the same direction at the same time. AbuBeast analyzes the price correlation between your held tokens. Tokens with low correlation provide better diversification benefits than tokens that tend to rise and fall together.

Historical Diversification Tracking

AbuBeast tracks your diversification score over time, so you can see whether your portfolio is becoming more or less diversified. This is especially useful when the bot is actively trading — you can verify that the strategies are maintaining appropriate diversification levels. Historical diversification data includes both the HHI concentration score and pairwise correlation metrics, available across all standard timeframes.

AbuBeast maintains comprehensive historical records of all your trading data and portfolio metrics. Here is a summary of all historical data available:

All historical data is accessible from the dashboard charts using the time period selectors (1D, 1W, 1M). The data is stored securely and associated with your account, so it persists across sessions and devices.

AbuBeast offers several pre-built trading strategies, each designed for different market conditions and risk appetites:

You can activate or deactivate strategies from the Strategies page. Only one strategy can be active at a time. Each strategy shows its 30-day historical PnL so you can compare performance before choosing.

Session keys are a core security feature of AbuBeast. They allow the bot to sign transactions on your behalf without requiring manual approval for each trade, while still maintaining strict limits on what the bot can do.

How Session Keys Work

1. 1When you authorize a session, a temporary keypair is generated.
2. 2You grant this keypair limited permissions — such as the ability to trade or swap tokens.
3. 3The bot uses this keypair to sign transactions within the limits you set (daily spending limit, max slippage).
4. 4The session key expires after the time limit you configure, or you can revoke it manually at any time.
5. 5Withdrawal access is always disabled for session keys — the bot can never transfer tokens out of your wallet.

The Terminal provides a command-line interface for advanced users who prefer direct interaction with the AbuBeast engine. Available commands include:

The terminal output is color-coded: green for system messages, cyan for your input, and white for command output. All commands are executed securely through the same API that powers the dashboard.

The Settings page lets you customize your AbuBeast experience:

• Notifications — Toggle push notifications, trade alerts, and price alerts on or off.
• Network — Choose your preferred RPC endpoint (Mainnet-Beta, Devnet, or a custom RPC URL).
• Security — Enable two-factor authentication and manage active login sessions.

All settings are saved to your account and will persist across devices and sessions. Changes take effect immediately after clicking "Save Settings".