Back to Docs

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:

Preview

View dashboard, no AI ideas or trading

Starter

4 ideas/day, 1 AI model (GPT-4o)

Plus

8 ideas/day, 3 models, Market Rotation, Sentiment

Pro

20 ideas/day, 8 models, Hyperliquid (50x) + AsterDEX (1001x), DCA, Whales

Key Locations

/dashboard— Main control center: AI ideas, market data, trade history
/dashboard/hyperliquid— Hyperliquid trading bot (50x), DCA strategies (Pro)
/dashboard/asterdex— AsterDEX trading bot (1001x), lower fees (Pro)
/pricing— View and upgrade subscription plans

2. AI Trade Ideas (Single Model + Ensemble)

Generating a Single-Model Idea

  1. Navigate to /dashboard
  2. Select your preferred AI model from the dropdown (GPT-4o, Gemini 2.5/3, Claude, DeepSeek, GLM, Qwen, Grok)
  3. (Optional) Upload a BTC chart screenshot (PNG/JPG, max 5 MB) for visual pattern analysis
  4. Click "Generate Trade" — the AI analyzes live CoinGlass derivatives data
  5. Review the generated trade idea with entry, stop loss, take profit, and confidence levels

Available AI Models

GPT-4oVision
Gemini 2.5 ProVision
Gemini 3 ProVision
Claude Sonnet 4.5Vision
DeepSeekData only
GLM-4.6Data only
Qwen3-80BVision
GrokVision

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%:

1. Funding Rate — Perpetual futures sentiment
2. OI Correlation — Open interest vs price alignment
3. Liquidations — Forced liquidation cascades
4. Orderbook Depth — Support/resistance levels
5. Taker Volume — Aggressor buy/sell pressure
6. RSI (14) — Overbought/oversold momentum
7. Bollinger Bands — Volatility extremes
8. VWAP — Volume-weighted average price

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.

  1. Enable "Ensemble Mode" toggle
  2. Select 2-8 models for analysis
  3. Choose a synthesizer model
  4. Click "Generate Ensemble" — each model analyzes independently
  5. 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:

Hyperliquidup to 50x
  • • Native on-chain DEX
  • • Lower latency for BTC/ETH
  • • DCA strategies supported
AsterDEXup to 1001x
  • • Ultra-high leverage (1001x)
  • • 22-33% lower fees than HL
  • • Stock perpetuals available

How to Select Exchange:

  1. Save an AI trade idea to your Trade History
  2. Click the "Execute" button on the trade idea card
  3. In the execution modal, select your preferred exchange (Hyperliquid or AsterDEX)
  4. Configure leverage (50x max for Hyperliquid, 1001x for AsterDEX)
  5. 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:

  1. Funding Spread — BTC vs altcoin funding differential
  2. OI Divergence — Open interest flow between BTC and alts
  3. Volume Profile — Trading volume concentration
  4. BTC Dominance — Market cap share trend
  5. Alt Season Index — Alternative.me alt season indicator
  6. Sector Rotation — Capital flow between crypto sectors

Rotation Levels

EXTREME
70+ points
HIGH
50-69 points
MODERATE
30-49 points
LOW
0-29 points

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.

4. Social Sentiment Gauge & AI Confidence Overlay

NEW

Data Sources

The Social Sentiment Gauge combines three data sources via the /api/context/sentiment endpoint:

  • Fear & Greed Index (Alternative.me) — 0-100 scale from "Extreme Fear" to "Extreme Greed"
  • CoinGlass Funding Rate — 8-hour OI-weighted funding with historical percentile
  • CoinGlass Long/Short Ratio — Aggregate trader positioning across exchanges

Composite Weighting

40%
Fear & Greed Index
30%
Funding Rate Bias
30%
Long/Short Ratio

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:

+15% ConfidenceStrong contrarian setups
  • • Extreme Fear (<30) + extreme negative funding → LONG trades
  • • Extreme Greed (>75) + extreme positive funding → SHORT trades
+5% ConfidenceModerate confirmation

Sentiment moderately confirms the derivatives-based trade idea

-10% ConfidenceDivergence warning

Sentiment diverges from derivatives signals (conflicting data)

Important: Sentiment is an Overlay

Sentiment never overrides the core signal requirements:

  • • Weighted signal score must still be ≥40%
  • • Minimum risk/reward ratio must be ≥1.5
  • • Sentiment adds context but cannot force a trade that fails validation

5. Hyperliquid Trading Bot (with TradingView)

PRO

Requirements

  • 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

  1. Navigate to /dashboard/hyperliquid
  2. Click "Connect Wallet" in the credentials section
  3. Enter your Hyperliquid wallet address and API/agent private key
  4. 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/hyperliquid

Alert 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

PRO

Pro 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/hyperliquid

In 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)

PRO

Why 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

1

Create AsterDEX Account

Visit www.asterdex.com and create an account. Generate API keys with trading permissions.

2

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.

3

Copy Webhook URL

After saving credentials, the AsterDEX webhook URL will appear. Copy it for use in TradingView alerts.

4

Configure TradingView Alerts

Set up TradingView alerts using the AsterDEX webhook URL. The alert format is identical to Hyperliquid.

5

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

PRO

Creating 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

Base Order Size

Initial position size in USD

Safety Order Count

Number of averaging orders (1-10)

Price Deviation %

Distance between safety orders

Volume Multiplier

Scale factor for each subsequent order

Step Multiplier

Increase deviation between orders

Take Profit %

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

PRO

Whale 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

FeaturePreviewStarterPlusPro
Ideas per Day04820
AI Models1 (GPT-4o)3All 8
Ensemble Mode
Market Rotation
Social Sentiment
Hyperliquid Bot
DCA Automation
TradingView Strategy
Whale Tracking
Trade History30 days90 daysUnlimited

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

1-2 Signals
40-55% confidence
3-4 Signals
55-70% confidence
5-6 Signals
70-85% confidence
7-8 Signals
85-95% confidence

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.