🪐 Smart Wallet Terminal
Track influencers, smart-money wallets, top profit leaders, and whales from one animated terminal dashboard.
Features •
Quick Start •
Controls •
Project Structure •
Guides •
Disclaimer
📟 Overview
** Smart Wallet Terminal** is a Python terminal application that transforms 's smart-money wallet feeds into a live, keyboard-controlled market intelligence dashboard.
The interface is designed around the visual language of professional financial terminals:
- High-density wallet tables
- Bright market-status colors
- Animated loading and printing effects
- Live profit-and-loss indicators
- Wallet ranking and activity analysis
- Fast keyboard navigation
- Automatic data synchronization
- Compact 24-hour market statistics
The project is intended for wallet discovery, market research, activity monitoring, and educational analysis. It is not a trading bot and does not execute transactions.
✨ Features
🧠 Four Wallet Intelligence Channels
| Channel | API Category | Purpose |
|---|---|---|
| Influencers | influencer |
Tracks wallets associated with public social identities |
| Smart Money | smartMoney |
Surfaces wallets classified as sophisticated market participants |
| Top PNL | topPnl |
Ranks wallets by recent realized or calculated profit performance |
| Whales | whale |
Highlights large and highly active market participants |
📊 Live Terminal Metrics
The dashboard displays:
- Wallet rank
- Twitter or X username when available
- Shortened wallet address
- 24-hour PNL in USD
- 24-hour trading volume
- Transaction count
- Win rate
- Last activity time
- Aggregate channel PNL
- Aggregate volume
- Aggregate transactions
- Average win rate
- PNL distribution sparkline
- API cache timestamp
- Current sorting mode
- Search filter state
- Synchronization status
⚡ Interactive Experience
- Parallel API requests across all four categories
- Non-blocking terminal rendering
- Automatic refresh every 45 seconds
- Manual refresh support
- Animated boot sequence
- Progressive status-message printing
- Progressive wallet-row reveal
- Keyboard-only navigation
- Full-screen alternate terminal interface
- Responsive page sizing based on terminal height
- Positive and negative PNL color separation
- Windows and Unix-like keyboard support
🖥️ Terminal Preview
╔══════════════════════════════════════════════════════════════════════════════╗
║ SMART WALLET TERMINAL ◆ ● LIVE 2026-09-10 12:42 ║
╚══════════════════════════════════════════════════════════════════════════════╝
[1 INFLUENCERS] 2 SMART MONEY 3 TOP PNL 4 WHALES SORT PNL
┌─ 24H INFLUENCERS MARKET PULSE ───────────────────────────────────────────────┐
│ NET PNL VOLUME TRANSACTIONS AVG WIN RATE DISTRIBUTION │
│ \$184.32K \$2.91M 8,421 52.8% ▅▂█▄▃▆▁▇ │
└──────────────────────────────────────────────────────────────────────────────┘
┌─ WALLET INTELLIGENCE FEED · 100 RECORDS · PAGE 1/8 ─────────────────────────┐
│ # IDENTITY WALLET PNL 24H VOLUME TXNS WIN RATE │
│ 1 @TraderOne CyaE1V…ga54o \$43.86K \$386.39K 1,523 ████░ 42.0% │
│ 2 @WalletAlpha 9yYya3…r4jqL \$25.10K \$64.48K 79 █████ 53.1% │
│ 3 ANONYMOUS 6Lcx2P…8FaaQ \$18.92K $92.11K 203 █████ 56.4% │
└──────────────────────────────────────────────────────────────────────────────┘
› DATA GRID SYNCHRONIZED · 400 WALLETS INDEXED
1-4 CHANNEL ←/→ SWITCH ↑/↓ SELECT S SORT / FILTER X CLEAR R REFRESH Q QUIT
🗂️ Project Structure
-smart-wallet-terminal/
├── smart_wallet_terminal.py
├── requirements.txt
├── README.md
├── socials.txt
└── docs/
├── INSTALLATION.md
├── USAGE.md
├── DATA_AND_METRICS.md
├── CUSTOMIZATION.md
└── TROUBLESHOOTING.md
| Path | Description |
|---|---|
smart_wallet_terminal.py |
Main terminal application, API client, renderer, keyboard handler, and synchronization engine |
requirements.txt |
Python package dependencies |
README.md |
Project overview, setup instructions, controls, features, and documentation index |
socials.txt |
Ready-to-publish introductory social posts |
docs/INSTALLATION.md |
Detailed installation instructions for Windows, macOS, and Linux |
docs/USAGE.md |
Complete terminal navigation and workflow guide |
docs/DATA_AND_METRICS.md |
Explanation of wallet categories, metrics, and research use cases |
docs/CUSTOMIZATION.md |
Instructions for adjusting appearance, refresh settings, categories, and behavior |
docs/TROUBLESHOOTING.md |
Solutions for installation, API, terminal, networking, and rendering problems |
✅ Requirements
| Requirement | Recommended |
|---|---|
| Python | Python 3.9 or newer |
| Terminal | Windows Terminal, iTerm2, Kitty, Alacritty, WezTerm, GNOME Terminal, Konsole |
| Internet | Required for API requests |
| Terminal colors | True color or 256-color support recommended |
| Terminal size | At least 100 columns by 28 rows |
| Operating system | Windows, macOS, or Linux |
The application uses the following Python packages:
| Package | Purpose |
|---|---|
requests |
Retrieves smart-wallet data from the API |
rich |
Renders the full-screen dashboard, tables, panels, colors, and animations |
🚀 Quick Start
1. Clone or download the project
git clone https://github.com/your-name/-smart-wallet-terminal.git
cd -smart-wallet-terminal
If the repository was downloaded as a ZIP archive, extract it and open a terminal inside the extracted directory.
2. Create a virtual environment
python -m venv .venv
3. Activate the virtual environment
Windows PowerShell
.venv\Scripts\Activate.ps1
Windows Command Prompt
.venv\Scripts\activate.bat
macOS or Linux
source .venv/bin/activate
4. Install dependencies
python -m pip install --upgrade pip
pip install -r requirements.txt
5. Start the terminal
python smart_wallet_terminal.py
⌨️ Keyboard Controls
| Key | Action |
|---|---|
1 |
Open the Influencers channel |
2 |
Open the Smart Money channel |
3 |
Open the Top PNL channel |
4 |
Open the Whales channel |
Left Arrow |
Open the previous channel |
Right Arrow |
Open the next channel |
Tab |
Open the next channel |
Up Arrow or K
|
Select the previous wallet |
Down Arrow or J
|
Select the next wallet |
Page Up |
Move up by one page |
Page Down |
Move down by one page |
Home |
Select the first wallet |
End |
Select the last wallet |
S |
Cycle through sorting modes |
/ or F
|
Enter wallet search mode |
X |
Clear the active search filter |
R |
Refresh all data channels |
Q |
Exit the application |
Ctrl+C |
Immediately exit the application |
Search-mode controls
| Key | Action |
|---|---|
| Any printable character | Add text to the search query |
Backspace |
Remove the previous character |
Delete |
Clear the search input |
Enter |
Apply the search filter |
Escape |
Cancel search editing |
🔍 Search and Filtering
Search works against:
- Full wallet addresses
- Partial wallet addresses
- Twitter or X usernames
- Partial usernames
Press /, enter a wallet fragment or username, and press Enter.
Example searches:
CyaE1V
Cented7
9yYya3F5
To remove the active filter, press X.
Search is applied locally to the currently selected category. It does not send additional search requests to the API.
↕️ Sorting Modes
Press S repeatedly to cycle through the available sorting modes.
| Mode | Behavior |
|---|---|
| Rank | Uses the ranking returned by the data provider |
| PNL | Places the highest 24-hour PNL first |
| Volume | Places the highest trading volume first |
| Win Rate | Places the highest win rate first |
| TXNS | Places the highest transaction count first |
| Activity | Places the most recently active wallet first |
The active sorting mode appears in the navigation bar.
🌐 Data Source
The terminal retrieves data from 's smart-money data API:
https://datapi.jup.ag/smart-money/v1/top
Each request includes:
| Parameter | Value |
|---|---|
category |
influencer, smartMoney, topPnl, or whale
|
window |
1d |
limit |
100 |
The four feeds are requested in parallel to reduce total synchronization time.
Example response fields:
{
"rank": 1,
"walletId": "CyaE1VxvBrahnPWkqm5VsdCvyS2QmNht2UFrKJHga54o",
"pnlUsd": 43862.32,
"volumeUsd": 386392.61,
"txnCount": 1523,
"lastActiveAt": "2026-09-10T00:15:55Z",
"winRate": 0.42005,
"twitterUsername": "Cented7",
"profileImage": "https://example.com/profile.jpg"
}
API availability, fields, classifications, rate limits, and response behavior are controlled by the data provider and may change without notice.
🎯 What Is This Terminal For?
The terminal can support research workflows such as:
Wallet discovery
Find active wallets with strong PNL, meaningful volume, or consistent win rates.
Market-participant comparison
Compare influencers, smart-money wallets, top performers, and whales without switching between multiple browser pages.
Activity monitoring
Observe whether notable wallets have traded recently and identify channels with elevated transaction activity.
Research-list creation
Use usernames and wallet addresses as starting points for deeper analysis with explorers, portfolio tools, or internal research systems.
Educational analysis
Learn how wallet performance metrics differ across categories and how PNL, volume, transaction count, and win rate interact.
High historical PNL does not guarantee future performance. Wallet activity can involve transfers, hedges, private strategies, multiple addresses, or positions not represented in a single feed.
🎨 Interface Color Language
| Color | Meaning |
|---|---|
| Orange | Terminal branding, section titles, and active commands |
| Cyan | Active navigation, usernames, filters, and system accents |
| Green | Positive PNL, healthy connection state, and favorable rates |
| Red | Negative PNL, warnings, and data errors |
| Blue | Trading-volume values |
| Gray | Secondary labels, unavailable values, and inactive controls |
🔄 Refresh Behavior
The application automatically refreshes all categories every 45 seconds.
A refresh performs four parallel API requests:
- Influencers
- Smart Money
- Top PNL
- Whales
Existing data remains available while a new refresh is running. If only some feeds fail, successful feeds are still applied and the terminal reports a partial synchronization.
Press R at any time to request a manual refresh.
📚 Documentation Guides
| Guide | What You Will Learn |
|---|---|
| Installation Guide | How to install and launch the project on Windows, macOS, and Linux |
| Usage Guide | How to navigate, sort, search, refresh, and build a research workflow |
| Data and Metrics Guide | What each category and metric means and how the terminal can be used |
| Customization Guide | How to change colors, refresh timing, API limits, layout, and categories |
| Troubleshooting Guide | How to resolve common Python, dependency, API, network, and terminal problems |
🔐 Privacy and Security
The terminal:
- Does not request a private key
- Does not request a seed phrase
- Does not connect to a local wallet
- Does not sign transactions
- Does not place trades
- Does not modify blockchain state
- Does not require exchange credentials
- Only retrieves publicly available wallet analytics
Never paste a seed phrase, private key, API secret, or exchange credential into this application.
🛣️ Potential Roadmap
- Additional time windows
- CSV and JSON exports
- Wallet watchlists
- Wallet detail panels
- Solana explorer links
- Alert thresholds
- Historical snapshots
- PNL trend charts
- Category comparison screens
- Configurable themes
- Optional proxy support
- Offline snapshot viewing
- Configurable refresh intervals
- Token-level wallet analysis
🤝 Contributing
Contributions are welcome.
A useful contribution may include:
- Terminal compatibility improvements
- Better response validation
- New sorting or filtering modes
- Accessibility improvements
- New visual themes
- Export functionality
- Documentation corrections
- Test coverage
- Performance improvements
Suggested workflow:
git checkout -b feature/my-improvement
git add .
git commit -m "Add my improvement"
git push origin feature/my-improvement
Open a pull request with:
- A summary of the change
- The reason for the change
- Testing details
- Screenshots for interface changes
- Any compatibility considerations
⚠️ Disclaimer
This project is an independent terminal interface and is not an official product.
The information displayed by the application is provided for educational and informational purposes only. It is not financial, investment, legal, tax, or trading advice.
Wallet classifications and performance metrics may be incomplete, delayed, cached, inaccurate, or based on assumptions made by the data provider. A wallet's prior profitability does not establish that future trades will be profitable.
Always perform independent research before making financial decisions.
Top comments (1)
Some comments may only be visible to logged-in visitors. Sign in to view all comments.