https://github.com/wizardgeeky/agent-wizard
Agent Wizard monitors Web3 trades in real-time, analyzes market activity, and delivers instant notifications so you never miss the best time to trade.
https://github.com/wizardgeeky/agent-wizard
adk-ts aes-encryption ai ai-agents authentication authorization coingecko-api geminiai iqai jwt-authentication nextjs prompt restful-api shadcn-ui telegrambot trade-bot typescript web3
Last synced: 21 days ago
JSON representation
Agent Wizard monitors Web3 trades in real-time, analyzes market activity, and delivers instant notifications so you never miss the best time to trade.
- Host: GitHub
- URL: https://github.com/wizardgeeky/agent-wizard
- Owner: WizardGeeky
- License: mit
- Created: 2025-10-18T08:54:45.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-10-23T09:36:55.000Z (7 months ago)
- Last Synced: 2025-10-26T22:58:09.974Z (7 months ago)
- Topics: adk-ts, aes-encryption, ai, ai-agents, authentication, authorization, coingecko-api, geminiai, iqai, jwt-authentication, nextjs, prompt, restful-api, shadcn-ui, telegrambot, trade-bot, typescript, web3
- Language: TypeScript
- Homepage: https://agent-wizard.vercel.app
- Size: 240 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# 🧙♂️ Agent Wizard
Agent Wizard is a Web3-based real-time trade monitoring and risk management tool that leverages AI-powered analytics to track market activity, assess risks, and deliver instant alerts via Telegram, helping users make smarter trading decisions.
## 🚀 Features
- 📈 **Real-Time Trade Monitoring** - Live tracking of trades and market movements.
- 🧠 **AI-Powered Risk Analysis** - Detects anomalies and volatility to mitigate risks.
- 📬 **Telegram Notifications** - Instant alerts for trades and risk events.
- 📊 **Advanced Analytics** - Interactive dashboards for deep insights.
- 🤖 **Agent-Powered Workflows** - Automates monitoring and decision-making.
- 👥 **Collaborative Insights** - Share insights and alerts with teams.
## 🧪 Demo
Check out the live demo: [Agent Wizard](https://agent-wizard.vercel.app)
## 📸 Proof Work
### Mobile View
## 🌊 Application Flow
## 🧩 Architecture Overview
```
Frontend (Next.js) ↔ Backend (Node.js API)
Backend ↔ MongoDB (Data storage)
Backend ↔ Ether.js (Web3 interactions)
Backend ↔ AI Agents (Risk analysis)
Backend ↔ Telegram/Email (Notifications)
```
## 🔐 Authentication
- Web3 login via MetaMask
- Traditional login via Magic.link
- Secure session management with JWT Token
- Data Encryption with AES
## 🧠 AI Agents
- **Trade Monitor Agent**: Monitoring Trade information of Web3 coins based on users Risk configuration
- **Telegram Agent**: Sends real-time alerts
- **Email Agent**: Sends risk summaries
- **Chat Agent**: You can ask anything about web 3.0
## 🧪 Testing
```bash
npm run test
```
Tools: Jest, Cypress
## 🧰 Local Development
```bash
git clone https://github.com/WizardGeeky/Agent-Wizard.git
cd Agent-Wizard
npm install
npm run dev
```
## 🌐 Environment Variables
```env
MONGODB_URI = YOUR_MONGODB_URI
CIPHER_SECRET = YOUR_OWN_CIPHER_KEY
NEXT_PUBLIC_JWT_SECRET = YOUR_JWT_KEY
NEXT_PUBLIC_PERSONAL_EMAIL = YOUR_EMAIL_ADDRESS
NEXT_PUBLIC_BURNER_PASSWORD = YOUR_EMAIL_APP_PASSWORD
TELEGRAM_BOT_TOKEN = YOUR_TELEGRAM_BOT_TOKEN
GOOGLE_API_KEY = YOUR_GEMINIAI_KEY
GOOGLE_SEARCH_KEY= YOUR_GOOGLE_SEARCH_APIKEY
GOOGLE_CSE_ID = YOUR_GOOGLE_CSE_APIKEY
NEXT_PUBLIC_APP_URL = YOUR_APPLICATION_URL
```
## 🧠 AI & ML Models
- Uses ADK-TS and IQAI for anomaly detection and risk scoring
- Real-time analysis of trade patterns
## 📡 Web3 Integration
- Ether.js for smart contract interaction
- Wallet connection via MetaMask
- Real-time blockchain event tracking
## 🧾 API Reference
API Path
HTTP Method
Description
/api/v1/signup
POST
User Account creation with email and password
/api/v1/chat
POST
Chat bot (ask anything about web3, trade market)
/api/v1/login
POST
Authenticate user via email and password
/api/v1/login/metamask
POST
Authenticate user via Metamask Wallect
/api/v1/otp
POST
Send Otp to User email
/api/v1/password
POST
Send Password Reset link to email
/api/v1/password/reset
POST
Reset the password
/api/v1/password
POST
Verify Otp
/api/v1/monitor
POST
Select web3 coins to wish list to monitor
/api/v1/monitor
GET
Get all wish list coins
/api/v1/analysis
POST
Get All information or analytics about wish list coins
/api/v1/risk
POST
Create Risk configuration for wish list coins on markey cap, volume in %
/api/v1/risk
GET
Get All Risk Configuration
/api/v1/risk
DELETE
Delete Risk Configuration
## 🧑💻 Contributing
- Fork the repo
- Create a feature branch
- Submit a pull request
## 🙋 FAQ
**Q:** How do I connect my wallet?
**A:** Use MetaMask extension and connect via the dashboard.
**Q:** What chains are supported?
**A:** Ethereum mainnet and testnets.
**Q:** How is risk calculated?
**A:** Using AI models that analyze trade volume, volatility, and historical patterns.
## 📦 Tech Stack
- **Frontend**: TypeScript, NextJS, ShadCN, MagicUI, Tailwind CSS
- **Backend**: Node JS, NextJS, Nodemailer
- **Database**: MongoDB
- **Web3**: EtherJS
- **Wallet**: MetaMask
- **Notifications**: Telegram, Email
- **AIML**: ADK-TS, IQAI
- **AI Agents**: Telegram Agent, Email Agent, Chat Agent
- **3rd Party APIs**: Coingecko, Alchemy
## 📁 Folder Structure
```
├── 📁 app
│ ├── 📁 adk
│ │ ├── 📁 agent
│ │ │ ├── 📄 agent.ts
│ │ │ └── 📄 chatAgent.ts
│ │ └── 📁 tools
│ │ ├── 📄 RealGoogleSearch.ts
│ │ └── 📄 telegramTool.ts
│ ├── 📁 api
│ │ └── 📁 v1
│ │ ├── 📁 assets
│ │ │ ├── 📁 analytics
│ │ │ │ └── 📄 route.ts
│ │ │ ├── 📁 monitor
│ │ │ │ └── 📄 route.ts
│ │ │ └── 📁 risk
│ │ │ └── 📄 route.ts
│ │ ├── 📁 chat
│ │ │ └── 📄 route.ts
│ │ ├── 📁 login
│ │ │ ├── 📁 metamask
│ │ │ │ └── 📄 route.ts
│ │ │ └── 📄 route.ts
│ │ ├── 📁 otp
│ │ │ ├── 📁 verify
│ │ │ │ └── 📄 route.ts
│ │ │ └── 📄 route.ts
│ │ ├── 📁 password
│ │ │ ├── 📁 reset
│ │ │ │ └── 📄 route.ts
│ │ │ └── 📄 route.ts
│ │ └── 📁 signup
│ │ └── 📄 route.ts
│ ├── 📁 components
│ │ ├── 📄 Agent.tsx
│ │ ├── 📄 Features.tsx
│ │ ├── 📄 Hero.tsx
│ │ ├── 📄 HowItWorks.tsx
│ │ ├── 📄 LoginForm.tsx
│ │ ├── 📄 Metamask.tsx
│ │ ├── 📄 Nav.tsx
│ │ └── 📄 SignUpForm.tsx
│ ├── 📁 config
│ │ ├── 📄 cipher.config.ts
│ │ ├── 📄 database.config.ts
│ │ ├── 📄 jwt.config.ts
│ │ └── 📄 nodemailer.config.ts
│ ├── 📁 contexts
│ │ └── 📄 ThemeContext.tsx
│ ├── 📁 dashboard
│ │ ├── 📁 components
│ │ │ ├── 📄 Analytics.tsx
│ │ │ ├── 📄 CoinTable.tsx
│ │ │ ├── 📄 dashboard.tsx
│ │ │ ├── 📄 logout.tsx
│ │ │ ├── 📄 profile.tsx
│ │ │ └── 📄 riskanalysisengine.tsx
│ │ └── 📄 page.tsx
│ ├── 📁 lib
│ │ └── 📄 cron.ts
│ ├── 📁 models
│ │ ├── 📄 AssetMonitor.ts
│ │ ├── 📄 Otp.ts
│ │ ├── 📄 RiskConfig.ts
│ │ └── 📄 User.ts
│ ├── 📁 password
│ │ ├── 📁 reset
│ │ │ └── 📄 page.tsx
│ │ └── 📄 page.tsx
│ ├── 📁 types
│ │ ├── 📄 CoinEvent .ts
│ │ └── 📄 CoinInfo.ts
│ ├── 📁 utils
│ │ └── 📁 templates
│ │ ├── 📄 cryptoNotification.tsx
│ │ ├── 📄 otpTemplate.tsx
│ │ └── 📄 welcomeTemplate.tsx
│ ├── 📄 favicon.ico
│ ├── 🎨 globals.css
│ ├── 📄 layout.tsx
│ └── 📄 page.tsx
├── 📁 components
│ └── 📁 ui
│ ├── 📄 animated-theme-toggler.tsx
│ ├── 📄 aurora-text.tsx
│ ├── 📄 button.tsx
│ ├── 📄 card.tsx
│ ├── 📄 chart.tsx
│ ├── 📄 checkbox.tsx
│ ├── 📄 dialog.tsx
│ ├── 📄 floating-dock.tsx
│ ├── 📄 input.tsx
│ ├── 📄 label.tsx
│ ├── 📄 loader.tsx
│ ├── 📄 radio-group.tsx
│ ├── 📄 ripple.tsx
│ ├── 📄 select.tsx
│ ├── 📄 switch.tsx
│ ├── 📄 tabs.tsx
│ ├── 📄 tooltip.tsx
│ └── 📄 wobble-card.tsx
├── 📁 lib
│ └── 📄 utils.ts
├── 📁 public
├── ⚙️ .gitignore
├── 📝 README.md
├── ⚙️ components.json
├── 📄 next.config.ts
├── ⚙️ package-lock.json
├── ⚙️ package.json
├── 📄 postcss.config.mjs
└── ⚙️ tsconfig.json
```
## 📄 License
This project is licensed under the MIT License.