👋 Welcome to HyperBot

HyperBot trades your own Hyperliquid account for you. Your funds never leave your wallet: you grant the bot a Hyperliquid API agent that can place and cancel orders, and nothing else. It cannot withdraw, transfer or move your money.

Every account is fully isolated. Your traded pairs, your strategy, your parameters, your caps and your history are yours alone — you start from the strategy defaults, never from anyone else's settings.

The short version

• The bot reads the market every few seconds and grades each setup from 0 to 1. Below your confidence threshold, it does nothing.
• A news and macro layer can shrink a position, refuse it, or let one through that the trend filter would have rejected.
• Every entry ships with a stop-loss and a take-profit placed on the exchange, so they survive even if the bot goes down.
• This dashboard refreshes over WebSocket — no reload needed. Prices tick every second, positions on each loop.

⚡ Your subscription

Three plans. They differ in how many positions you can hold at once, which strategies you can run, and whether you get the full settings panel and the backtester.

Six-month and yearly terms are discounted (roughly −15% and −25%). Your current plan, your licence expiry and an upgrade button sit at the top of this page.

What is not capped by your plan

Position size. There is no tier limit on it — the real gate is your own balance, checked with a safety buffer before each entry.

🔗 Connecting your account

Four steps, once. After that the bot runs on your account until you stop it.

1 · Create an API wallet on Hyperliquid

In the Hyperliquid app, generate an API wallet (agent) for your account. An agent can place and cancel orders on your behalf; it can never withdraw or transfer funds.

2 · Link it here

Open My account and paste your master account address and the agent private key. The key is encrypted server-side and is never stored in clear text. Until this is done, the bot has no way to trade and Authorize stays blocked.

3 · Fund the account

Your USDC stays on Hyperliquid, in your own account. The engine skips any account whose balance is below the minimum needed for your configured position size.

4 · Authorize

Press ⚡ Authorize bot (sign). Your wallet signs a consent message — no transaction, no gas. From there the bot starts trading your account on the next loop.

🧭 Navigation

• Home — status, balance, equity, PnL, statistics, open positions and scores
• Performance — stats by day and by month, the PnL calendar, strategy ranking and the fundamental-impact breakdown. Filterable by symbol, strategy, confidence and date.
• Strategy — where your PnL comes from, split by exit reason (TP / SL / trailing / signal / manual)
• Trade history — every recent closed trade, with fees and maker/taker
• News — the headline feed the bot reads, with its impact rating
• Fundamental — per-asset quality & news watchlist, market sentiment and the macro risk regime
• Logs — full activity log, filterable by level
• My account — your link, your authorization, your trading settings and your plan
• Strategy settings — the full parameter panel and the Backtest tab (Pro and Elite)

The bottom bar carries the runtime meta: mode, active strategy, market sentiment (Fear & Greed + VIX), any announced maintenance, the local clock with world exchange hours, uptime and latency.

🟢 Bot statuses

Shown at the top of Home and via the dot next to the logo.

💰 Reading the numbers

• Available balance — uncommitted funds available to open new positions
• Total equity — balance + market value of open positions
• Unrealized PnL — floating gain/loss on positions still open
• Realized PnL (session) — cumulative gain/loss since the bot started
• Green means a gain, red a loss

📡 Prices & market data

• Top ticker — every pair on the watchlist
• "Live prices" card — only the pairs currently enabled for trading on your account, with their timeframe and, when you override it, the strategy running on that pair (BB-MR, EMA, RSI…)
• 24h change — anchored on Hyperliquid's prevDayPx, so it matches the exchange exactly

Candles arrive over a WebSocket subscription per pair and are the same series the strategy grades. The timeframe is global to your account, not per pair.

📌 Positions & trade history

An open position shows its side, size, leverage, entry, current price, unrealized PnL and both protective levels.

Tags you may see on a position

• −50% — the fundamental filter halved the size because the news or the macro window opposed the trade. Hovering it says which of the two, and on what evidence.
• BYPASS — the trend filter would have refused this entry; a strong, sustained news score aligned with the trade let it through.
• MANUAL — you opened it yourself on the exchange. The bot displays it but keeps it out of its own statistics.

Closed trades

Each row carries the real exit price and net PnL read from your fills, the fees, whether entry and exit filled as maker or taker, and the exit reason. Hyperliquid's fills index can lag its clearinghouse by several seconds — when that happens the row is repaired a few minutes later rather than left with a stale price.

🏁 Performance

Everything on this tab respects the filter bar: symbol, strategy, minimum confidence and date range. Two blocks deliberately ignore the dates and always cover your full history — the PnL calendar and Monthly stats.

Stats worth knowing

• % return — net realized PnL ÷ equity at the start of the window
• Profit factor — gross wins ÷ gross losses. Above 1 means the wins pay for the losses.
• Sharpe ratio — per-trade mean ÷ standard deviation, scaled by √n
• Maker / taker — the share of notional filled as a resting order. Maker costs 0.015% against 0.045% taker, so higher is cheaper.

Fundamental impact

The last block on the tab answers "what did the news layer actually change?". Filter it by the kind of impact:

• −50% macro — halved by a macro risk-off window, both directions
• −50% news — halved because the news opposed the trade's direction
• Bypass — entries the trend filter would have refused, taken on the news score. This is where you see whether the bypass earns its keep.
• Blocked — every entry the bot refused: news filter, disabled pair, risk limit or a failed order. No position, so no PnL — only a count and a reason.

🔔 Notifications

The bell collects what happened while you were not looking: positions opened and closed, macro events on the calendar, and every entry the bot refused with its reason.

The feed is persisted, not held in memory, so a restart no longer wipes it. The unread dot is driven by timestamps rather than row ids, which is what makes it survive a restart correctly.

Refused entries are also counted exactly — repeated refusals on the same pair each count, where the feed itself only shows one every 15 minutes to stay readable.

🛡️ Quality score

A 0–100 health rating per asset, separate from the news direction. Crypto reads free on-chain fundamentals; TradFi commodities/indices read CFTC COT positioning & trend. The enriched composite now also modulates trading — it amplifies entries aligned with strong fundamentals and trims those that oppose them.

Data-less assets (e.g. SpaceX) get a global LLM estimate, flagged ≈ (no pillar bars), which still feeds trading by design.

📊 Directional & macro scores

The bot continuously reads live news and an economic-events feed and turns them into numbers that nudge position sizing and can veto a trade. There are two of them — a per-asset directional score (the single number shown per asset) and a global macro risk-off penalty (surfaced as a separate flag when active, since it is not a direction).

📰 News feed

The News drawer shows headlines with a real RSS image (or a generated tile fallback). Impact is shown as a coloured outline on the card, and an LLM filters each item for relevance and sentiment before it is displayed.

• Toggle High impact only to keep the market-movers
• All vs Fundamental tabs split generic news from asset-specific stories

Headlines are pre-filtered by keyword before any model sees them, then classified in batches — that is what keeps the reading current without an unbounded LLM bill. When no model is reachable, the bot falls back to a lexicon rather than going blind.

😨 Market sentiment

Two crowd gauges, shown both in the bottom bar and in full on the Fundamental tab. They are context only — neither of them can open or refuse a trade on its own.

Crypto Fear & Greed

A 0–100 reading from alternative.me: 0 is extreme fear, 100 extreme greed. The card shows today's value with its classification plus the readings from yesterday, last week and last month, so you can see which way the crowd is moving rather than just where it stands.

VIX

The TradFi fear gauge, from Yahoo Finance: the level, the change against the previous close, and a 30-session sparkline. A rising VIX is risk-off, which is why the change is coloured red when it goes up — the opposite of a normal quote.

Where these do matter is inside the macro risk regime: the VIX is one of the measured inputs behind the quantitative half of that score.

🧩 How a trade is decided

Every entry runs the same gauntlet. Any single gate saying no means no trade — and the refusal is recorded with its reason in Blocked orders.

1 · The strategy grades the setup

Your pair's strategy scores the current candle from 0 to 1. Below your confidence threshold, nothing happens. A higher threshold means fewer but stronger trades.

2 · The spread has to be sane

A pair whose bid/ask spread is wider than max_spread_pct is skipped: the edge would be paid straight to the book.

3 · The fundamental layer weighs in

• A strong news score opposing the trade blocks it outright.
• A weaker opposition, or an active macro risk-off window, halves the size instead.
• A strong, sustained aligned score can do the reverse: let an entry through that the trend filter would have refused (the bypass). The score has to have held past the threshold for the whole window — a spike is not enough.

4 · Risk has the last word

Position count against your plan's cap, daily-loss guardrail, per-pair enable switch, leverage cap and the balance check with its buffer. Then the order goes out, and the stop-loss and take-profit are placed on the exchange immediately after the fill.

🌲 Strategies — overview

Each pair runs one strategy. Starter runs the first three; BBReversion needs Pro or Elite. Pick yours in My account, or per pair in Strategy settings:

Every entry must clear a confidence threshold. Each strategy grades the current setup on a 0–1 scale and opens a trade only when that grade reaches its own min_confidence_* value (unset → the global min_confidence). A higher threshold means fewer but stronger trades; a lower one means more but looser trades. You set it in Strategy settings.

Each strategy has its own page in the sidebar. The worked examples there all assume the threshold is set to 0.70.

📈 EMABreakout

Trend breakout · threshold key min_confidence_ema · available on every plan.

🔄 RSIMeanReversion

Range fade · threshold key min_confidence_rsi · available on every plan.

🕯️ ChandelierZLSMA

Trend following with a built-in trail · threshold key min_confidence_ce · available on every plan.

🎈 BBReversion

Bollinger mean reversion · threshold key min_confidence_bb · Pro and Elite only. This is the strategy the reference account runs.

🎯 Risk & exits

Every position is bracketed on the exchange from the moment it fills, and the bot never widens a stop — it only ever moves it in your favour.

The protective orders

• Stop-loss and take-profit are real exchange orders, placed right after the entry fill. They stay armed if the bot restarts or goes offline.
• Both are re-anchored to the actual fill price. If the market moves between the signal and the fill, the distance you intended is preserved instead of landing on the wrong side of the entry.

Adaptive trailing stop

• The trailing distance is sized per pair from its own volatility (ATR-based), so a calm pair trails tighter and a volatile one gets room to breathe.
• It never locks in a loss: it only starts moving once the position is in profit, and it only ratchets in the protective direction.
• Once it has moved your stop, an exit at that level is reported as TRAILING rather than a plain SL, so the Strategy tab can show you what the trail actually captures — or gives back.

Guardrails

• Daily loss cap — exchange-side stop fills count toward it too, so a run of stop-outs really does trip it.
• Position cap — 2 on Starter, 10 on Pro, unlimited on Elite.
• Dead-man switch — if the trading loop ever stalls, the bot cancels its working orders. It leaves the stop-loss and take-profit of a live position alone.
• Manual positions — anything you open by hand is tagged and kept out of the bot's statistics, so your performance figures only reflect the bot's own trades.

⚙️ Strategy settings

The full parameter panel, on Pro and Elite. Starter gets a curated settings card in My account instead.

Everything you change here applies to your account only, and takes effect on the next order — roughly a second later. Nothing you touch can affect anyone else's account, and you always start from the strategy defaults.

What you can set

• Global — position size, leverage, confidence threshold, maximum spread, daily loss cap, trailing and break-even.
• Per strategy — the indicator parameters of whichever strategy you run.
• Per pair — enable or disable it, and override its strategy, leverage and position size. Disabling a pair blocks new entries; it never closes what is already open.

⏪ Backtest

Replay your parameters over past data before you commit real money. The Backtest panel lives in Strategy settings — Pro and Elite.

• Pick a pair, a timeframe and a strategy, then run it over the last 180 days on Pro or 365 days on Elite. Fees, funding and leverage are all included.
• 10 runs a day on Pro, 30 on Elite. One simulation runs at a time, so the allowance is what keeps the queue fair.
• Live progress while it runs, and a Stop button.

⚡ Live control

Your on/off switch lives in My account.

• ⚡ Authorize bot (sign) — your wallet signs a consent message. No transaction, no gas. The bot starts trading your account on the next loop.
• 🛑 Stop bot on my account — one click. It stops opening new positions immediately and leaves your existing exchange stop-loss / take-profit orders in place, so anything still open stays protected.

Both act on your account only. If the bot is not trading you, the same page lists every reason why, so "authorized" can never look like "trading" when the engine is actually skipping you.

🛎️ Maintenance & status

Announced downtime — ours and Hyperliquid's own — appears in the bottom bar, just left of the clock. Click the warning triangle to fold the notice away; the choice sticks, and the triangle brings it back.

What a scheduled restart means for you

• Your open positions stay open. The exchange holds them, along with their stop-loss and take-profit, for the whole restart.
• The bot re-adopts them on the way back up and carries on managing them.
• New entries pause for the couple of minutes the restart takes.

Hyperliquid's own scheduled maintenances are read from their status page, so you see an exchange-side window in the same place as ours. A Details link opens their notice.

❓ FAQ

Can the bot withdraw my funds?

No. It holds a Hyperliquid API agent, which can place and cancel orders and nothing else. Withdrawals and transfers are impossible with an agent key.

What happens if the bot goes down while I have a position open?

Nothing changes on the exchange. Your stop-loss and take-profit are real orders sitting on Hyperliquid, and they stay armed. The bot picks the position back up when it returns.

Why did the bot not take a trade I expected?

Open Performance → Fundamental impact → Blocked. Every refusal is recorded with its reason: news opposition, disabled pair, risk limit, spread too wide or a failed order.

Why is a position half the size I configured?

The fundamental filter halved it — either a macro risk-off window or news opposing your direction. The position carries a −50% tag saying which, and on what evidence.

Can I trade manually on the same account?

Yes. Positions you open yourself are tagged MANUAL and excluded from the bot's statistics, so they never distort your performance figures.

Does changing a setting affect anyone else?

No. Pairs, parameters, caps and timeframe are scoped to your account.

Do I lose my settings if I upgrade my plan?

No. Upgrading raises your caps and unlocks modules; your configuration stays as it is.

📬 Contact & links

Hyperliquid   Bot Telegram

For any question or information request, contact us by email only at [email protected].