# 🌍 Gunja AI - Global User Guide

**Version:** 3.0
**Last Updated:** October 1, 2025
**Support:** admin@starium.site
**Website:** https://metaquant.club

---

## 📋 Table of Contents

1. [Introduction](#introduction)
2. [Quick Start Guide](#quick-start-guide)
3. [Dashboard Overview](#dashboard-overview)
4. [Trading Features](#trading-features)
5. [API Configuration](#api-configuration)
6. [Performance Monitoring](#performance-monitoring)
7. [Risk Management](#risk-management)
8. [Troubleshooting](#troubleshooting)
9. [FAQ](#faq)

---

## 🚀 Introduction

Welcome to **Gunja AI v3.0** - The next-generation AI-powered autonomous trading platform designed for cryptocurrency futures trading.

### What is Gunja AI?

Gunja AI is an advanced trading system that combines:
- **25+ Technical Indicators** for comprehensive market analysis
- **Score ranking** (technical indicators, funding rate, news) to set direction
- **Peak Tracker** recording the best profit point reached by each pair
- **Per-account cycles**, measured at about 49 seconds
- **Automated Trading** on Bitget futures markets

### Key Features

✨ **Autonomous Trading**: Fully automated 24/7 trading
🧠 **AI-Powered**: Multiple AI models working in harmony
📊 **Advanced Analytics**: 25 core + 21 extended technical indicators
🔄 **Recorded**: Peak Tracker keeps missed profit as data
🛡️ **Risk Management**: Dynamic position sizing and stop-loss
📈 **Real-time Dashboard**: Live trading performance monitoring

---

## ⚡ Quick Start Guide

### Step 1: Access the Platform

1. Navigate to: https://metaquant.club
2. Select your preferred language (English, 한국어, 日本語, 中文)
3. Click **"Get Started Free"** or **"Sign In"**

### Step 2: Create Your Account

1. Click **"Register"** on the homepage
2. Enter your email address
3. Create a secure password
4. Verify your email (check spam folder if needed)
5. Log in to your account

### Step 3: Configure API Keys

**Important:** Gunja AI requires Bitget API credentials to execute trades.

1. Go to [Bitget API Management](https://www.bitget.com/api-doc)
2. Create a new API key with the following permissions:
   - ✅ **Read** (Required)
   - ✅ **Trade** (Required)
   - ❌ **Transfer** (Not required, keep disabled for security)
3. Copy your:
   - API Key
   - Secret Key
   - Passphrase
4. In Gunja AI Dashboard → **Settings** → **API Configuration**
5. Paste your credentials and click **"Save & Test Connection"**

### Step 4: Start Trading

1. Review your dashboard
2. Check system status (should show "✅ All Systems Operational")
3. Monitor live positions and signals
4. Adjust risk settings if needed (Settings → Risk Management)

**🎉 Congratulations!** Your Gunja AI system is now active and trading automatically.

---

## 📊 Dashboard Overview

### Main Dashboard Components

#### 1. **Live Trading Status**
- **System Status**: Real-time operational status
- **Active Positions**: Currently open trades
- **24h Performance**: Daily profit/loss summary
- **Success Rate**: Win rate percentage

#### 2. **Trading Pairs Heatmap**
Real-time visualization of 14 major trading pairs:
- BTCUSDT, ETHUSDT, BNBUSDT, XRPUSDT
- SOLUSDT, DOGEUSDT, ADAUSDT, DOTUSDT
- MATICUSDT, LINKUSDT, UNIUSDT, LTCUSDT
- AVAXUSDT, ATOMUSDT

**Color Coding:**
- 🟢 **Green**: Bullish signals
- 🔴 **Red**: Bearish signals
- 🟡 **Yellow**: Neutral/Waiting

#### 3. **AI Analysis Panel**
Four AI models analyze the market simultaneously:
- **tech**: trend and momentum component
- **funding**: positioning-skew component
- **news**: events summarised and scored by a language model
- **Groq**: Fast real-time analysis

#### 4. **Technical Indicators**
View 25 core indicators:
- **Trend**: EMA, SMA, MACD, ADX
- **Momentum**: RSI, Stochastic, CCI
- **Volatility**: Bollinger Bands, ATR
- **Volume**: OBV, MFI, VWAP
- **Custom**: TMA, Composite Index

---

## 🎯 Trading Features

### 1. **Autonomous Trading Mode**

**How it works:**
1. Each account is analysed on its own cycle, measured at about 49 seconds
2. 25 technical indicators generate signals
3. The score ranking sets direction and picks a low-correlation partner
4. System executes trades automatically
5. Peak Tracker records the best point reached and where the position actually closed

**Settings you can control:**
- **Position Size**: Fixed amount (10 USDT per trade)
- **Leverage**: 10x (configured per Strategy1)
- **Max Positions**: 8 symbols maximum
- **Trading Hours**: 24/7 (always active)

### 2. **Signal System**

**24 TRIGGER Types:**
- **16 Basic TRIGGERs**: Support/Resistance levels (±2%)
- **5 Confidence TRIGGERs**: AI-selected direction (regenerated every 5 min)
- **3 Hedge TRIGGERs**: ROE -10% protection system

**How TRIGGERs work:**
1. System identifies key price levels
2. Creates trigger orders at those levels
3. Auto-executes when price hits trigger
4. Regenerates every 5 minutes with new market data

### 3. **Dynamic Take Profit (TP)**

**AI-Based TP Management:**
- **Minimum TP**: 0.3% profit guarantee
- **Dynamic Adjustment**: AI increases TP based on momentum
- **Smart Exit**: Closes position at optimal profit point

**Example:**
```
Entry: $100,000 (BTC)
TP Target: $100,300 (0.3% minimum)
AI sees strong momentum → Adjusts to $100,600 (0.6%)
Exit: $100,600 (Actual profit: 0.6%)
```

### 4. **Hedge System**

**ROE -10% Protection:**
- Monitors all open positions
- If position reaches -10% ROE (Return on Equity)
- Automatically creates hedge TRIGGER
- Opens opposite position to protect capital

**Example:**
```
Long BTC at $100,000 → Price drops to $90,000 (-10% ROE)
System creates: Short BTC trigger at $90,000
Hedge position limits further losses
```

---

## 🔧 API Configuration

### Supported Exchanges

Currently supported:
- ✅ **Bitget** (Fully integrated)
- 🔄 **Binance** (Coming soon)
- 🔄 **Gate.io** (Coming soon)

### API Setup Instructions

#### For Bitget:

1. **Login to Bitget**
   - Go to: https://www.bitget.com
   - Login to your account

2. **Navigate to API Management**
   - Click your profile → API Management
   - Click "Create API"

3. **Configure API Permissions**
   - Select "Futures Trading" mode
   - Enable permissions:
     - ✅ Read
     - ✅ Trade
     - ❌ Transfer (Keep disabled)
   - Set IP whitelist (optional, recommended)

4. **Save Credentials**
   - Copy API Key
   - Copy Secret Key
   - Set and copy Passphrase (remember this!)
   - Store securely (never share with anyone)

5. **Add to Gunja AI**
   - Dashboard → Settings → API Configuration
   - Exchange: Select "Bitget"
   - Paste API Key, Secret Key, Passphrase
   - Click "Test Connection"
   - If successful, click "Save"

### Security Best Practices

🔐 **API Security:**
- Never share your API credentials
- Use IP whitelist if possible
- Disable "Transfer" permission
- Regularly rotate API keys (every 3 months)
- Monitor API activity on Bitget

⚠️ **Warning Signs:**
- Unexpected trades in your Bitget account
- API key errors in Gunja AI
- Unusual position sizes
- Unknown IP access attempts

**If compromised:** Immediately delete API key on Bitget and create a new one.

---

## 📈 Performance Monitoring

### Real-Time Metrics

#### 1. **Position Tracking**
Monitor your active positions:
- **Entry Price**: Your opening price
- **Current Price**: Real-time market price
- **PnL**: Profit/Loss (in USDT and %)
- **ROE**: Return on Equity
- **Duration**: How long position has been open

#### 2. **Historical Performance**
View past trading results:
- **Closed Positions**: All completed trades
- **Win Rate**: Percentage of profitable trades
- **Average Profit**: Mean profit per winning trade
- **Average Loss**: Mean loss per losing trade
- **Total PnL**: Overall profit/loss

#### 3. **AI Confidence Scores**
Each signal shows AI confidence:
- **0-40%**: Low confidence (system may skip)
- **40-70%**: Medium confidence (cautious entry)
- **70-100%**: High confidence (aggressive entry)

### Performance Dashboard (Port 8004)

Access detailed analytics:
- URL: https://app.metaquant.club
- Login with your Gunja AI credentials
- View:
  - Detailed trade history
  - Position timeline
  - Profit/loss charts
  - Strategy effectiveness
  - AI model performance comparison

---

## 🛡️ Risk Management

### Built-in Risk Controls

#### 1. **Position Sizing**
- **Fixed Entry**: 10 USDT per trigger
- **Leverage**: 10x multiplier
- **Effective Capital**: 100 USDT per position
- **Max Risk**: Limited to 10 USDT loss per trade

#### 2. **Hedge Protection**
- Automatic hedge at -10% ROE
- Limits maximum loss per position
- Creates opposite direction trigger
- Protects capital during high volatility

#### 3. **Dynamic Stop-Loss**
- AI-managed liquidation
- No hard stop-loss (prevents stop hunting)
- Intelligent exit based on market conditions
- Prioritizes capital preservation

### User-Configurable Settings

You can adjust:
- **Max Concurrent Positions**: 1-8 symbols
- **Trading Symbols**: Select which pairs to trade
- **Risk Level**: Conservative/Balanced/Aggressive
- **Notifications**: Telegram alerts for trades

**Recommended Settings for Beginners:**
```yaml
Max Positions: 4
Trading Symbols: BTC, ETH, XRP, SOL
Risk Level: Conservative
Leverage: 10x (default, do not change)
Position Size: 10 USDT (default, do not change)
```

---

## 🔍 Troubleshooting

### Common Issues

#### Issue 1: "API Connection Failed"

**Symptoms:**
- Dashboard shows "❌ API Error"
- No positions opening
- Error: "Failed to connect to Bitget"

**Solutions:**
1. Verify API credentials are correct
2. Check API permissions (Read + Trade enabled)
3. Ensure Bitget account has USDT balance
4. Try regenerating API key on Bitget
5. Contact support if issue persists

#### Issue 2: "No Triggers Generated"

**Symptoms:**
- Dashboard shows "⏳ Waiting for signals"
- No trigger orders created
- System operational but inactive

**Solutions:**
1. Check market volatility (low volatility = fewer signals)
2. Verify AI confidence threshold (may be too high)
3. Wait 5-10 minutes (system regenerates every 5 min)
4. Check selected trading symbols
5. Review system logs

#### Issue 3: "Position Not Closing"

**Symptoms:**
- Position in profit but not closing
- TP target not reached
- Position open for extended time

**Solutions:**
1. Check current TP target (Dashboard → Positions → TP)
2. AI may be adjusting TP for higher profit
3. Market may not have reached TP yet
4. Manual close: Dashboard → Positions → "Close Now"

#### Issue 4: "High Loss on Position"

**Symptoms:**
- Position showing -5% or more loss
- Concerned about continued losses
- Hedge not triggered yet

**Solutions:**
1. Hedge triggers at -10% ROE automatically
2. System uses AI-managed exits (no hard stop-loss)
3. Let the take-profit ladder run through its stages
4. If very concerned: Manual close in dashboard
5. Review risk settings after position closes

### Getting Help

📧 **Email Support:** admin@starium.site
💬 **Telegram:** @GunjaAISupport (coming soon)
📖 **Documentation:** https://metaquant.club/ko/guide
🐛 **Report Bug:** GitHub Issues (private repo)

---

## ❓ FAQ

### General Questions

**Q: Is Gunja AI fully automated?**
A: Yes, once configured, the system trades 24/7 automatically without manual intervention.

**Q: Do I need trading experience?**
A: No, Gunja AI is designed for both beginners and experts. The AI handles all trading decisions.

**Q: What is the minimum deposit?**
A: Recommended minimum: 100 USDT on Bitget for 10 simultaneous positions (10 USDT × 10 positions).

**Q: Can I lose more than my deposit?**
A: No, maximum loss is limited to your Bitget futures account balance. The system includes hedge protection.

### Trading Questions

**Q: How often does the AI analyze the market?**
A: About 49 seconds per account (measured; it varies with account count and exchange latency).

**Q: What happens if internet disconnects?**
A: The system runs on a cloud server, not your computer. Trading continues even when your machine is off.

**Q: Can I manually close positions?**
A: Yes, in Dashboard → Positions → Select position → "Close Now" button.

**Q: What is the recorded learning data used for?**
A: The system learns from every trade, adjusting strategies based on what works best in current market conditions.

### Technical Questions

**Q: Which AI models does Gunja use?**
A: The direction score is computed from three components — technical indicators, funding rate and news. A language model summarises and scores news and is also used for trade reflection. The specific models change over time, so we do not cite a model name as evidence of performance.

**Q: What are the 25+ technical indicators?**
A: EMA, SMA, MACD, RSI, Stochastic, Bollinger Bands, ATR, ADX, CCI, OBV, MFI, VWAP, and 13+ custom indicators.

**Q: Is my data secure?**
A: Yes, API keys are encrypted, never shared, and stored securely. We never have access to withdraw funds.

**Q: Can I use Gunja AI on mobile?**
A: Yes, the web dashboard is mobile-responsive. Access it from any device at https://app.metaquant.club

### Performance Questions

**Q: What is the expected success rate?**
A: We do not publish a win-rate figure. Your results are shown on your own dashboard after login, taken from the exchange account ledger. Past performance does not guarantee future results.

**Q: How much profit can I make?**
A: Profits vary with market conditions, capital and risk settings. Take-profit is realised over a four-stage ladder and the exit threshold moves with volatility. **There is no stop-loss, so a losing position ties up funds until it recovers.**

**Q: Are there any fees?**
A: For platform fees, please contact the administrator. Exchange fees follow each exchange's own schedule (e.g. Bitget ~0.06% per trade).

**Q: Can I backtest strategies?**
A: Currently not available in user dashboard. Coming in v3.1 update.

---

## 🎓 Next Steps

### Beginner Path
1. ✅ Complete Quick Start Guide
2. ✅ Configure API keys
3. ✅ Start with 2-4 trading symbols
4. ✅ Monitor performance for 7 days
5. ✅ Adjust settings based on results
6. ✅ Gradually increase positions

### Advanced Path
1. ✅ Explore Technical Indicators dashboard
2. ✅ Analyze AI model consensus patterns
3. ✅ Fine-tune risk management settings
4. ✅ Check which take-profit stage each pair is on
5. ✅ Optimize symbol selection
6. ✅ Join Gunja AI community (coming soon)

---

## 📞 Contact & Support

**Gunja AI Support Team**
📧 Email: admin@starium.site
🌐 Website: https://metaquant.club
📊 Dashboard: https://app.metaquant.club
📰 News: https://app.metaquant.club (News tab in the member dashboard)

**Business Hours:** 24/7 (AI-powered support)
**Response Time:** Within 24 hours

---

**© 2025 Gunja AI. All rights reserved.**
*Built with ❤️ for traders worldwide.*

---

## 🔄 Version History

**v3.0** (October 2025)
- Score-ranking direction engine
- Peak Tracker recording system
- 25+ Technical Indicators
- Trading Pairs Heatmap
- Enhanced User Dashboard

**v2.0** (September 2025)
- Multi-user support
- Strategy1 compliance
- ROE -10% hedge system
- Dynamic TP management

**v1.0** (August 2025)
- Initial release
- Basic AI trading
- Bitget integration
- 64 technical indicators