How ScreenerBot Works

ScreenerBot is an automated Solana trading system that continuously discovers new tokens, filters them based on your criteria, and executes trades according to your strategy. Think of it as a 24/7 trading assistant that never sleeps.

The Trading Pipeline

From discovery to exit, here's how ScreenerBot processes every trading opportunity:

Token Discovery

Bot monitors multiple market feeds and on-chain signals to find newly launched tokens in real-time.

Security Analysis

Checks RugCheck scores, mint/freeze authority status, and filters out known scams and risky tokens before any analysis.

Filtering Engine

Applies your configured filters (market cap, liquidity, volume, holders, etc.) to identify trading opportunities from secure tokens.

Price Monitoring

Fetches on-chain pool data across major Solana DEX ecosystems, calculates SOL prices, and tracks liquidity for accurate real-time pricing.

Trade Execution

For tokens that pass filters, evaluates your trading strategy and decides whether to enter a position.

Position Management

Monitors open positions, tracks P&L, and executes exits based on your configured strategies, ROI targets, stop-loss, trailing stops, or custom exit conditions.

Core Systems

Six major systems work together to automate your trading:

Discovery System

Continuously monitors token launches from multiple sources

Leading Solana market feeds
On-chain activity detection

Pool Pricing System

Calculates accurate SOL prices from on-chain data

Supports major Solana DEXs
Continuous price refreshes

Filtering Engine

Multi-criteria token evaluation

Market cap & liquidity thresholds
Trading volume requirements
Security score minimums

Auto Trader

Automated position entry and exit

Strategy-based entry decisions
Custom exit strategies (configurable in Dashboard)
ROI targets, stop-loss & trailing stops

Position Manager

Tracks all trading positions

Real-time P&L calculation
DCA entry support
Partial exit handling

Swap Router

Intelligent trade execution

Jupiter aggregator integration
GMGN fast routing
Automatic best-price selection

Data Flow

Input Sources

Market APIs: Multiple Solana analytics feeds
Security Data: Risk-scoring providers
On-Chain: Solana RPC for pools & balances
WebSocket: Real-time transaction monitoring
User Config: Your trading parameters

Data Storage

Tokens: Metadata, market data, security info
Positions: Entry/exit records, P&L tracking
Transactions: All swap history
OHLCV: Price charts & historical data
Events: System events & notifications

Output Channels

Dashboard: Real-time UI updates via REST API
Notifications: Desktop alerts for events
Blockchain: Swap transactions to Solana
Logs: Detailed event logging

Key Design Principles

Single Source of Truth

All prices come from on-chain pool data, not third-party APIs. This ensures accuracy and prevents trading on stale or manipulated prices.

Real-Time Processing

Token discoveries, price updates, and position monitoring happen continuously in background threads, ensuring you never miss opportunities.

Safety First

Multiple safety checks before trades: security screening, balance verification, liquidity validation, and price deviation detection.

Full Observability

Every action is logged and tracked. Events system records discoveries, trades, errors, and system state changes for complete transparency.

Highly Configurable

Every aspect of trading behavior can be customized: filters, strategies, risk management, DCA settings, exit rules, and more.

Comprehensive Monitoring

Service health checks, performance metrics, connectivity monitoring, and event logging ensure you always know the system status.

SOL-Based Trading

Native SOL Architecture

ScreenerBot uses SOL as the base currency for all trading operations

All prices in SOLToken prices, P&L, and investments are measured in SOL for consistency.
Both pair types supportedHandles SOL/TOKEN and TOKEN/SOL pools automatically.

Highest liquidityWhen multiple pools exist, the highest SOL liquidity pool is selected.
Simplified accountingSingle currency eliminates complexity and conversion errors.

Why SOL-based?Most new Solana tokens launch with SOL pairs first. Using SOL as the base currency simplifies pricing, reduces RPC calls, and aligns with native Solana ecosystem practices.