https://github.com/srujan911/cross-chain-token-tracker
Cross-chain USDT tracker with anomaly detection and Streamlit dashboard
https://github.com/srujan911/cross-chain-token-tracker
anamoly-detection blockchain bnb ethereum polygon streamlit token-tracker web3
Last synced: about 2 months ago
JSON representation
Cross-chain USDT tracker with anomaly detection and Streamlit dashboard
- Host: GitHub
- URL: https://github.com/srujan911/cross-chain-token-tracker
- Owner: srujan911
- Created: 2025-06-23T11:03:08.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-24T12:58:18.000Z (about 1 year ago)
- Last Synced: 2025-06-24T13:54:00.679Z (about 1 year ago)
- Topics: anamoly-detection, blockchain, bnb, ethereum, polygon, streamlit, token-tracker, web3
- Language: Python
- Homepage:
- Size: 2.77 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🔗 Cross-Chain Token Tracker
A real-time dashboard to visualize **USDT token transfers** across **Ethereum**, **BNB**, and **Polygon** blockchains.
---
## 🚀 Features
- View token transfers on Ethereum, BNB, and Polygon
- Filter by wallet address (`from` / `to`)
- Calculate total USDT moved, total transactions
- Plot transaction volume per block
- Detect abnormal transfers using AI (Isolation Forest)
- 🔁 Manual or auto-refresh using a Streamlit button
---
## 📸 Preview
---
## 🛠️ Tech Stack
- **Python**
- **Streamlit** – for dashboard
- **Pandas** – for data processing
- **Web3.py** – for blockchain RPC access
- **Plotly Express** – for plotting
- **Scikit-Learn** – anomaly detection (Isolation Forest)
---
## 📂 Project Structure
cross-chain-token-tracker/
├── dashboard/ # Streamlit dashboard
├── scripts/ # Data fetching scripts (RPC logs)
├── data/ # Output CSV logs (ETH, BNB, Polygon)
├── utils/ # Helper modules
├── .env # Environment config (RPC URLs)
├── requirements.txt # Dependencies
└── README.md
## ⚙️ Getting Started
1.**Clone the repository**
git clone https://github.com/srujan911/cross-chain-token-tracker.git
cd cross-chain-token-tracker
2.**Create and activate a virtual environment**
python -m venv .venv
.venv\Scripts\activate # on Windows
3.**Install dependencies**
pip install -r requirements.txt
4.**Set up .env**
ETH_RPC_URL=https://your-eth-node
BNB_RPC_URL=https://your-bnb-node
POLYGON_RPC_URL=https://your-polygon-node
5.**Run the app**
streamlit run dashboard/app.py