Finds the highest-yield DeFi opportunities for any token across 119 chains and thousands of protocols. Compares lending rates, LP APYs, and staking yields side by side with safety filters built in.
Completes the four-skill workflow with Smart Money Tracker, Token Safety Scanner, and Cross-Chain DEX Price Scanner.
pip install requests
# Find best yield for a token
python main.py --token USDC
# Single-asset only (no LP pairs)
python main.py --token USDC --single-only
# Filter by chain
python main.py --token ETH --chains ethereum,arbitrum,base
# Compare one protocol across all chains
python main.py --token USDC --compare aave-v3
# Scan all major stablecoins at once
python main.py --scan-stablecoins
# Scan Binance Alpha tokens
python main.py --scan-alpha
# JSON output
python main.py --token USDC --jsonSearches 19,000+ DeFi pools and returns the top opportunities for your token, ranked by APY with safety filters applied.
# Protocol Chain APY Base Reward TVL Risk
1 Venus BSC 4.80% 3.20% 1.60% $320.0M LOW
2 Morpho-Aave Ethereum 4.52% 4.52% -- $890.5M LOW
3 Aave V3 Arbitrum 4.15% 3.10% 1.05% $1.2B LOW
4 Compound V3 Ethereum 3.85% 3.85% -- $650.0M LOW
5 Moonwell Base 5.20% 2.80% 2.40% $45.0M MEDIUM
- TVL > $1M — minimum liquidity depth
- APY < 100% — filters out unsustainable farms
- Risk classification: LOW / MEDIUM / HIGH based on TVL + protocol track record
The scanner splits every APY into two components:
- Base APY: from lending interest or trading fees — sustainable
- Reward APY: from token incentives — may decrease or end
Compare the same protocol across all chains to find the best chain to deposit on.
Protocol: Aave V3 | Token: USDC
Chain APY Base Reward TVL
Arbitrum 4.15% 3.10% 1.05% $1.2B
Optimism 3.92% 3.00% 0.92% $180.5M
Ethereum 3.50% 2.50% 1.00% $1.5B
One-shot scan of all major stablecoins — best opportunity per token.
# Token Protocol Chain APY TVL Risk
1 GHO Sky Ethereum 6.20% $180.0M MEDIUM
2 USDC Venus BSC 4.80% $320.0M LOW
3 DAI Spark Ethereum 4.50% $1.1B LOW
All 119 chains tracked by DefiLlama, including Ethereum, BSC, Arbitrum, Base, Polygon, Optimism, Avalanche, Solana, and more.
defi-yield-scanner/
├── adapters/
│ └── defillama.py # DefiLlama Yields API (free, no auth, ~19K pools)
├── scanner/
│ ├── token_filter.py # Filter pools by token symbol
│ ├── safety_filter.py # TVL + APY filters + risk classification
│ ├── yield_ranker.py # Sort by APY + enrich with risk tier
│ ├── cross_chain_compare.py # Same protocol across different chains
│ └── batch_scanner.py # Stablecoin + Binance Alpha batch scan
├── main.py # CLI entry point
├── SKILL.md # AI agent skill definition
└── tests/
└── test_scanner.py
Pool data is cached locally for 30 minutes (DefiLlama updates hourly).
| Source | Auth | Used For |
|---|---|---|
| DefiLlama Yields API | None | All yield pool data (19K+ pools, 119 chains) |
| Binance Alpha List | None | Batch scan token list |
All free, no API keys required.
pip install pytest
python -m pytest tests/ -v- APY changes in real time — always verify current rates on the protocol website before depositing
- Reward APY may end — token incentives can be reduced or stopped at any time
- LP pools carry impermanent loss risk — use
--single-onlyto exclude LP pairs
Smart Money Tracker Token Safety Scanner DEX Price Scanner DeFi Yield Scanner
find what whales --> verify it's safe --> find cheapest --> earn the highest
are buying to buy chain to buy on yield after buying
For informational purposes only. Not financial advice. APY data sourced from DefiLlama and may be delayed or inaccurate. Always do your own research (DYOR).
MIT