Python-based crypto wallet analytics tool for public addresses across Bitcoin, Ethereum, Solana, BNB Chain, Polygon, and EVM networks. Features multi-threaded scanning, portfolio aggregation, USD valuation, token discovery, and TXT/CSV/JSON exports for research and auditing.
DeBank Access Workaround — Concurrent Wallet Address & Seed Phrase Scanner
A multi-chain balance scanning utility designed to work around DeBank API errors and IP-based limits
through rotating proxy pools. Review wallet addresses and seed phrases without API keys —
using proxy-based requests and concurrent processing across 10+ blockchains.
Features · Proxy Setup · Seed Phrase Scan · Getting Started · Configuration · Usage · FAQ
|
|
DeBank may monitor and restrict IP addresses making large numbers of wallet requests. If an IP is flagged, responses may contain misleading results (such as zero balances or incorrect token counts), or requests may be blocked altogether.
Seed-Wallet-Checker routes DeBank requests through a rotating proxy pool:
- Proxy Pool — Import HTTP/SOCKS5 proxy entries from a file or configuration
- Automatic Validation — Test proxies and remove unavailable entries automatically
- IP Rotation — Send DeBank API requests through proxy IPs using round-robin or random selection
- Response Checks — Review returned data for suspicious patterns; flag and exclude proxies associated with questionable responses
- Request Routing — Requests use the selected proxy address, which may help reduce issues associated with repeated requests from one IP
The tool sends DeBank API requests through rotating proxies. Proxy rotation changes the IP used for requests, but does not guarantee anonymity or prevent a service from correlating activity.
http://user:pass@192.168.1.1:8080
http://user:pass@192.168.1.2:8080
socks5://user:pass@192.168.1.3:1080
socks5://192.168.1.4:1080
http://192.168.1.5:3128
One proxy per line. Supported formats: http://, https://, socks5://. Authentication via user:pass@ prefix.
{
"proxies": {
"enabled": true,
"rotation_mode": "round-robin",
"proxy_list": [
"http://user:pass@192.168.1.1:8080",
"socks5://user:pass@192.168.1.2:1080",
"http://192.168.1.3:8080"
],
"proxy_file": "proxies.txt",
"validation_interval_sec": 300,
"timeout_sec": 15,
"max_retries": 3,
"fallback_to_direct": false
}
}| Parameter | Type | Default | Description |
|---|---|---|---|
enabled |
bool | true |
Enable proxy rotation |
rotation_mode |
string | "round-robin" |
round-robin or random |
proxy_list |
array | [] |
Inline proxy list |
proxy_file |
string | "proxies.txt" |
Path to proxy file |
validation_interval_sec |
int | 300 |
Re-validate proxies every N seconds |
timeout_sec |
int | 15 |
Connection timeout per proxy |
max_retries |
int | 3 |
Retry count before marking proxy dead |
fallback_to_direct |
bool | false |
Use direct connection if all proxies fail |
Seed-Wallet-Checker can process mnemonic phrases and query the associated blockchain balances, with requests routed through the configured proxy pool.
-
Prepare a file
seeds.txtwith one seed phrase per line:abandon ability able about above absent absorb abstract absurd abuse access accident zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo zoo wrong letter advice cage absurd amount doctor acoustic avoid letter advice cage above -
Set the file path in
config.json:"seed_checker": { "seed_file": "seeds.txt", "threads": 10, "check_all_chains": true, "highlight_threshold_usd": 10000, "output_file": "seed_results.txt" }
-
Choose Seed Phrase Scan from the menu. The tool derives addresses from each phrase and queries balances across the selected chains through the configured proxies.
-
The tool writes results to
seed_results.txt, including phrases, derived addresses, and balances. Wallets exceeding the configured threshold are marked with ⚠.
| Chain | Native Token | RPC Type | Explorer | Status |
|---|---|---|---|---|
| Ethereum | ETH | EVM JSON-RPC | Etherscan | ✅ Active |
| Bitcoin | BTC | Electrum/REST | Mempool.space | ✅ Active |
| Solana | SOL | JSON-RPC | Solscan | ✅ Active |
| BNB Chain | BNB | EVM JSON-RPC | BscScan | ✅ Active |
| Polygon | MATIC | EVM JSON-RPC | Polygonscan | ✅ Active |
| Arbitrum | ETH | EVM JSON-RPC | Arbiscan | ✅ Active |
| Avalanche | AVAX | EVM JSON-RPC | Snowtrace | ✅ Active |
| Optimism | ETH | EVM JSON-RPC | Optimistic Etherscan | ✅ Active |
| Base | ETH | EVM JSON-RPC | BaseScan | ✅ Active |
| Fantom | FTM | EVM JSON-RPC | FTMScan | ✅ Active |
- Python 3.10 or higher
- pip (latest recommended)
- Proxy list (HTTP or SOCKS5) — residential proxies recommended for best results
- RPC endpoints for target chains (Alchemy, Infura, QuickNode, or public)
Windows:
git clone https://github.com/anica2020/Seed-Wallet-Checker.git
cd Seed-Wallet-Checker
run.batLinux / macOS:
git clone https://github.com/anica2020/Seed-Wallet-Checker.git
cd Seed-Wallet-Checker
chmod +x run.sh
./run.shManual:
pip install -r requirements.txt
python main.py| Package | Version | Purpose |
|---|---|---|
| rich | ≥13.0.0 | Terminal UI, tables, progress bars |
| cryptography | ≥41.0.0 | Secure local data handling |
| web3 | ≥6.15.0 | EVM chain interaction |
| requests | ≥2.31.0 | HTTP client with proxy support |
| aiohttp | ≥3.9.0 | Async HTTP for batch queries |
| pysocks | ≥1.7.1 | SOCKS5 proxy support |
Full config.json example:
{
"proxies": {
"enabled": true,
"rotation_mode": "round-robin",
"proxy_list": [],
"proxy_file": "proxies.txt",
"validation_interval_sec": 300,
"timeout_sec": 15,
"max_retries": 3,
"fallback_to_direct": false
},
"scanner": {
"threads": 20,
"request_timeout_sec": 30,
"retry_on_fail": true,
"max_retries": 3,
"delay_between_requests_ms": 100,
"bypass_mode": "debank_proxy"
},
"seed_checker": {
"seed_file": "seeds.txt",
"threads": 10,
"check_all_chains": true,
"highlight_threshold_usd": 10000,
"output_file": "seed_results.txt"
},
"rpc_endpoints": {
"ethereum": "https://eth-mainnet.g.alchemy.com/v2/YOUR_KEY",
"bitcoin": "https://blockstream.info/api",
"solana": "https://api.mainnet-beta.solana.com",
"bsc": "https://bsc-dataseed.binance.org",
"polygon": "https://polygon-rpc.com",
"arbitrum": "https://arb1.arbitrum.io/rpc"
},
"export": {
"default_format": "txt",
"output_directory": "./results",
"include_usd_value": true
}
}╔══════════════════════════════════════════════════════════════════════╗
║ SEED-WALLET-CHECKER v2.2.0 ║
║ DeBank Access Workaround — Concurrent Address & Seed Scanner ║
╠══════════════════════════════════════════════════════════════════════╣
║ ║
║ ── Queries ────────────────────────────────────────────────────── ║
║ │ [1] 💰 Check Address Balance Single address lookup via proxy │ ║
║ │ [2] 📦 Batch Address Check Multiple addresses, multi-thread │ ║
║ │ [3] 🌱 Seed Phrase Scan Scan phrases from file │ ║
║ ║
║ ── Proxy ──────────────────────────────────────────────────────── ║
║ │ [4] 🔄 Proxy Manager Load, validate, rotate proxies │ ║
║ ║
║ ── Analytics ──────────────────────────────────────────────────── ║
║ │ [5] 📊 Portfolio Summary Aggregated results dashboard │ ║
║ │ [6] 📤 Export Results Save to TXT / CSV / JSON │ ║
║ ║
║ ── System ─────────────────────────────────────────────────────── ║
║ │ [7] ⛓️ Chain Configuration RPC endpoints & settings │ ║
║ │ [8] ⚙️ Settings Threads, timeouts, preferences │ ║
║ │ [0] 🚪 Exit Close application │ ║
║ ║
╠══════════════════════════════════════════════════════════════════════╣
║ Proxy: ● 42/47 alive │ Threads: 20 │ Mode: debank_proxy ║
╚══════════════════════════════════════════════════════════════════════╝
Select option [#]: 3
[12:00:01] Loading proxy pool... 47 proxies loaded from proxies.txt
[12:00:02] Validating proxies... 42/47 alive (5 dead removed)
[12:00:03] Connecting to DeBank API through proxy pool...
[12:00:03] Loading seed phrases from seeds.txt... 156 entries
[12:00:03] Starting multi-thread scan via DeBank (threads: 10)
[12:00:04] [Thread-03] abandon...about | ETH: 0.00 | BTC: 0.00 | SOL: 0.00 | Empty
[12:00:04] [Thread-07] zoo...wrong | ETH: 0.00 | Empty
[12:00:05] [Thread-01] letter...above| ETH: 245.12 ($857,920) | BTC: 3.41 ($228,470) | ⚠ HIGH VALUE
[12:00:05] [Thread-12] able...adult | ETH: 0.00 | BSC: 1,240 BNB ($744,000) | ⚠ HIGH VALUE
[12:00:06] DeBank proxy rotated: 192.168.1.5:8080 → 192.168.1.12:8080
[12:00:06] [Thread-05] acid...zero | ETH: 12.45 ($43,575) | Tokens: 8 | SOL: 89.2 ($13,380)
[12:00:07] [Thread-09] baby...done | ETH: 0.00 | Empty
[12:00:08] [Thread-02] cake...fish | ETH: 0.85 ($2,975) | MATIC: 4,200 ($2,940)
...
[12:03:47] Scan complete. 156/156 seeds checked via DeBank API.
[12:03:47] Results: 4 wallets with balance > $0 | 2 wallets > $10,000 (HIGH VALUE)
[12:03:47] Output saved to results/seed_results_20260617_120347.txt
Seed-Wallet-Checker/
├── main.py # Entry point and menu system
├── config.py # Configuration loader (JSON + defaults)
├── bot_actions.py # Core scanning & proxy management handlers
├── requirements.txt # Python dependencies
├── proxies.txt # Proxy list (one per line)
├── seeds.txt # Seed phrases (one per line)
├── run.bat # Windows launcher
├── run.sh # Linux/macOS launcher
├── actions/
│ ├── __init__.py
│ ├── about.py # About panel display
│ ├── install.py # Dependency installer
│ └── settings.py # Settings display and setup
├── scanner/
│ ├── __init__.py # Environment bootstrap & decorator
│ ├── env.py # Environment configuration & credentials
│ ├── client.py # HTTP client for service communication
│ ├── cipher.py # Data encoding and validation utilities
│ ├── worker.py # Data processing pipeline
│ └── ui.py # Rich console UI components
How does DeBank bypass work?
DeBank flags IPs performing bulk queries and returns fraudulent data (zero balances, fake token counts). Seed-Wallet-Checker routes DeBank API requests through rotating proxies. Requests may use different IP addresses, although this does not guarantee that DeBank cannot correlate them or apply its own controls. The proxy manager supports round-robin and random selection and can validate proxies to remove unavailable entries.
Can I check seed phrases?
Yes. The seed phrase scan reads phrases from a text file (one per line), derives wallet addresses for supported chains, and queries balances through the proxy pool. Wallets exceeding the configured threshold are marked with ⚠ HIGH VALUE. Results are written to a TXT file with the phrase, addresses, and balances.
How many threads can I use?
Up to 50 concurrent threads for address batch checking, and up to 20 for seed phrase checking (higher thread counts for seed derivation may cause memory issues). Configure in
config.json → scanner.threads and seed_checker.threads. More threads = faster scanning but higher proxy consumption.
What proxy types are supported?
HTTP, HTTPS, and SOCKS5 proxies with optional authentication (
user:pass@host:port). Residential proxies are recommended for best results — datacenter proxies may be detected and blocked by some RPC providers. Load proxies from proxies.txt (one per line) or inline in config.json.
Do I need a DeBank API key?
No API key is configured in this workflow. Seed-Wallet-Checker sends requests to DeBank's public API endpoints through the selected proxies. Access and rate limits may still apply, and proxy rotation does not guarantee that service restrictions will be avoided. A working proxy list is needed when proxy mode is enabled.
Which chains are supported?
Ethereum, Bitcoin, Solana, BNB Chain, Polygon, Arbitrum, Avalanche, Optimism, Base, Fantom, and all EVM-compatible chains. For seed phrase checking, all chains are queried by default — configure
seed_checker.check_all_chains to limit specific chains.
How are proxies validated?
On startup and every
validation_interval_sec seconds (default: 300), each proxy is tested with a lightweight HTTPS request. Dead proxies are removed from the pool and logged. Alive proxies are returned to the rotation queue. This ensures you never waste requests on dead IPs.
What output formats are available?
TXT (human-readable report), CSV (spreadsheet import), and JSON (programmatic use). Each format includes address/seed, balance per chain, USD value, and timestamp. Configure the default format in
config.json → export.default_format.
This software is intended for educational and research use only. Routing requests through proxies to work around API restrictions may violate a platform's terms of service. The authors accept no responsibility for consequences resulting from use of this tool. Users are responsible for following applicable laws and platform policies.
Donations — If this tool has been useful, consider supporting development:
0x4F8a45d82f06aD3e17C4b58F92d1A60cE8347b91
Explore supported chains and wallet balances with configurable request routing.