Getting Started
Dashboard Guides
Trading Guides
Need Help?
Join our community for support, updates, and trading discussions.
Filtering System
Intelligent multi-criteria filtering system that analyzes market data, security risks, and token metrics to identify high-quality trading opportunities.
Overview
The filtering engine continuously evaluates discovered tokens against multiple criteria from DexScreener, GeckoTerminal, and Rugcheck. Only tokens passing all configured filters are marked as tradeable candidates.
All-or-Nothing Logic: A token must pass EVERY active filter. If even one filter fails, the token is rejected. This ensures only high-quality, safe tokens are available for trading.
How Filtering Works
Filter Pipeline
Token Discovered
New token found by one of 6 discovery sources
Data Enrichment
Fetch market data (DexScreener/GeckoTerminal) and security info (Rugcheck)
Parallel Evaluation
All 3 filter sources checked simultaneously (24 tokens at once for speed)
All-Must-Pass Logic
If ANY filter fails → Token rejected. Only tokens passing every single filter advance.
Pass or Reject
Token marked as tradeable (passed) or blocked (rejected with specific reasons)
Continuous Re-evaluation
Passed tokens continuously monitored - can become rejected if metrics worsen
Example: Token Rejection
A token is discovered on DexScreener. The filtering engine fetches data and evaluates it:
Liquidity: $50k (Pass)
Mint Auth: Enabled (Fail)
Volume: $100k (Pass)
Result: REJECTED (Failed Rugcheck)
Filter Sources
Each source evaluates different aspects of token quality. All sources must approve for a token to pass.
DexScreener
Market data filters
- •Minimum liquidity (SOL/USD)
- •24h volume thresholds
- •Price change limits (5m, 1h, 6h, 24h)
- •Market cap range
- •Pair type (SOL pairs only)
GeckoTerminal
Verified data filters
- •Pool age minimum
- •Trading volume 24h
- •Price volatility limits
- •Liquidity stability
Rugcheck
Security filters
- •Mint authority status
- •Freeze authority status
- •Top holder concentration (%)
- •Overall security score
- •Known risk patterns
Filter Results
Passed Tokens
Tokens meeting all filter criteria
- •Available for manual trading immediately
- •Eligible for automated trading (if enabled)
- •Displayed in "Passed Tokens" dashboard tab
- •Continuously re-evaluated
- •Can lose "passed" status if criteria change
Rejected Tokens
Tokens failing one or more criteria
- ×Not available for automated trading
- ×Can still be traded manually (with warning)
- ×Displayed in "Rejected Tokens" tab with reasons
- ×Re-evaluated periodically
- ×Can become "passed" if metrics improve
Common Rejection Reasons
Market Criteria
- • Liquidity too low (< minimum threshold)
- • Volume insufficient (24h volume < min)
- • Price too volatile (change % exceeds limit)
- • Market cap outside acceptable range
- • Wrong pair type (not SOL-paired)
Security Criteria
- • Mint authority not renounced
- • Freeze authority active
- • Top holder concentration too high
- • Low security score from Rugcheck
- • Known scam patterns detected
Dashboard Features
Real-Time Filtering Interface
View all tokens currently passing filters with live prices, volume, and quick-buy actions
See rejected tokens with specific reasons (liquidity, security, volume, etc.)
Total discovered, passed, rejected counts with pass rate percentage
Auto-refresh every 30s to show latest filter results
Adjusting Filters
Filter criteria can be adjusted through the Dashboard's Configuration UI or by editing the configuration file directly.
Via Dashboard (Recommended)
Navigate to Dashboard → Configuration → Filtering for an intuitive interface with descriptions and validation.
Via Configuration File
Advanced users can manually edit data/config.toml under the [filtering] section. See Config File Reference for details.
Note: Changes take effect immediately. Start with strict filters and gradually relax them as you observe results.
Best Practices
- •Start Conservative: Use strict filters initially, then gradually relax
- •Monitor Rejections: Check rejected tokens to see if filters are too strict
- •Security First: Never disable security filters to find more tokens
- •Test Changes: Adjust one filter at a time and observe results
- •Track Performance: Analyze which filters correlate with profitable trades