AlphaGen-AI: Complete User Guide
AlphaGen-AI is a Bitcoin derivatives trading platform that combines 8 AI models, real-time CoinGlass data, social sentiment, and automated Hyperliquid trading. This guide walks you through every feature, from generating your first AI trade idea to running a live TradingView → Hyperliquid bot.
1. Getting Started
Sign In with Google
AlphaGen-AI uses Google OAuth for secure authentication. Click "Login" from any page and sign in with your Google account. Your account is automatically created on first login.
Plan Overview
New accounts start in Preview mode (read-only). Contact an administrator or upgrade to access features:
View dashboard, no AI ideas or trading
4 ideas/day, 1 AI model (GPT-4o)
8 ideas/day, 3 models, Market Rotation, Sentiment
20 ideas/day, 8 models, Hyperliquid (50x) + AsterDEX (1001x), DCA, Whales
Key Locations
2. AI Trade Ideas (Single Model + Ensemble)
Generating a Single-Model Idea
- Navigate to /dashboard
- Select your preferred AI model from the dropdown (GPT-4o, Gemini 2.5/3, Claude, DeepSeek, GLM, Qwen, Grok)
- (Optional) Upload a BTC chart screenshot (PNG/JPG, max 5 MB) for visual pattern analysis
- Click "Generate Trade" — the AI analyzes live CoinGlass derivatives data
- Review the generated trade idea with entry, stop loss, take profit, and confidence levels
Available AI Models
Trade Idea Output
Every trade idea includes:
- Direction: LONG or SHORT
- Entry Price: Recommended entry level
- Stop Loss: Risk management exit
- Take Profit: Target exit for profits
- Risk/Reward: Must be ≥1.5 (enforced)
- Confidence: 0-100% based on signal alignment
- Reasoning: AI explanation of the setup
- Signal Grid: Visual 8-point validation
8-Point Signal Validation Framework
Every AI trade idea must validate against these 8 signals with a weighted score ≥40%:
Ensemble Mode (Pro)
Select multiple AI models to generate separate trade ideas, then use a synthesizer model to create a consensus trade. Perfect for high-conviction setups validated across different AI reasoning approaches.
- Enable "Ensemble Mode" toggle
- Select 2-8 models for analysis
- Choose a synthesizer model
- Click "Generate Ensemble" — each model analyzes independently
- Review the synthesized consensus trade with cross-model validation
Trade History
All saved trade ideas appear in the Trade History panel on the dashboard. Track your P&L, filter by date range, and analyze model performance over time. Starter plans retain 30 days, Plus retains 90 days, Pro has unlimited history.
Exchange Selection for Trade Execution (Pro)
When executing a trade from an AI-generated idea, Pro users can choose between two exchanges:
- • Native on-chain DEX
- • Lower latency for BTC/ETH
- • DCA strategies supported
- • Ultra-high leverage (1001x)
- • 22-33% lower fees than HL
- • Stock perpetuals available
How to Select Exchange:
- Save an AI trade idea to your Trade History
- Click the "Execute" button on the trade idea card
- In the execution modal, select your preferred exchange (Hyperliquid or AsterDEX)
- Configure leverage (50x max for Hyperliquid, 1001x for AsterDEX)
- Review and confirm the trade execution
Note: DCA strategies now support both Hyperliquid and AsterDEX exchanges. Configure your wallet credentials for each exchange in Settings.
3. Market Rotation Dashboard
Data Sources
The Market Rotation Dashboard pulls live data from 11 CoinGlass API endpoints:
- • Funding Rate (OI-weighted)
- • Open Interest Aggregated
- • Liquidation Data
- • ETF Flow Tracker
- • Orderbook Depth
- • Taker Buy/Sell Volume
6-Signal Composite Scoring
The dashboard calculates a composite rotation score from 6 weighted signals:
- Funding Spread — BTC vs altcoin funding differential
- OI Divergence — Open interest flow between BTC and alts
- Volume Profile — Trading volume concentration
- BTC Dominance — Market cap share trend
- Alt Season Index — Alternative.me alt season indicator
- Sector Rotation — Capital flow between crypto sectors
Rotation Levels
Recommended Workflow
Before generating AI trade ideas: Check the Market Rotation Dashboard for macro context. If rotation signals show EXTREME or HIGH levels, consider adjusting position sizing or waiting for clearer conditions. The AI incorporates this data automatically, but understanding the macro environment helps you interpret trade ideas more effectively.
5. Hyperliquid Trading Bot (with TradingView)
PRORequirements
- • Hyperliquid Wallet — Create at app.hyperliquid.xyz
- • API/Agent Key — Generate in Hyperliquid settings (we encrypt it with MASTER_KEY)
- • TradingView Account — With alert webhooks enabled (Pro/Premium plan)
- • AlphaGen-AI Pro Plan — Required for bot access
Step 1: Connect Hyperliquid Credentials
- Navigate to /dashboard/hyperliquid
- Click "Connect Wallet" in the credentials section
- Enter your Hyperliquid wallet address and API/agent private key
- Keys are encrypted with AES-256-GCM and stored securely
Step 2: Configure Bot Settings
- • Leverage: Set between 1x-50x (default: 10x)
- • Position Sizing: Fixed USD or percentage of balance
- • Webhook Passphrase: Create a secure secret (required for webhook auth)
- • Kill Switch: Enable to start accepting trades
Step 3: Configure TradingView Webhook
Webhook URL:
https://alphagenai.app/api/webhook/hyperliquidAlert Message Format:
{
"passphrase": "YOUR_WEBHOOK_SECRET",
"ticker": "{{ticker}}",
"side": "{{strategy.order.action}}",
"size": "{{strategy.order.contracts}}"
}In TradingView alert settings, set the message to: {{strategy.order.alert_message}}
Step 4: Verify & Monitor
- • Test Signal Button: Send a test webhook to verify connectivity
- • Bot Logs Section: View incoming alerts and Hyperliquid exchange responses
- • Position Monitor: Real-time P&L tracking for open positions
Master Kill Switch
The kill switch provides instant emergency shutdown:
- • When Disabled: All incoming webhook requests receive 503 status (bot offline)
- • Existing Positions: Not affected — only new orders are blocked
- • Re-enable: Toggle back on to resume accepting trades
Security Features
4-layer OWASP Top 10 security hardening:
- • Global Auth Guard: Path traversal prevention with dot segment resolution
- • Helmet CSP: Production-safe Content Security Policy
- • Rate Limiting: 10 req/hour for webhooks, 1200 req/hour for polling
- • API Sanitization: Input validation and request sanitization
Using the AlphaGen-AI TradingView Strategy
PROPro subscribers get access to the Exclusive TradingView Strategy, optimized for Altcoin trading. While our AI trade generator is designed for Bitcoin, this TradingView strategy leverages derivatives data from liquid altcoin markets. The script is pre-configured to send correctly formatted webhooks to your AlphaGen-AI account, generating BUY/SELL signals that route directly to the Hyperliquid bot.
How to Obtain the Strategy
After upgrading to Pro, go to Dashboard → Hyperliquid Bot. In the "TradingView Strategy" panel you'll find the full Pine Script code for the AlphaGen-AI Strategy. Copy this script into TradingView's Pine Editor and save it under your own account.
Step 1 – Add the Strategy to a Chart
- • Open TradingView → Pine Editor
- • Paste the AlphaGen-AI Strategy code from the Pro dashboard
- • Save it and click "Add to chart"
- • Make sure you are on a BTC perpetual or futures chart that matches your Hyperliquid market
Step 2 – Configure Strategy Inputs
In the TradingView settings for the strategy, configure:
- • Risk % or fixed size — Controls position sizing
- • Timeframe — Chart timeframe for signal generation
- • Execution filters — Long/short only, etc.
These settings control {{strategy.order.contracts}} and the direction for webhooks.
Step 3 – Create a Webhook Alert
- • Click the Alert (bell) icon in TradingView
- • Condition: Select AlphaGen-AI Strategy as the condition
- • Use the option that fires on order fills so alerts are sent when the strategy opens/closes positions
- • Enable Webhook URL and paste:
https://alphagenai.app/api/webhook/hyperliquidIn the Message field, put exactly:
{{strategy.order.alert_message}}The Pine strategy sets alert_message to a JSON payload, and {{strategy.order.alert_message}} tells TradingView to forward that JSON unmodified.
Step 4 – Webhook JSON Format
The strategy sends this JSON payload (matching what /api/webhook/hyperliquid expects):
{
"passphrase": "YOUR_WEBHOOK_SECRET",
"ticker": "{{ticker}}",
"side": "{{strategy.order.action}}",
"size": "{{strategy.order.contracts}}"
}- • passphrase must match the WEBHOOK_PASSPHRASE configured in your AlphaGen-AI settings
- •
{{strategy.order.action}}and{{strategy.order.contracts}}are TradingView's documented placeholders for strategy order direction and size
Step 5 – Testing
- • Start with a small size on Hyperliquid testnet or a tiny notional
- • Trigger a manual signal or wait for a live signal
- • Confirm the trade appears on /dashboard/hyperliquid in the Bot Logs and on your Hyperliquid account
How It Connects to the Bot
The AlphaGen-AI Strategy in TradingView is responsible for generating entry/exit signals on your chosen timeframe. The AlphaGen-AI app receives those signals via /api/webhook/hyperliquid, applies your bot risk settings and kill switch, and then submits orders to Hyperliquid. If the kill switch is OFF, the webhook will be rejected even if the TradingView strategy fires.
5b. AsterDEX Trading Bot (Up to 1001x Leverage)
PROWhy AsterDEX?
AsterDEX is an alternative to Hyperliquid that offers extreme leverage (up to 1001x) and significantly lower trading fees. It's ideal for traders who want higher leverage options or want to reduce trading costs.
Fee Comparison
- • Maker: 0.01% (vs 0.02% Hyperliquid)
- • Taker: 0.035% (vs 0.05% Hyperliquid)
- • +5% Discount: With $ASTER token
Leverage Options
- • Max Leverage: Up to 1001x
- • Isolated Margin: Per-position risk
- • Zero Gas: On stock perpetuals
Setup Steps
Create AsterDEX Account
Visit www.asterdex.com and create an account. Generate API keys with trading permissions.
Configure in Settings
Navigate to /settings → AsterDEX API section. Enter your API Key and Secret. Your credentials are encrypted with AES-256-GCM before storage.
Copy Webhook URL
After saving credentials, the AsterDEX webhook URL will appear. Copy it for use in TradingView alerts.
Configure TradingView Alerts
Set up TradingView alerts using the AsterDEX webhook URL. The alert format is identical to Hyperliquid.
Monitor in Dashboard
Track positions, trades, and P&L in the /dashboard/asterdex page.
⚠️ High Leverage Warning
AsterDEX offers leverage up to 1001x, which means positions can be liquidated very quickly with small price movements. Start with lower leverage (10x-50x) until you're comfortable with the platform. Always use proper risk management and position sizing.
6. DCA Automation System
PROCreating a DCA Strategy
You can create DCA strategies from two sources:
From AI Trade Idea
After generating a trade idea, click "Create DCA" to convert it into an automated ladder strategy.
From Existing Position
In the Hyperliquid dashboard, click "Adopt Position" on any open position to add safety orders.
DCA Parameters
Initial position size in USD
Number of averaging orders (1-10)
Distance between safety orders
Scale factor for each subsequent order
Increase deviation between orders
Target profit to close position
Ladder Preview
Before activating, the system generates a preview showing:
- • Safety Order Levels: Exact trigger prices for each order
- • Order Sizes: USD amount at each level
- • Average Entry: Projected average after all orders fill
- • Liquidation Buffer: Distance to liquidation price at each level
Trigger Monitoring
The system periodically checks /api/dca/check-triggers to compare current price against your ladder levels. When a safety order trigger is hit, the order executes automatically on Hyperliquid.
7. Whale Tracking & Market Intelligence
PROWhale Positions Panel
Track the top 20 BTC positions exceeding $1M from CoinGlass and Hyperliquid data:
- • Position Size: Total USD value of each whale position
- • Direction: Long or short bias
- • Entry Price: Estimated average entry
- • Aggregate Bias: Net long/short ratio across all whales
ETF Flow Tracker
Monitor Bitcoin ETF capital flows:
- • Daily Flows: Net inflows/outflows per day
- • Weekly Aggregates: 7-day cumulative flow
- • Threshold Alerts: Notifications when flows exceed $500M
Kelly Criterion Calculator
Optimal position sizing based on your edge:
- • Inputs: Win rate (%), average reward/risk ratio
- • Full Kelly: Theoretically optimal bet size
- • Fractional Kelly (0.25-0.5x): Recommended conservative sizing
Liquidation Heatmap
Visual representation of liquidation clusters at various price levels. Use this to identify potential stop-hunting zones and optimal stop-loss placement outside of major liquidation clusters.
8. Subscription Plans & Limits
| Feature | Preview | Starter | Plus | Pro |
|---|---|---|---|---|
| Ideas per Day | 0 | 4 | 8 | 20 |
| AI Models | — | 1 (GPT-4o) | 3 | All 8 |
| Ensemble Mode | — | — | — | ✓ |
| Market Rotation | — | — | ✓ | ✓ |
| Social Sentiment | — | — | ✓ | ✓ |
| Hyperliquid Bot | — | — | — | ✓ |
| DCA Automation | — | — | — | ✓ |
| TradingView Strategy | — | — | — | ✓ |
| Whale Tracking | — | — | — | ✓ |
| Trade History | — | 30 days | 90 days | Unlimited |
How Limits Are Enforced
- • Ideas per Day: Counter resets at midnight UTC. Rejected ideas don't count.
- • Model Access: Only available models appear in the dropdown for your plan.
- • Bot Access: Hyperliquid dashboard locked for non-Pro users.
- • Feature Gates: UI elements for locked features show upgrade prompts.
- • Pro TradingView Strategy: Includes the official AlphaGen-AI TradingView Strategy (Pine Script) for automated BUY/SELL signals that connect your TradingView charts to the Hyperliquid bot via webhooks.
9. Safety, Risk Controls & Kill Switch
AI-Enforced Risk Controls
- Minimum Risk/Reward (1.5:1):
Every AI trade idea must have a risk/reward ratio of at least 1.5. Ideas failing this check are rejected and don't count toward your daily limit.
- Signal Score Threshold (40%):
The weighted 8-point signal score must exceed 40% for the idea to be approved.
- Confidence Calibration:
Each model has bias correction applied to normalize confidence scores across different AI reasoning approaches.
Confidence Ranges by Signal Count
Bot Kill Switch Behavior
The master kill switch on the Hyperliquid dashboard provides instant emergency shutdown:
- • Toggle Off: All incoming webhooks receive 503 "Bot Offline" response
- • Existing Positions: Remain open (manage manually on Hyperliquid)
- • DCA Strategies: Trigger monitoring paused until re-enabled
Risk Disclaimer
AlphaGen-AI provides automation tools for Bitcoin derivatives trading. You remain fully responsible for all trading decisions and risk management. Always start with testnet or small positions. Past performance of AI models does not guarantee future results. Never trade with funds you cannot afford to lose.
Ready to Start Trading?
You now have a complete understanding of AlphaGen-AI's features. Head to the dashboard to generate your first AI trade idea or explore the Market Rotation signals.
4. Social Sentiment Gauge & AI Confidence Overlay
NEWData Sources
The Social Sentiment Gauge combines three data sources via the
/api/context/sentimentendpoint:Composite Weighting
Example: Fear & Greed at 28 (Fear) + negative funding + net shorts = "Moderate Long" bias with contrarian signal.
AI Confidence Overlay (LLM Integration)
Sentiment data is injected into the AI prompt (Step 2.6) with these confidence adjustment rules:
Sentiment moderately confirms the derivatives-based trade idea
Sentiment diverges from derivatives signals (conflicting data)
Important: Sentiment is an Overlay
Sentiment never overrides the core signal requirements: