You spot a honeypot token on trending. The chart looks perfect—steady climb, healthy volume. Your users buy in. When they try to sell, nothing happens. The contract blocks all sells except for the developer’s wallet. $3.2 million locked forever. This guide shows you how to screen tokens before your users get burned.Documentation Index
Fetch the complete documentation index at: https://docs.webacy.com/llms.txt
Use this file to discover all available pages before exploring further.
Why Token Screening Matters
Honeypot Detection
Block tokens that won’t let users sell
Tax Analysis
Expose hidden buy/sell taxes before users swap
Rug Risk Assessment
Identify concentrated holdings and suspicious patterns
- Contract security analysis — Detect honeypots, malicious functions, and rug mechanics
- Hidden tax detection — Find buy/sell taxes hidden in contract code
- Holder concentration — Identify tokens where insiders hold most supply
- Liquidity analysis — Assess pool depth and rug pull indicators
- Trading Lite API — Sub-second screening for real-time user protection
- Multi-chain support — ETH, Solana, Base, Arbitrum, BSC, and more
Prerequisites
Before implementing token screening, ensure you have:- A Webacy API key (sign up here)
- Basic familiarity with REST APIs or the Webacy SDK
- Your swap interface’s token selection and pre-swap flows identified
Token Listing Due Diligence
Screen tokens before they appear on your platform.Contract Security Analysis
Get a comprehensive security analysis of any token contract.| Field | Description | Red Flag |
|---|---|---|
isHoneypot | Contract blocks sells | Block immediately |
overallRisk | 0-100 risk score | > 70 requires review |
vulnerabilities[] | Security issues found | Any critical severity |
hasProxyContract | Contract is upgradeable | Hidden risk |
Hidden Tax Detection
Many scam tokens hide excessive taxes that steal from users on every transaction.| Tax Level | Recommendation |
|---|---|
| 0-5% | Normal range |
| 5-10% | Show warning to users |
| 10-25% | Strong warning + require confirmation |
| > 25% | Block or hide token |
Holder Concentration Analysis
Identify tokens where insiders control most of the supply.| Metric | Red Flag Threshold | What It Means |
|---|---|---|
| Top 10 % | > 80% | Insiders can dump |
| Sniper count | > 10 | Coordinated buying at launch |
| Bundler count | > 3 | Multiple wallets acting as one |
| Dev wallet % | > 20% | Developer can rug |
Real-Time User Warnings
Screen tokens in real-time when users try to swap.Pre-Swap Screening
Check tokens before users execute swaps.Trading Lite for Speed
For high-volume DEXes, use Trading Lite for sub-second token screening.Liquidity Analysis
Check if there’s enough liquidity to actually execute trades.Pool Data
| Liquidity | Risk Level | User Guidance |
|---|---|---|
| > $100k | Low | Normal trading |
| 100k | Medium | Warn about slippage |
| 10k | High | Strong slippage warning |
| < $1k | Critical | May be rug pull or dead token |
Rug Pull Indicators
Combine multiple signals to detect potential rug pulls.Complete Integration Workflow
Token Listing Flow
Pre-Swap User Warning Flow
Full TypeScript Implementation
Complete DEX Token Screening Module
Complete DEX Token Screening Module
Example Tokens for Testing
Known Honeypots
| Address | Chain | Description |
|---|---|---|
| Test with newly deployed tokens on testnets | - | Honeypots are constantly being deployed |
High Tax Tokens
| Address | Chain | Description |
|---|---|---|
| Various “reflection” or “rebase” tokens | - | Often have hidden mechanics |
Safe Tokens (for comparison)
| Address | Chain | Description |
|---|---|---|
0xdAC17F958D2ee523a2206206994597C13D831ec7 | ETH | USDT - no tax, high liquidity |
0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 | ETH | USDC - verified, safe |
0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599 | ETH | WBTC - established token |
Testing tip: For honeypot and tax testing, use tokens you find in real-time on DEX trending lists. Scam tokens are deployed constantly, so the best test data is fresh data.
API Quick Reference
| Endpoint | Use Case | Response Time |
|---|---|---|
GET /contracts/{address} | Contract analysis | ~500ms |
GET /contracts/{address}/tax | Tax detection | ~300ms |
GET /holder-analysis/{address} | Holder distribution | ~400ms |
GET /tokens/{address}/pools | Liquidity pools | ~300ms |
GET /trading-lite/{address} | Quick analysis (SOL) | ~200ms |
Next Steps
Get Your API Key
Start screening tokens today
API Reference
Complete endpoint documentation
Honeypots Explained
Deep dive on honeypot mechanics
Trading Client SDK
SDK for holder analysis
