User Guide

Getting Started

Creating Your Account

Aleph Terminal supports two login methods: GitHub OAuth and Ethereum wallet sign-in (SIWE). Both create an account automatically on first login - there is no separate registration step.

GitHub Login: Click the "Login" button in the top-right corner. You will be redirected to GitHub to authorize Aleph Terminal. We request read access to your public profile only (username, avatar, email). After authorization, you are redirected back and logged in automatically.

Wallet Login: Click "Connect Wallet" on the login screen. If you have MetaMask, Rabby, or another injected wallet, it will prompt you to sign a message (EIP-4361 / Sign-In with Ethereum). This proves wallet ownership without sharing your private key. Your wallet address becomes your identity.

Legal Acceptance Gate

On your very first visit - before you can see any content - a full-screen legal acceptance overlay appears. You must check two boxes before proceeding:

• "I have read and agree to the Terms of Service and Privacy Policy" - links open in new tabs so you can read them in full.
• "I have read and understand the Risk Disclosure and Disclaimer" - covers volatility, leverage risk, algorithmic risk, and the fact that nothing on the platform constitutes financial advice.

This is a one-time requirement per browser. Your acceptance is stored locally. If you are already logged in (returning user), the gate does not appear.

Your First Login

After logging in, you land on the home page. Your avatar and display name appear in the top-right corner. Click your avatar to access Profile, Settings, Billing, and Log Out.

Free accounts have access to the Landing page, the full 50-lesson Trading Academy, and basic market data. To unlock the Dashboard, Signals, Whale Tracking, and advanced tools, you will need to upgrade your tier. See the Pricing & Tiers section for a full breakdown.

Onboarding Checklist

New users see a small onboarding checklist widget in the bottom-right corner. It guides you through the key steps to get the most out of the platform:

• Explore the Dashboard
• Check the latest ML Signal
• Read an Intelligence Brief
• Link your wallet
• Browse the Trading Academy

Each step checks off automatically as you complete it. The checklist dismisses once you have completed all steps (or you can close it manually).

Navigating the Platform

Desktop header: The top navigation bar shows all major sections - Learn, API, Dashboard, Intel, Whales, Signals, Terminal, Strategies, Pricing. Click any item to navigate directly.

Mobile: On smaller screens, the navigation collapses into a hamburger menu (top-left). Tap it to reveal the full navigation drawer.

Command Palette: Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) to open the command palette. This lets you fuzzy-search and jump to any page or action instantly. Navigate with arrow keys, press Enter to go.

Footer: The footer on every page links to Discord, API Documentation, and Legal pages. It also shows the Cmd+K shortcut hint.

Dashboard

OverviewObserver+

The Dashboard is your command center. It aggregates real-time data from every subsystem into a single view: THEIA signals, market structure, whale positions, liquidation data, technical analysis, and the latest intelligence brief. All data is for BTCUSDT by default.

At the top of the Dashboard, you will see a real-time metrics strip showing key numbers at a glance: taker buy %, order book imbalance %, basis (contango/backwardation), bid/ask depth in millions, and 24-hour liquidation totals.

Two small indicators in the header - SIG and MKT - show the WebSocket connection status for signal and market data feeds. Green = connected. Gray = disconnected or reconnecting.

THEIA Signal Panel

The THEIA Signal Panel displays the current directional signal: LONG, SHORT, or NEUTRAL. It includes:

• Direction: Large colored indicator - green for LONG, red for SHORT, gray for NEUTRAL.
• Confidence: Percentage (0-100%) indicating model certainty. Higher = stronger conviction.
• Source: Badge showing whether the signal comes from "THEIA ML" (neural network) or "Heuristic" (rule-based fallback).
• Timestamp: When the signal was generated. Signals update every 60 seconds.
• Share button: Copies a formatted signal card to your clipboard for sharing.

Below the signal, a confidence timeline chart shows the last 48 signals as an area chart, so you can see how confidence has evolved over time.

Market Structure

The Market Structure panel shows real-time microstructure data aggregated across exchanges:

• Verdict: Overall assessment - Bullish, Bearish, or Neutral - based on the combined metrics below.
• Taker Ratio: % of volume from aggressive buyers vs sellers. Above 50% = buyers dominating.
• Order Book Imbalance: Net difference between bid and ask depth. Positive = more bids (buying pressure).
• Bid/Ask Depth: Total USD value of bids and asks in the aggregated order book (in $M).
• Basis: Futures premium/discount vs spot. Positive = contango (futures above spot). Negative = backwardation.

Market Regime Strip

The regime strip provides a multi-timeframe market assessment across three horizons:

• Short (1-4h): Risk-On / Risk-Off / Ranging - derived from taker ratio and order book imbalance.
• Medium (1-7d): Bullish Trend / Bearish Trend / Choppy - derived from signal direction and confidence.
• Macro: Correlated / Diversified / Transition - from the Spectral Disk eigenvalue analysis.

Technical Analysis

The TA panel shows calculated indicators for the current symbol:

• RSI(14): Relative Strength Index. Above 70 = overbought, below 30 = oversold.
• ATR%: Average True Range as a percentage of price - measures volatility.
• Trend Bias: Derived from EMA stack alignment (short/medium/long moving averages).

Real-time TA alerts appear as badges when notable conditions are detected: "Overbought", "Oversold", "Near Support", "Near Resistance", "High Volatility".

Whale Tracker (Dashboard)

A compact view of the top whale positions ranked by liquidation risk. Shows wallet (truncated), symbol, side, notional USD, leverage, and distance to liquidation. Color-coded: green (>15% safe), amber (5-15% caution), red (<5% danger).

Liquidation Dashboard

Shows 24-hour aggregated liquidation data: total long liquidations ($M), total short liquidations ($M), long/short ratio, and the top liquidation clusters by price level. Clusters indicate where large groups of leveraged positions would be force-closed.

Intel Brief (Dashboard)

A compact preview of the latest intelligence brief, including the date, overall sentiment badge, and a snippet of the synthesized content. Click through to the full Intelligence page for the complete report.

Draggable Grid Layout

Dashboard panels can be rearranged by dragging. Your custom layout persists across sessions (saved to localStorage). This allows you to prioritize the panels most relevant to your workflow - put THEIA signals front and center, or lead with whale data if that's your edge.

ML Signals

How THEIA WorksTrader+

THEIA is Aleph Terminal's proprietary neural network model. It analyzes 52 features extracted from real-time market data - including orderflow, taker buy/sell ratios, funding rates, liquidation clusters, order book depth, basis, and CoinGlass aggregated data - to generate directional trade signals for BTCUSDT every 60 seconds.

Each signal includes a direction (LONG / SHORT / NEUTRAL), a confidence score (0-100%), and the full feature vector that produced it. The model was trained on historical 5-minute data with asymmetric take-profit/stop-loss targets.

Signal Display

The Signals page opens with a large "hero" display: a directional arrow (up for LONG, down for SHORT, dash for NEUTRAL), the signal name, confidence percentage, source badge (THEIA ML or Heuristic), and timestamp.

Below this, a stats strip shows: total signals tracked, average confidence, win rate (if enough data), and the current signal source.

Copy Trade Setup

When a signal has confidence of 55% or higher and is not NEUTRAL, a "Copy Trade" card appears with actionable parameters:

• Entry Price: Approximate current mark price from the market context data.
• Target Range: A range, not a single price - low end at +0.30% (conservative exit), high end at +0.65% (let it run). The recommendation is to scale out in tiers within this range.
• Stop Loss: -0.50% from entry. This is intentionally tight with an asymmetric TP/SL ratio.

A "Copy" button copies the entire setup (direction, entry, targets, stop loss) as formatted text to your clipboard, ready to paste into your exchange or trading journal.

Performance Tracking

Once at least 3 signals have been tracked with outcomes, a Performance Summary appears showing: win rate %, total PnL %, best trade, worst trade, and maximum winning/losing streak. Performance is calculated against the TP/SL parameters described above.

Signal Log Table

A filterable table showing the full signal history. Filter by direction: All, Long, Short, or Neutral. Columns include: timestamp, direction (colored arrow), confidence %, source, and outcome (PnL % or TP/SL hit indicator).

Market Context & Features

Below the signal log, the "Market Context" panel reveals the first 10 features from the model's input vector at the time of signal generation. These include indicators like RSI, ATR, EMA crossovers, VWAP deviation, basis, taker ratio, and more. This transparency lets you understand why the model made its decision.

A "Signal Strength" chart visualizes the last 24 signals as stacked bars - long confidence vs short confidence - giving you a visual feel for recent directional bias.

Intelligence Briefs

What Are BriefsObserver+

Intelligence briefs are AI-generated market reports synthesized from multiple data sources. Each brief provides a comprehensive snapshot of market conditions, key developments, technical levels, and actionable insights. Briefs are generated daily and cover the entire crypto market with a focus on BTC.

Browsing the Archive

The Intelligence page uses a two-panel layout. The left sidebar lists all available briefs, showing the date, sentiment badge, and brief type for each. Click any brief to load its full content in the right detail panel. Up to 20 briefs are loaded on demand as you scroll.

Brief Sections Explained

Each brief is broken into named sections. Common sections include:

• Market Context: Macro conditions, recent price action, volume analysis.
• Key Levels: Support/resistance zones, liquidation clusters, and price targets.
• Technicals: Indicator readings, chart pattern analysis.
• Sentiment: Market sentiment from funding rates, open interest changes, social signals.
• Actionable Insights: Synthesized recommendations and watch items.

Briefs also include a list of keywords for quick scanning.

Sentiment Analysis

Each brief carries an overall sentiment label: Bullish (green), Bearish (red), or Neutral (gray). This is derived from the aggregate of all data sources analyzed during brief generation.

Whale Tracking

How Whale Tracking WorksTrader+

Aleph Terminal monitors large positions across exchanges (currently focused on Hyperliquid) in real-time. "Whales" are accounts with significant open positions. We track their size, leverage, entry price, liquidation price, and distance to liquidation - giving you visibility into where the big money sits.

Position Table

The main table lists all tracked whale positions with columns: wallet address (truncated to first/last 4 characters), symbol, side (LONG/SHORT), notional value in USD, leverage multiplier, entry price, liquidation price, and distance to liquidation (%).

A summary strip at the top shows aggregate stats: total tracked whales, long/short count, total notional ($M), average leverage, and the minimum distance to liquidation across all tracked positions.

Liquidation Risk

The Liquidation Risk panel highlights the top 8 whales closest to being liquidated. Each row includes a Unicode progress bar showing distance to liquidation, color-coded:

• Green (>15%): Safe - comfortable distance from liquidation price.
• Amber (5-15%): Caution - getting close. Watch for volatility spikes.
• Red (<5%): Danger - imminent liquidation risk. Price is very close to their liquidation level.

Liquidation Magnets

Liquidation magnets are price levels where large clusters of liquidations exist. The market tends to be "attracted" to these levels because cascading liquidations create momentum. The magnets table shows: symbol, magnet direction (UP = longs would get liquidated above, DOWN = shorts below), cluster price, cluster value ($M), and distance from current price.

Whale Clusters

Whale clusters show where multiple large positions are concentrated at similar price levels. This indicates areas of strong conviction - many whales entered at the same price zone. The table shows: symbol, price midpoint, side (LONG/SHORT), total value ($M), and number of positions in the cluster.

Market X-Rays

What Are X-RaysPro+

Market X-Rays provide institutional-grade order book depth visualization as a 2D heatmap. This is similar to tools used by professional market makers and proprietary trading firms to visualize where liquidity sits across price and time.

Reading the Heatmap

The heatmap displays a grid where:

• X-axis: Price levels (horizontal).
• Y-axis: Time periods (vertical, newest at top).
• Green cells: Bid depth (buy orders). Brighter = more liquidity.
• Red cells: Ask depth (sell orders). Brighter = more liquidity.

Bright clusters indicate strong support/resistance zones or liquidation levels. Thin or dark areas indicate low liquidity - price can move quickly through these zones.

Symbol & Timeframe Controls

Toggle between BTC, ETH, and SOL using the symbol buttons at the top. Select a timeframe: 1m, 5m, 15m, or 1h. Shorter timeframes show more granular order book snapshots; longer timeframes show how liquidity evolves over time.

Interpretation Guide

What to look for:

• Bright green walls: Strong buy-side support. Price tends to bounce here.
• Bright red walls: Strong sell-side resistance. Price tends to stall here.
• Moving walls: If a bright band shifts over time (moves up or down on the Y-axis), someone is "spoofing" or repositioning large orders.
• Voids: Dark areas between walls are low-liquidity zones. If price breaks through support/resistance, it can gap quickly through a void.

Spectral Disk

What Is Spectral AnalysisPro+

The Spectral Disk applies Random Matrix Theory (RMT) to the cross-asset correlation matrix of crypto assets. It decomposes the correlation matrix into eigenvalues and compares them against the theoretical noise threshold (Marchenko-Pastur distribution) to separate genuine market signals from random noise.

This is the same technique used by quantitative hedge funds to detect regime changes, systemic risk, and hidden correlations.

Reading the Chart

The chart plots eigenvalues (Y-axis) against their index (X-axis). Each dot represents one eigenvalue from the decomposed correlation matrix:

• Cyan dots (above MP boundary): Signal eigenvalues - these represent genuine, statistically significant correlations between assets.
• Gray dots (below MP boundary): Noise eigenvalues - these fall within the random noise range and should be ignored.

A shaded region between the MP upper and lower bounds represents the "noise band" - eigenvalues that could be explained by random chance.

Regime Detection

Based on the number and magnitude of signal eigenvalues, the system classifies the current market into one of three regimes:

• Correlated: Many large signal eigenvalues. Assets are moving together. Higher systemic risk. Diversification is less effective.
• Diversified: Few or small signal eigenvalues. Assets are moving independently. Lower systemic risk. Good diversification.
• Transition: Mixed signals. The market is shifting between regimes. Exercise caution.

Marchenko-Pastur Boundary

The dashed line on the chart represents the Marchenko-Pastur upper bound - the theoretical maximum eigenvalue you would expect from a purely random correlation matrix of the same dimensions. Any eigenvalue above this line is statistically significant. The stats grid below the chart shows the MP upper bound, number of signal eigenvalues, number of assets analyzed, and current regime.

Pro Terminal

Terminal LayoutPro+

The Pro Terminal is a comprehensive multi-panel trading workspace that combines every analytics tool into a single configurable screen. It is designed for serious traders who want all their data visible simultaneously - like a Bloomberg terminal for crypto.

The layout uses a 12-column responsive grid. On desktop, panels tile in a logical arrangement. On mobile, they stack vertically.

Panel Reference

The Terminal includes the following panels (all visible by default):

• THEIA Signal: Current direction, confidence %, source, timestamp.
• Confidence Timeline: Last 48 signals as area chart.
• Market Structure: Taker buy %, imbalance %, depth, basis.
• Market Regime: 3-level regime assessment.
• Liquidations: Top clusters, 24h totals, L/S ratio.
• Whale Tracker: Top whales by risk, magnets.
• Intel Brief: Latest brief snippet.
• Liquidity Heatmap: Full-width 1h orderbook heatmap.
• Position Calculator: Interactive position sizing tool (toggle on/off).

Hiding & Showing Panels

Click the settings gear icon in the Terminal header to reveal the panel visibility controls. Each panel has a toggle - switch it off to hide the panel, switch it on to show it. Your visibility preferences are saved to localStorage and persist across sessions.

Each panel also has an individual "eye-off" icon in its header - click it to hide just that panel. Use the "Reset" button in settings to restore all panels to their default visibility.

Fullscreen Mode

Click the fullscreen button in the Terminal header to enter browser fullscreen mode. Press Escape to exit. Fullscreen is especially useful for multi-monitor setups where you dedicate one screen entirely to the Terminal.

Position Calculator

The Position Calculator is an interactive tool for computing position sizes based on your risk parameters:

• Capital: Enter your total trading capital in USD.
• Risk %: What percentage of your capital you are willing to risk on this trade.
• Entry Price: Your planned entry price.
• Stop Loss: Your planned stop loss price.

The calculator outputs: notional position size (USD), implied leverage, and alerts if leverage exceeds safe thresholds.

WebSocket Status

The SIG and MKT indicators show real-time connection status. Green = live data flowing. Gray = disconnected (the system will auto-reconnect). If both indicators stay gray, check your internet connection or try refreshing the page.

Strategy Builder

Visual Strategy EditorPro+

The Strategy Builder is a visual, node-based editor for designing automated trading strategies. Instead of writing code, you drag nodes onto a canvas, connect them with edges, configure parameters, backtest, and optionally deploy to live trading.

Click "New Strategy" to open the full-screen editor. If you have existing strategies, they appear as cards on the landing page.

Node Types

Nodes are grouped into categories:

• DATA (blue): Price feeds, volume data, funding rates - the inputs to your strategy.
• SIGNAL (amber): Indicators and signals - RSI, MACD, EMA crossovers, volume spikes, custom conditions.
• LOGIC (violet): Combinators - AND gates, OR gates, thresholds, timers, filters.
• ACTION (red): Order types - market order, limit order, bracket order (entry + TP + SL).

Drag nodes from the left sidebar palette onto the canvas. Click a node to open its configuration panel on the right, where you set parameters (e.g., RSI period, threshold values, order size).

Connecting Nodes

Nodes have input and output ports (small circles on left/right edges). Drag from an output port to an input port to create a connection. Connections are color-coded by the source node's category. The flow goes left-to-right: Data feeds into Signals, Signals feed into Logic, Logic triggers Actions.

You can zoom (0.2x to 3x), pan the canvas, and use the minimap in the top-right for orientation. Nodes snap to a 16px grid for clean alignment.

Backtesting

Once your strategy is wired up, click "Backtest" in the toolbar. The bottom panel shows compilation status, and if successful, runs the strategy against historical data. Results include an equity curve chart, trade log table, and key metrics (total return, max drawdown, Sharpe ratio, win rate).

Deploying Live

After backtesting, click "Deploy" to open the deployment modal. This connects your strategy to a live trading execution layer. Follow the modal's instructions to configure API keys, position sizing limits, and risk parameters before going live.

Trading Academy

Curriculum OverviewFree++

The Trading Academy is a 50-lesson comprehensive curriculum that takes you from absolute beginner to advanced trader. It covers over 50 hours of reading material across 4 parts. Part 1 (Foundation) is free for all users. Parts 2-4 require an Observer, Starter, or Pro tier subscription respectively.

The 4 Parts

• Part 1 - Foundation: Mindset, tools, market structure. Learn how crypto markets work, what exchanges are, how orderbooks function, and the psychological foundations of successful trading.
• Part 2 - Strategy: Narratives, risk management, research methodology. Learn how to identify setups, size positions correctly, manage risk per trade, and build a repeatable research process.
• Part 3 - Execution: Entries, exits, trading psychology, and advanced techniques. Learn how to execute trades cleanly, manage emotions during drawdowns, and refine your edge with real examples.
• Part 4 - Mastery: Building your edge, continuous improvement, portfolio construction. Learn how to evolve as a trader, compound your edge, and build sustainable, long-term profitability.

Lesson Format

Each lesson is a dedicated page with full-length written content. Lessons show an order number, title, description, and estimated reading time. Content is rendered as rich text with examples, charts, and practical exercises where applicable.

Account & Settings

Profile Management

Visit Profile to view and manage your identity. Your profile shows: avatar (from GitHub or initials fallback), display name, GitHub username (with link), current tier badge, and any linked wallets with identity badges.

To change your display name, go to Settings and edit the "Display Name" field, then click Save.

Linking Wallets

You can link both an EVM wallet (Ethereum, Polygon, etc.) and a Solana wallet to your account. Linking a wallet does not give Aleph Terminal any control over your funds - it simply associates the address with your account for identity and future on-chain features (like x402 payments).

To link a wallet: go to Profile or Settings, click the wallet section, and follow the prompts to connect via MetaMask/Rabby (EVM) or Phantom (Solana). To unlink, use the "Manage" link next to the wallet address in Settings.

Billing & Subscriptions

Visit Billing to see your current plan and manage your subscription. Payments are processed through Stripe. Click "Manage Subscription" to open the Stripe billing portal where you can:

• Update your payment method
• View invoice history
• Cancel or downgrade your plan
• Switch between monthly and annual billing

Annual plans offer a 20% discount. When you upgrade, the change takes effect immediately. When you downgrade or cancel, you retain access until the end of your current billing period.

Settings Page

The Settings page is organized into sections:

• Profile: Edit display name, view GitHub username and email (read-only).
• Subscription: Current plan badge, Manage Billing button, Upgrade button.
• Linked Wallets: EVM and Solana addresses (truncated), Manage links.
• Legal: Quick links to Terms of Service, Privacy Policy, Risk Disclosure, Disclaimer, and Refund Policy.
• Account (Danger Zone): Log Out button.

Pricing & Tiers

Aleph Terminal uses a 5-tier subscription model. Each tier unlocks progressively more features. Annual billing saves 20% on all paid tiers.

Free Tier

Access the landing page, the full 50-lesson Trading Academy, and basic market data. No payment required. Create an account to get started.

Observer ($29/mo or $279/yr)

Unlock the Dashboard, delayed ML signals, intelligence briefs, and basic API access.

Starter ($99/mo or $949/yr)

Unlock real-time ML signals via WebSocket, whale tracking, and priority support.

Pro ($299/mo or $2,869/yr)

The most popular tier. Unlock Market X-Rays, Spectral Disk, the Pro Terminal, and the Strategy Builder.

Quant ($1,997/mo or $19,170/yr)

For teams, institutions, and power users. Unlimited API access, dedicated account manager, custom integrations, and auto-generated API keys.

Education Access by Tier

The Trading Academy content unlocks progressively with your subscription tier:

• Free: Part 1 - Foundation (12 lessons)
• Observer+: Part 2 - Strategy (12 lessons)
• Starter+: Part 3 - Execution (13 lessons)
• Pro+: Part 4 - Mastery (13 lessons)

Feature Comparison Matrix

For a detailed side-by-side comparison of what each tier includes, visit the Pricing page. The feature matrix there shows 16+ features across all 5 tiers with check/minus indicators, so you can see exactly what you get at each level.

Keyboard Shortcuts

Command Palette

Press Cmd+K (Mac) or Ctrl+K (Windows/Linux) to open the command palette. This is the fastest way to navigate the platform.

The palette searches across two categories:

• Pages: Dashboard, Signals, Intelligence, Whales, Terminal, Strategy Builder, X-Rays, Spectral, Learn, API Docs, Pricing, Settings.
• Actions: Join Discord, Toggle Fullscreen.

Use Arrow Up/Arrow Down to navigate results, Enter to select, Escape to close.

TV Mode

TV Mode turns the platform into a rotating display optimized for wall-mounted monitors or desk screens. It cycles through key panels (THEIA Signal, Market Structure, Whale Dashboard, Spectral Disk) at configurable intervals.

Controls in TV Mode:

• Left Arrow / Right Arrow - Previous / Next panel.
• Click the interval dots at the bottom to jump to a specific panel.
• Click the interval button to cycle through rotation speeds: 15s, 30s (default), 60s.
• Escape - Exit TV Mode.

TV Mode automatically enters browser fullscreen for maximum screen real estate.

Theme Toggle

Click the sun/moon icon in the header to switch between Dark and Light themes. Your preference is saved and persists across sessions.

Fullscreen

Several areas support fullscreen: the Pro Terminal has a dedicated fullscreen button, and TV Mode enters fullscreen automatically. Press Escape to exit fullscreen in any context.

API Reference

Authentication

The API uses API key authentication. Include your key in the X-API-Key header with every request. API keys are issued on request - DM us on Discord with your use case and expected volume. Quant tier subscribers get automatic API key generation.

Base URL: https://api.alephterminal.xyz

Endpoints Overview

For the complete API documentation with request/response examples in cURL, Python, and JavaScript, visit the API Docs page. Key endpoints include:

WebSocket Feed

The WebSocket feed at wss://api.alephterminal.xyz/ws/signals provides real-time signal updates. After connecting, send an authentication message:

{"type": "auth", "api_key": "YOUR_KEY"}

Once authenticated, you will receive signal updates as JSON messages whenever a new signal is generated (approximately every 60 seconds).

Rate Limits

Rate limits vary by tier. Exceeding your rate limit returns HTTP 429. Quant tier has unlimited API calls. For specific limits per tier, visit the Pricing page or contact us on Discord.

FAQ & Troubleshooting

General Questions

Signal Questions

Billing Questions

Technical Issues