Documentation ← Back to App
Introduction

Hype Dashboard

Hype is a personal trading dashboard for Hyperliquid — a high-performance decentralised perpetuals and spot exchange. The entire dashboard runs in your browser with no backend required. It reads your wallet data directly from the Hyperliquid public API and connects over WebSocket for live price feeds.

No sign-in, no API keys, no server. Enter any wallet address — yours or anyone else's — and get a full read-only view of their portfolio, trades, funding history, and more.

🔒
Read-only and non-custodial. Hype never asks for your private key or signs any transactions. It only reads public data from the Hyperliquid API.
PropertyValue
Live URLravellerh.github.io/Hype
Data sourceHyperliquid public API + Binance Futures + CoinGecko
Tech stackVanilla JS, CSS custom properties, Chart.js (minimal), SVG sparklines
Real-timeHyperliquid WebSocket API
Exchange ratesfrankfurter.app (historical USD/IDR)
Backend requiredNo — optional Cloudflare Worker for edge caching
Setup

Getting Started

Open the dashboard at ravellerh.github.io/Hype. By default it loads a demo wallet. To view your own data:

  1. Click the wallet address in the top-right corner of the topbar.
  2. Paste your Hyperliquid wallet address (0x…).
  3. Press Enter — all tabs reload with your data.
💡
Your address is saved in localStorage so it persists across sessions. You can switch wallets any time — useful for tracking multiple accounts or watching a known trader.

Optional: Speed up loading with a Cloudflare Worker

If you're on a slow connection (common in Indonesia), deploy a Cloudflare Worker proxy to get edge-cached API responses. See the CF Worker Proxy section for instructions. Once deployed, paste your Worker URL in Live → API Proxy.

Technical

Architecture

The dashboard is a single-page application (SPA) with no build step. All logic lives in plain JavaScript files loaded by index.html.

Hype/
├── index.html          ← Entry point, tab shell
├── app.js              ← All tab logic, API calls, WebSocket, charts
├── ta-signal.js        ← TA engine: indicators, CVD, OI, signal scoring
├── analytics.js        ← PnL analytics, equity curve
├── intel.js            ← Research snapshot, macro intel
├── indicators.js       ← Fear & Greed, BMSB, Pi Cycle
├── nansen.js           ← Smart Money wallet tracking
├── mvrv-ai.js          ← MVRV Z-score, AI commentary
├── kb.js               ← Knowledge base & trade journal
├── position-meta.js    ← Per-position intent / thesis modal
├── logger.js           ← Data logger & portfolio snapshots
├── styles.css          ← All styles (single file, CSS variables)
├── sw.js               ← Service worker (PWA caching)
├── manifest.json       ← PWA manifest
└── worker.js           ← Cloudflare Worker proxy (optional, deploy separately)

All Hyperliquid API calls are POST requests to api.hyperliquid.xyz/info. The service worker only caches static assets — API responses are never cached by the browser (they use POST), which is why the optional Cloudflare Worker provides real TTL caching.

Cache layerHow it worksTTL
Service WorkerCaches static JS/CSS filesUntil SW update
In-memory (candles)_candleCache Map in app.js5 min
In-memory (meta)getMetaAndAssetCtxs._cache2 min
CF Worker edgeCloudflare cache near your location5 s – 10 min per type

Tabs Guide

Portfolio

💼

Portfolio Overview

Live data

The main account summary. Shows your total portfolio value, open perpetual positions, spot holdings, unrealized PnL, open orders, and a portfolio growth chart.

  • Total Portfolio — for unified accounts: spot USDC + unrealized perp PnL. For standard accounts: account value + spot value.
  • Health Score — composite risk score (0–100). Flags high leverage, low liquidation distance, smart money divergence, and BMSB signal.
  • Portfolio Chart — snapshots are saved to localStorage every time you load the tab. Switch between All / Perp / Spot views.
  • Open Orders — live order book pulled on each load.
⚠️
Unified accounts: Hyperliquid unified accounts hold USDC in spot as perp collateral. The crossMarginSummary.accountValue field is 0 — Hype correctly calculates total portfolio as spotTotalValue + perpUnrealizedPnL to avoid double-counting.

Trades

📋

Fill History

Complete fill history split into Perp and Spot sub-tabs. Shows 100 rows per view, sorted latest-first.

  • Coin filter — type any coin name to filter fills by asset.
  • Realized PnL — shown per fill. Positive = profit, negative = loss.
  • Win Rate — calculated from all visible fills. Shown in the stats strip at the top.
  • Fees — total fees paid across visible fills.
  • BUY / SELL labels — colored green for buys, red for sells.

Funding

💸

Funding Payments

Funding paid or received over 7 / 30 / 90 day windows. Funding is the recurring payment between long and short holders to keep perpetual prices anchored to spot.

  • Positive funding — market is bullish (longs pay shorts). If you're long, you pay; if short, you receive.
  • Negative funding — market is bearish (shorts pay longs). If you're short, you pay; if long, you receive.
  • Daily bar chart — net funding per day. Red bars = net cost, green = net income.
  • Cost-alert pills — positions with high daily funding cost are flagged.
  • Avg Rate column — annualised average funding rate per coin.
📌
Funding is charged every 1 hour on Hyperliquid. A position held for 30 days pays funding 720 times. The Funding tab shows the cumulative cost so you can see if a trade is being slowly bled by funding.

Flows

🏦

Deposit & Withdrawal History

Full ledger of all deposits and withdrawals. Each transaction shows the exact historical USD/IDR exchange rate at that date, fetched from frankfurter.app.

  • Running balance — cumulative net flow column shows how much capital you've put in vs withdrawn.
  • IDR value — each row shows the IDR amount at the transaction date. Useful for Indonesian tax reporting.
  • Cumulative chart — area chart showing capital flow over time.
💡
Historical rates are fetched once per session and cached. All unique dates are fetched in parallel, so loading is fast even for large transaction histories.

Live Monitor

Real-time WebSocket Feed

WebSocket

Real-time price monitor powered by the Hyperliquid WebSocket API. Prices update on every tick — no polling.

  • Live P&L — if you have open positions, current unrealized PnL updates in real-time.
  • Price sparklines — mini charts update as prices move.
  • Price Alerts — set above/below alerts for any coin. Triggers a browser notification and optionally Telegram when the condition is hit.
  • API Proxy settings — configure your Cloudflare Worker URL here.
  • Telegram settings — paste your bot token and chat ID to receive alerts on your phone.

Markets

🌐

Global Market Overview

Live data

Overview of all Hyperliquid perpetual markets. Sortable by volume, open interest, funding rate, or 24h change.

  • Volume — 24h trading volume in USD.
  • OI — total open interest in USD. High OI relative to volume can indicate a crowded trade.
  • Funding rate — current hourly funding rate (annualised). Extreme rates suggest crowding.
  • 24h % — price change from previous day.

Phases

🔵

Wyckoff Market Phase Detector

Automatically classifies each tracked coin into a Wyckoff market phase using candle data across the selected timeframe (1h / 4h / 1d).

PhaseMeaningSignal
🔵 AccumulationSmart money quietly buying. Price ranging. Volume low.Potential long setup
🚀 MarkupPrice trending up. Higher highs and higher lows. Volume expanding.Ride the trend
🟡 DistributionSmart money quietly selling. Price ranging at highs. Volume irregular.Reduce / avoid longs
🔻 MarkdownPrice trending down. Lower highs and lower lows.Avoid longs, look for shorts
⚪ NeutralNo clear phase. Insufficient signal strength.Wait for clarity

Below the phase cards, the CVD + OI Signal Table gives a quick buy/sell/neutral read per coin based on Cumulative Volume Delta and Open Interest momentum.

Expand any CVD card to see sparkline charts for Price, CVD, and OI history.

Intel

🧠

Research Snapshot

Static snapshot

A curated macro + on-chain research snapshot sourced from cryptowatch.id. Updated manually when new research is published.

  • Macro posture — overall market stance: BUY / WAIT / SELL with confidence score.
  • Regime radar — spider chart showing Macro, Cycle, OnChain, Derivatives, Funding, ETF, and Sentiment axes (0–10).
  • Evidence layers — breakdown of supporting evidence per analysis layer.
  • Cohort behavior — what LTH, ETF/TradFi, and Smart Money are doing.
  • Coin plays — specific setups and narrative bets from the research.
⚠️
Intel is a static snapshot — it does not update automatically. Check the snapshot_date at the top of the page and treat stale data accordingly.

MVRV

📊

MVRV Z-Score & Market Cycle

On-chain MVRV Z-Score — a market cycle indicator that compares Bitcoin's market value to its realised value, normalised by standard deviation.

Z-Score RangeZoneMeaning
> 7Extreme TopHistorically near cycle tops. Consider reducing exposure.
3 – 7ElevatedBull market. Risk increasing. Take partial profits.
0 – 3Fair ValueNeutral zone. Market healthy.
-2 – 0UndervaluedHistorically near cycle lows. Accumulation zone.
< -2Extreme BottomDeep value. Strong historical buy signal.

The MVRV tab also includes AI-generated market commentary that synthesises MVRV, Fear & Greed, BTC dominance, and current phase signals into a plain-English read of the macro environment.

AI

🤖

AI Trade Analysis

AI-assisted trade analysis that combines your current positions, TA signals, phase data, and market context into actionable commentary. Uses your configured AI provider (set in settings).

  • Portfolio debrief — review of your open positions with risk comments.
  • Market regime — plain-English summary of current market conditions.
  • Trade ideas — suggestions based on phase + signal confluence.

Watchlist

👁

Wallet Monitor

WebSocket

Monitor any Hyperliquid wallet address. Useful for tracking known traders or your own secondary accounts.

  • Add multiple wallet addresses to track.
  • Position changes trigger browser notifications.
  • Shows current open positions for each watched wallet.

Journal

📓

Trade Journal

localStorage

Personal trade journal stored entirely in your browser's localStorage. Log trade entries with notes, thesis, and outcome tagging.

  • Entry — coin, direction, entry price, size, leverage.
  • Thesis — free-text rationale for the trade.
  • Outcome — tag trades as WIN / LOSS / BREAKEVEN with exit price.
  • Notes — post-trade review and lessons learned.
⚠️
Journal data lives in localStorage only. It is not synced anywhere. Clear browser data = lose your journal. Export regularly.

Indicators

📈

Macro Indicators

On-chain and sentiment indicators that provide macro market context.

IndicatorSourceWhat it tells you
Fear & GreedAlternative.meCrowd sentiment. Extreme fear = potential buy. Extreme greed = potential sell.
BMSBCalculatedBull/Bear Market Support Band. Price above BMSB = bull structure. Below = bear.
Pi Cycle TopCalculatedWhen the 111d MA crosses above 2× the 350d MA, historically marks cycle tops.
MVRV Z-ScoreOn-chainSee MVRV tab.

Smart Money

🐋

Whale Wallet Signals

Aggregated signal feed from a curated list of top Hyperliquid traders. Shows what the best-performing wallets are positioned in right now.

  • Open positions of tracked whale wallets.
  • Recent trades from each wallet.
  • Consensus signal — when multiple whales are on the same side of a trade, it carries more weight.

Analytics

🔬

PnL Analytics

Deep-dive into your trading performance metrics derived from your fill history.

  • Equity curve — cumulative PnL over time.
  • Win/Loss streaks — longest winning and losing runs.
  • Fee breakdown — total fees by coin and over time.
  • Average win vs average loss — risk/reward ratio across your trades.
  • Best/worst coins — which assets you perform best on.

KB (Knowledge Base)

📚

Personal Knowledge Base

localStorage

A personal wiki for trading notes, playbooks, and research. Stored in localStorage. Write notes in Markdown — they render with formatting.

  • Create, edit, and delete articles.
  • Link articles to specific trades in your journal.
  • Tag entries for easy filtering.

How to Read

TA Signals

The TA signal dashboard (bottom of the Live tab, and accessible in Phases) runs a full technical analysis on up to 200 candles of the selected coin and timeframe. Each signal produces one of these badges:

BULL BEAR WARN NEUTRAL INFO
SignalIndicatorHow it's calculated
EMA BiasEMA 20 / 50 / 200Price above EMA20 > EMA50 = bull. Below = bear. EMA200 cross = strong signal.
MACDMACD(12,26,9)Histogram positive and rising = bull. Negative and falling = bear.
RSI (14)RSI 14-period>60 = bull momentum. <40 = bear momentum. >70 or <30 = overbought/oversold.
StochasticStoch(14,3,3)%K crosses above %D in oversold zone = buy signal. Below in overbought = sell.
Bollinger BandsBB(20, 2σ)Price near lower band = oversold. Near upper band = overbought. Squeeze = breakout incoming.
ATR VolatilityATR(14)High ATR relative to history = volatile. Low = quiet. Used for stop-loss sizing.
Funding RateHL APIPositive & high = longs crowded. Negative = shorts crowded. Extremes often mean-revert.
Open InterestHL APIRising OI + rising price = trend confirmed. Rising OI + falling price = potential squeeze.
L/S RatioBinance FuturesRatio > 1.5 = longs crowded. < 0.7 = shorts crowded. See Smart Money Flow section.
CVD + OICalculatedSee CVD + OI section below.

The Overall Signal at the top of the card is a weighted composite of all individual signals. It considers the direction and strength of each signal, with more weight given to higher-timeframe signals.

Wyckoff Phases

The Wyckoff method describes market cycles as four recurring phases. Hype's phase detector analyses price action, volume, and trend structure to classify each coin.

🔵Accumulation

Price is ranging in a base after a downtrend. Volume is low and declining. Smart money is absorbing supply from panic sellers. Best time to build a long position.

🚀Markup

Price is in a clear uptrend — higher highs, higher lows. Volume is expanding on up-moves. Ride the trend; tighten stops as it extends.

🟡Distribution

Price is ranging at highs after a markup. Volume is high and irregular. Smart money is distributing to late buyers. Reduce exposure; avoid new longs.

🔻Markdown

Price is in a clear downtrend — lower highs, lower lows. Volume expands on down-moves. Avoid longs; short if confident.

📌
Confidence score — each phase card shows a percentage confidence. Below 40% means the signal is weak. Wait for confluence with other timeframes before acting.

CVD + OI

Cumulative Volume Delta (CVD) tracks the net buying or selling pressure over time by summing the difference between buy-side and sell-side volume on each candle.

CombinationInterpretation
Price ↑ + CVD ↑ + OI ↑Strong bull — real buyers driving the move, open interest confirms conviction.
Price ↑ + CVD ↓Suspicious pump — price rising but sellers dominating. Could be short liquidations, not real buying.
Price ↓ + CVD ↓ + OI ↑Strong bear — real sellers driving the move with building short interest.
Price ↓ + CVD ↑Absorption — price falling but buyers absorbing. Possible accumulation / reversal setup.
Price flat + OI ↑Coiling — positions building with no price move yet. Potential breakout either direction.
Price ↑ + OI ↓Short covering — shorts closing, not new longs opening. Less reliable for continuation.

In the Phases tab, expand any CVD card to see the Price, CVD, and OI sparklines. CVD is shown with a zero baseline — the colored fill shows whether net flow is positive (green = net buying) or negative (red = net selling) over the visible period.

Smart Money Flow

The Smart Money Flow card synthesises three signals from Binance Futures data to detect institutional positioning:

SignalWhat it means
SMART ACCUMTop-20% traders net long + buy taker aggression. High-quality long setup.
SMART DISTTop-20% traders net short + sell taker aggression. Distribution signal.
SQUEEZE ↑Retail heavily short, smart money long — short squeeze risk is elevated.
SQUEEZE ↓Retail overleveraged long, smart money short — long squeeze risk.
FAKE PUMPRetail buyers aggressive, top traders short — potential bull trap.
CROWDED LONGRetail overleveraged long without smart money confirmation. Risky.
CROWDED SHORTRetail heavily short — watch for squeeze if a catalyst appears.

Features

IDR Conversion

All monetary values throughout the dashboard can be displayed in Indonesian Rupiah (IDR). Switch currency using the currency toggle in the topbar.

  • Live rate — current USD/IDR from the ECB/frankfurter.app.
  • Historical rates — in the Flows tab, each deposit/withdrawal shows the IDR value at the exact transaction date. Rates are fetched for all unique dates in parallel, cached for the session.
💡
The historical rate is useful for Indonesian tax reporting — you can see exactly how much IDR you put in and took out at each point in time.

Cloudflare Worker Proxy

Hyperliquid's API uses POST requests, which cannot be cached by browsers or CDNs. If you're on a slow connection, you can deploy a Cloudflare Worker as a caching proxy.

Deploy in 3 steps

  1. Go to dash.cloudflare.com → Workers → Create Worker.
  2. Paste the contents of worker.js from this repository.
  3. Deploy. Copy your Worker URL (e.g. https://hype.yourname.workers.dev).

Then in the dashboard: Live tab → API Proxy → paste URL → Save → reload page.

Request typeCache TTL
Candle snapshots5 minutes
Meta + asset contexts2 minutes
Spot metadata10 minutes
Account state / positions30 seconds
Open orders20 seconds
Fill / funding history60 seconds
All mid prices5 seconds
☁️
Cloudflare has 300+ edge locations worldwide. Your requests are served from the nearest data centre — typically reducing API round-trip time by 3–5× for users in Indonesia.

PWA / Install

Hype is a Progressive Web App. You can install it to your home screen on iOS, Android, and desktop — it behaves like a native app.

  • iOS — Safari → Share → Add to Home Screen.
  • Android — Chrome → ⋮ menu → Install App.
  • Desktop — Chrome address bar → install icon on the right side.

Once installed, the static assets (JS, CSS, fonts) are cached by the service worker. The app loads instantly even on a slow connection — only API data requires network access.

Alerts & Telegram Notifications

Price Alerts

Set price alerts from the Live tab. Enter a coin, select above/below, enter a price target, and click Set Alert. Alerts trigger browser notifications and optionally Telegram messages when the condition is hit.

Telegram Setup

  1. Create a Telegram bot via @BotFather — send /newbot, follow prompts, copy the token.
  2. Send any message to your new bot.
  3. In Hype: Live tab → Telegram Notifications → paste Bot Token → click Auto-detect Chat ID → Save.
  4. Click Send Test to confirm it works.
🔒
Your bot token is stored in localStorage only. It is never sent anywhere except directly to the Telegram API from your browser.

What triggers notifications

  • Price alert conditions (above/below target).
  • P&L milestone — configurable dollar threshold (e.g. alert every $500 gain/loss).
  • New order fills detected via polling.

Reference

FAQ

Why does my Total Portfolio show $0?

You likely have a Hyperliquid unified account. In this account type, your USDC lives in the spot wallet and is used as perp collateral — crossMarginSummary.accountValue is 0 by design. Hype detects this and calculates total portfolio as spot USDC balance + unrealized perp PnL.

Why is the Phases tab slow to load?

Phases fetches candle data for each tracked coin individually — by default BTC, ETH, SOL, and HYPE. Each coin requires a separate API call. Without a Cloudflare Worker proxy, these calls go to Hyperliquid's servers which may be geographically distant. Deploying the CF Worker proxy caches candle data for 5 minutes and typically makes phase loading 3–5× faster.

Is my data private?

Yes. Hype sends your wallet address directly to the Hyperliquid public API. All wallet addresses on Hyperliquid are public — the same data is visible to anyone who visits the Hyperliquid explorer. Journal and KB data lives in your browser's localStorage and is never transmitted anywhere.

The OI sparklines show "No OI history yet"

OI history comes from two sources: Binance's openInterestHist endpoint (fetched each time you load Phases), and a localStorage fallback that accumulates one point per load. If a coin isn't listed on Binance Futures (common for newer coins), only the localStorage history will be available — it builds up over multiple sessions.

Can I track someone else's wallet?

Yes — all Hyperliquid data is public. Enter any 0x… address in the wallet input at the top-right. The Watchlist tab is designed for ongoing monitoring of specific addresses with position-change alerts.

How do I add more coins to the Phases tab?

The tracked coins are defined in const PHASE_COINS in app.js. Edit this array to add or remove coins. Note that each additional coin adds one more API call on every Phases load.

My Journal / KB data disappeared

Journal and KB are stored in localStorage. Clearing browser data, using incognito mode, or clearing site data in DevTools will erase it. There is no backup. Export your data regularly using the export button in the Journal tab.