Skip to main content
Glama

Server Details

Hyperliquid analytics for AI agents: whale flow, liquidations, funding, risk, signed signals.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
johnsmithxy1mmm-sys/HyperliquidMCP
GitHub Stars
1
Server Listing
hypersignal
ChatGPT
–
Claude
–

TDQS

A3.8/5.0

Scored across 30 tools

Disambiguation4/5

Most tools target clearly different resources or actions: market data, account reads, alert CRUD, delivery channels, and premium-key flows are separable. A few adjacent analytics require reading descriptions to distinguish them, such as whale positions vs. whale flow alerts, funding screener vs. get markets, and trader report vs. smart-money score.

Naming Consistency5/5

All tools use the hl_ prefix and snake_case consistently. Names follow recognizable verb_noun or descriptive noun-phrase patterns such as get_, create_, delete_, list_, poll_, set_, link_, and _screener/_analytics.

Tool Count2/5

At 30 tools this is well past a comfortable scoped set, even for a broad analytics server. Several niche or premium tools such as HIP-3 analytics, Polymarket divergence, vault screener, and calibration add surface area that an agent must navigate around for core workflows.

Completeness4/5

The surface covers core market data, account/order reads, whale analytics, alerts, delivery channels, key/payment flows, and signal verification, with no major dead ends for an analytics-only server. Minor gaps remain: no alert update operation, no webhook/Telegram status listing, and fills are exposed only through trader report rather than a standalone endpoint.

Available Tools

30 tools
hl_buy_proBuy Pro (x402)AInspect

Buy 30 days of Pro (unlimited premium calls) for $29 in USDC, paid over x402 on Base. Without an X-API-Key it issues a new Pro key; with one it renews that key (a free key is upgraded in place), adding 30 days to its current end. The first call answers with the payment requirements; pay and retry with the X-PAYMENT header. The payment is taken only once the key is ready. No automatic refunds. If the answer says the payment could not be confirmed, do not pay again: quote its reference. How to pay: https://github.com/johnsmithxy1mmm-sys/HyperliquidMCP#pricing

Inputs: no named parameters. Returns: tier, apiKey, header, renewed, +3 more

hl_coordination_scanWallet coordination scanA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Find wallets in a cohort that hold near-identical directional exposure right now (high cosine similarity of their position vectors) — likely the same entity, a copy-bot, or a coordinated group. Returns clusters and the strongest pairs. Cohort = cohort arg or HL_WHALE_ADDRESSES. Analytics only, not investment advice.

Inputs: dex, topN, cohort, threshold. Returns: dex, pairs, source, clusters, +4 more

hl_create_alertCreate a standing alertAInspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Register a persistent alert the server evaluates on a schedule; fired events are retrieved with hl_poll_alerts. Types: funding_apr (|annualized funding| crosses a threshold), price_move (|return| over a window), whale_net_flip (cohort net position flips long/short). Turns the server into a market watcher for your agent. Analytics only, not investment advice.

Inputs: coin (required), type (required), cohort, movePct, +3 more. Returns: id, coin, type, cooldownMinutes

hl_delete_alertDelete a standing alertB
DestructiveIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Delete one of your standing alerts by id.

Inputs: id (required). Returns: deleted

hl_delete_webhookDelete alert webhookA
Idempotent
Inspect

Stop POSTing this key's alerts to its webhook (they remain available via hl_poll_alerts).

Inputs: no named parameters. Returns: deleted

hl_funding_screenerFunding rate screenerA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Screen every Hyperliquid perp by annualized funding: top markets by absolute funding (carry candidates), sign (longs-pay vs shorts-pay), and — when predictedFundings is available — cross-venue funding spreads for delta-neutral strategies. Filter by min |APR| and OI/volume. Analytics only, not investment advice.

Inputs: side, limit, offset, minAbsApr, +2 more. Returns: matched, results, disclaimer, nextOffset, +2 more

hl_get_accountGet account positions & marginA
Read-onlyIdempotent
Inspect

Perp account snapshot for any address: equity, margin usage, withdrawable, and open positions (size, entry, uPnL, leverage, liquidation price). Read-only; works for any public 0x address.

Inputs: address (required), dex. Returns: address, positions, totalNtlPos, accountValue, +3 more

hl_get_candlesGet OHLCV candlesA
Read-onlyIdempotent
Inspect

OHLCV candlestick history for a coin at a given interval. Provide either an explicit [startTime,endTime] (ms epoch) or a lookback count of the most recent candles. Returns most-recent-last, paginated.

Inputs: coin (required), limit, offset, endTime, +3 more. Returns: coin, total, candles, interval, +1 more

hl_get_funding_historyGet funding rate historyA
Read-onlyIdempotent
Inspect

Historical hourly funding rates for a coin over a time window, with cumulative and average annualized funding. Use for carry analysis and funding trend. Defaults to the last 7 days if no window is given.

Inputs: coin (required), limit, offset, endTime, +1 more. Returns: coin, count, avgApr, entries, +3 more

hl_get_marketsList Hyperliquid perp marketsA
Read-onlyIdempotent
Inspect

List Hyperliquid perpetual markets with mark/oracle price, hourly + annualized funding, open interest, and 24h volume. Use to discover valid coin symbols and scan the board. Supports name filter, sorting, and pagination.

Inputs: dex, sort, limit, filter, +2 more. Returns: limit, total, offset, markets, +1 more

hl_get_open_ordersGet open ordersA
Read-onlyIdempotent
Inspect

Open resting orders for an address: coin, side, price, size, order id, type, and trigger info. Read-only; paginated. Use to inspect any wallet's live order book footprint.

Inputs: address (required), dex, coin, limit, +1 more. Returns: total, orders, address, nextOffset

hl_get_orderbookGet L2 order bookA
Read-onlyIdempotent
Inspect

Level-2 order book for a coin: top-N bid/ask levels with price, size, and order count, plus spread and mid. Use for microstructure, spread, and near-touch liquidity. If the coin is unknown, call hl_get_markets first.

Inputs: coin (required), depth. Returns: asks, bids, coin, time, +3 more

hl_hip3_analyticsHIP-3 market analyticsA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Analytics for HIP-3 (builder-deployed) perp markets such as RWA/equity perps: volume, open interest, funding, and 24h change, enumerated across builder dexs. Optionally pass spotRefs (coin→external spot price) to compute basis vs an external reference. Analytics only, not investment advice.

Inputs: dex, limit, offset, spotRefs. Returns: markets, dexsFailed, disclaimer, nextOffset, +3 more

hl_liquidation_mapLiquidation cluster mapA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Estimated liquidation clusters for a coin from a whale cohort's open positions: distribution of liquidation prices and notional-at-risk bucketed by % distance from mark, plus nearest downside/upside cascade levels. Estimate over the cohort only (not exchange-wide). Analytics only, not investment advice.

Inputs: coin (required), topN, cohort, bucketPct, +1 more. Returns: coin, markPx, buckets, disclaimer, +5 more

hl_list_alertsList your standing alertsA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] List the standing alerts registered under your API key, with their type, params, and last-fired time.

Inputs: no named parameters. Returns: count, alerts

hl_poll_alertsPoll fired alertsAInspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Retrieve alert events that fired since your last poll. Default is simple at-most-once delivery (events are marked delivered as soon as they are read — a lost response loses them). For reliable at-least-once delivery, pass reliable=true: events are then redelivered on every poll until you acknowledge them by passing the highest event id you have processed as ackThroughId. Each event includes a signed signal payload verifiable with hl_signal_pubkey. Call periodically to act on the market.

Inputs: limit, reliable, ackThroughId. Returns: acked, count, events

hl_polymarket_divergencePolymarket ↔ Hyperliquid divergenceA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Compare Polymarket price-threshold odds for a coin (e.g. 'BTC above $100k by date') against the probability implied by Hyperliquid's price + realized volatility. Surfaces cross-market mispricings ranked by edge, checks the market's own price ladder for logically impossible orderings (P(further threshold) > P(nearer)), collapses duplicate contract listings, and reports each estimate's sensitivity to the volatility input. Rows where a diffusion model is out of its depth (extreme tails the market prices but a no-jump model cannot) are flagged, not asserted. Optionally use perp funding as drift. Estimate under lognormal dynamics. Analytics only, not investment advice.

Inputs: coin (required), limit, minEdge, volInterval, +2 more. Returns: coin, note, spot, volBand, +8 more

hl_portfolio_riskPortfolio risk reportA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Risk report for a perp address: liquidation distance per position, effective leverage, concentration (HHI + largest position share), uniform stress scenarios (-5/-10/-20% and mirror), and Sharpe of realized PnL from recent fills. Analytics only, not investment advice.

Inputs: address (required), dex, shocks. Returns: address, positions, disclaimer, accountValue, +6 more

hl_request_free_keyGet a free API keyAInspect

Issue yourself a free API key, instantly and with no signup. The key grants 100 premium calls per month — enough to evaluate every premium tool. Send it as the X-API-Key header on later requests. Call this first if a premium tool says it needs a key. One active key per requester: calling again replaces the previous key and keeps the same monthly usage, so it is safe to call if you lost your key but is not a way to reset the quota.

Inputs: acknowledge. Returns: tier, apiKey, header, upgrade, +3 more

hl_score_calibrationSmart-money score calibrationA
Read-onlyIdempotent
Inspect

Out-of-sample evidence for whether the hl_smart_money_score actually predicts anything: Spearman rank correlation between each wallet's score and the realized return it went on to earn over the forward window (PnL over account value), plus mean forward return per score quartile. Verdicts: insufficient_data (not enough resolved observations yet), inverted (significantly NEGATIVE — higher-scored wallets did worse), no_evidence, weak_positive, positive (both require p<0.05). Only server-selected cohorts enter the sample, so a caller cannot steer this figure. Read this before treating the score as a forecast.

Inputs: no named parameters. Returns: n, pValue, verdict, spearman, +3 more

hl_set_webhookSet alert webhookAInspect

POST this key's fired alerts to an https URL (public addresses only), up to 30 an hour. Each body is signed: header x-hypersignal-signature = sha256=HMAC-SHA256(secret, body). The secret is returned only once.

Inputs: url (required). Returns: url, secret

hl_signal_pubkeyGet signal verification public keyA
Read-onlyIdempotent
Inspect

Returns the server's Ed25519 public key (SPKI DER, base64) used to sign emitted signals, so anyone can independently verify a signal's authenticity and timestamp. Canonicalization: JSON with recursively sorted keys over {payload, ts}; signature is base64 Ed25519.

Inputs: no named parameters. Returns: alg, ephemeral, publicKey, canonicalization

hl_signal_track_recordSignal track recordA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Transparent, verifiable performance of the signals this server has emitted: per signal type, the count, how many have been scored against forward price, hit-rate, and average/median direction-adjusted return. Every signal is cryptographically signed (verify the key via hl_signal_pubkey). Analytics only, not investment advice.

Inputs: type. Returns: note, records

hl_smart_money_scoreSmart-money screener & labelsA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Rank a cohort of wallets by a composite screening score over their PAST results (risk-adjusted performance, winrate, reward/risk, capital size, activity) and tag each with behavioral labels (whale, sharp, scalper, market_maker_like, high_conviction, underwater, …). IMPORTANT: this is a descriptive screener, NOT a validated predictor — the component weights are chosen by judgement and have not been shown to predict future returns. Check calibration in the response for the current out-of-sample evidence, and hl_score_calibration for detail. Use it to shortlist wallets to inspect, not as a forecast. Cohort resolves from cohort arg, the auto-refreshed leaderboard cohort, or HL_WHALE_ADDRESSES. Analytics only, not investment advice.

Inputs: topN, limit, cohort, offset, +1 more. Returns: ranked, source, analyzed, disclaimer, +3 more

hl_trader_reportTrader reportA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Behavioral report for any wallet from its fills: winrate, average R (avg win / avg loss), total realized PnL, PnL curve, holding-time style (scalp vs swing), fees paid, and most-traded coins. Lookback in days (Hyperliquid serves only a wallet's 10,000 most recent fills; historyTruncated says when that cut the window short, so very active wallets are covered only for their latest trades). Analytics only, not investment advice.

Inputs: address (required), curvePoints, lookbackDays. Returns: avgR, style, address, pnlCurve, +13 more

hl_vault_screenerVault screenerA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Screen Hyperliquid user vaults by APR, max drawdown, Sharpe/Sortino, age, TVL, and leader capital share. Provide vaults (list of vault 0x addresses) or set HL_VAULT_ADDRESSES. Metrics derived from vault history. Analytics only, not investment advice.

Inputs: sort, vaults, minTvlUsd. Returns: vaults, screened, disclaimer, unavailable

hl_whale_flow_alertsWhale flow alerts (recent large moves)A
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Recent large changes in whale cohort positioning: which coins saw net long/short notional shift beyond a USD threshold within a lookback window — 'who opened/closed what in the last hour'. Detects full exits. Seeds a baseline on first call. Analytics only, not investment advice.

Inputs: dex, topN, cohort, thresholdUsd, +1 more. Returns: dex, alerts, source, disclaimer, +5 more

hl_whale_positionsAggregate whale positions by coinA
Read-onlyIdempotent
Inspect

[PREMIUM — needs an API key: call hl_request_free_key first for a free key, or pay per call via x402] Aggregated positioning of a whale cohort for a coin (or all coins): total long/short size & notional, long/short wallet counts, weighted-average entry, net bias, and change vs 1h/24h ago. Cohort = cohort arg or HL_WHALE_ADDRESSES. Analytics only, not investment advice.

Inputs: dex, coin, topN, cohort. Returns: dex, asOf, coins, source, +4 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Real-time crypto intelligence for AI agents. Technical analysis, liquidation heatmaps, sentiment, and funding rates for 50+ Hyperliquid perpetuals via x402 micropayments.
      15
      39 PyPI
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides comprehensive crypto intelligence for the Hyperliquid exchange, allowing users to query trader profiles, behavioral cohorts, and live market data. It enables AI agents to analyze over 1.8 billion trades, track whale positions, and access real-time liquidation heatmaps.
      106
      59 npm
      10
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides real-time crypto whale trade data and market analysis to AI agents, including unusual flow radar, liquidations, funding rates, and market snapshots across 15 exchanges and on-chain DEXs.
      17
      60 npm
      12
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.