Servers Playground How we check Add a server Log in

HyperSignal MCP

Working

io.github.johnsmithxy1mmm-sys/hypersignal-mcpv1.14.0 GitHub verified

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

Crypto & Web3

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://hypersmash.fly.dev/mcp

X-API-Key (optional)

Key for premium tools; free tools work without it (get one with hl_request_free_key)

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

hl_coordination_scan Read-only

[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.

dexstring

Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex (at most 20 wallets).

topNinteger

cohortarray

thresholdnumber

Cosine similarity to link two wallets.

HyperSignal MCP server | mcptry

Tools (29)

hl_coordination_scan

read-only

Argument	Type	Description
dex	string	Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex (at most 20 wallets).
topN	integer
cohort	array
threshold	number	Cosine similarity to link two wallets.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dex": {
      "type": "string",
      "description": "Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex (at most 20 wallets)."
    },
    "topN": {
      "type": "integer",
      "default": 80,
      "maximum": 150,
      "minimum": 2
    },
    "cohort": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "threshold": {
      "type": "number",
      "default": 0.9,
      "maximum": 1,
      "minimum": 0.5,
      "description": "Cosine similarity to link two wallets."
    }
  },
  "additionalProperties": false
}

hl_create_alert

[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.

Argument	Type	Description
coin*	string	Perp coin symbol the alert watches.
type*	string
cohort	array	whale_net_flip: up to 100 0x addresses (else HL_WHALE_ADDRESSES).
movePct	number	price_move: \|return\| fraction (0.05 = 5%, min 0.01).
aprThreshold	number	funding_apr: \|APR\| fraction (0.5 = 50%).
windowMinutes	integer	price_move lookback window.
cooldownMinutes	integer	Min gap between re-fires.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "type",
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Perp coin symbol the alert watches."
    },
    "type": {
      "enum": [
        "funding_apr",
        "price_move",
        "whale_net_flip"
      ],
      "type": "string"
    },
    "cohort": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 100,
      "description": "whale_net_flip: up to 100 0x addresses (else HL_WHALE_ADDRESSES)."
    },
    "movePct": {
      "type": "number",
      "minimum": 0.01,
      "description": "price_move: |return| fraction (0.05 = 5%, min 0.01)."
    },
    "aprThreshold": {
      "type": "number",
      "minimum": 0,
      "description": "funding_apr: |APR| fraction (0.5 = 50%)."
    },
    "windowMinutes": {
      "type": "integer",
      "maximum": 1440,
      "minimum": 5,
      "description": "price_move lookback window."
    },
    "cooldownMinutes": {
      "type": "integer",
      "default": 120,
      "maximum": 10080,
      "minimum": 5,
      "description": "Min gap between re-fires."
    }
  },
  "additionalProperties": false
}

hl_delete_alert

[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.

destructive

Argument	Type	Description
id*	string	Alert id from hl_create_alert / hl_list_alerts.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Alert id from hl_create_alert / hl_list_alerts."
    }
  },
  "additionalProperties": false
}

hl_delete_webhook

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

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

hl_funding_screener

[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.

read-only

Argument	Type	Description
side	string
limit	integer
offset	integer
minAbsApr	number	Minimum \|annualized funding\| as a fraction (0.05 = 5% APR).
minOpenInterestUsd	number	Filter out thin markets below this OI (USD).
includeVenueSpreads	boolean	Include cross-venue predicted funding spreads if available.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "side": {
      "enum": [
        "all",
        "longs_pay",
        "shorts_pay"
      ],
      "type": "string",
      "default": "all"
    },
    "limit": {
      "type": "integer",
      "default": 30,
      "maximum": 200,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "minAbsApr": {
      "type": "number",
      "default": 0.05,
      "minimum": 0,
      "description": "Minimum |annualized funding| as a fraction (0.05 = 5% APR)."
    },
    "minOpenInterestUsd": {
      "type": "number",
      "default": 0,
      "minimum": 0,
      "description": "Filter out thin markets below this OI (USD)."
    },
    "includeVenueSpreads": {
      "type": "boolean",
      "default": true,
      "description": "Include cross-venue predicted funding spreads if available."
    }
  },
  "additionalProperties": false
}

hl_get_account

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.

read-only

Argument	Type	Description
dex	string	Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex.
address*	string	EVM 0x address (42 hex chars).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "dex": {
      "type": "string",
      "description": "Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex."
    },
    "address": {
      "type": "string",
      "description": "EVM 0x address (42 hex chars)."
    }
  },
  "additionalProperties": false
}

hl_get_candles

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.

read-only

Argument	Type	Description
coin*	string	Perp coin symbol, e.g. 'ETH'.
limit	integer
offset	integer
endTime	integer	End time in ms epoch (default now).
interval	string
lookback	integer	Number of most-recent candles to fetch (ignored if startTime given).
startTime	integer	Start time in ms epoch.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Perp coin symbol, e.g. 'ETH'."
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "maximum": 500,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "endTime": {
      "type": "integer",
      "description": "End time in ms epoch (default now)."
    },
    "interval": {
      "enum": [
        "1m",
        "3m",
        "5m",
        "15m",
        "30m",
        "1h",
        "2h",
        "4h",
        "8h",
        "12h",
        "1d",
        "3d",
        "1w",
        "1M"
      ],
      "type": "string",
      "default": "1h"
    },
    "lookback": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Number of most-recent candles to fetch (ignored if startTime given)."
    },
    "startTime": {
      "type": "integer",
      "description": "Start time in ms epoch."
    }
  },
  "additionalProperties": false
}

hl_get_funding_history

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.

read-only

Argument	Type	Description
coin*	string	Perp coin symbol, e.g. 'BTC'.
limit	integer
offset	integer
endTime	integer	End time ms epoch (default now).
startTime	integer	Start time ms epoch (default: 7 days ago).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Perp coin symbol, e.g. 'BTC'."
    },
    "limit": {
      "type": "integer",
      "default": 200,
      "maximum": 500,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "endTime": {
      "type": "integer",
      "description": "End time ms epoch (default now)."
    },
    "startTime": {
      "type": "integer",
      "description": "Start time ms epoch (default: 7 days ago)."
    }
  },
  "additionalProperties": false
}

hl_get_markets

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.

read-only

Argument	Type	Description
dex	string	HIP-3 builder dex to list (e.g. 'xyz'); omit for the main dex.
sort	string	Sort field (desc for numeric, asc for name).
limit	integer
filter	string	Case-insensitive substring match on coin symbol (e.g. 'BTC').
offset	integer
includeDelisted	boolean	Include delisted markets.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dex": {
      "type": "string",
      "description": "HIP-3 builder dex to list (e.g. 'xyz'); omit for the main dex."
    },
    "sort": {
      "enum": [
        "volume",
        "openInterest",
        "funding",
        "change24h",
        "name"
      ],
      "type": "string",
      "default": "volume",
      "description": "Sort field (desc for numeric, asc for name)."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "filter": {
      "type": "string",
      "description": "Case-insensitive substring match on coin symbol (e.g. 'BTC')."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "includeDelisted": {
      "type": "boolean",
      "default": false,
      "description": "Include delisted markets."
    }
  },
  "additionalProperties": false
}

hl_get_open_orders

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.

read-only

Argument	Type	Description
dex	string	Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex.
coin	string	Optional filter to a single coin.
limit	integer
offset	integer
address*	string	EVM 0x address.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "dex": {
      "type": "string",
      "description": "Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex."
    },
    "coin": {
      "type": "string",
      "description": "Optional filter to a single coin."
    },
    "limit": {
      "type": "integer",
      "default": 100,
      "maximum": 200,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "address": {
      "type": "string",
      "description": "EVM 0x address."
    }
  },
  "additionalProperties": false
}

hl_get_orderbook

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.

read-only

Argument	Type	Description
coin*	string	Perp coin symbol, e.g. 'BTC' (case-insensitive).
depth	integer	Number of levels per side.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Perp coin symbol, e.g. 'BTC' (case-insensitive)."
    },
    "depth": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Number of levels per side."
    }
  },
  "additionalProperties": false
}

hl_hip3_analytics

[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.

read-only

Argument	Type	Description
dex	string	Filter to one builder dex by name (the part before ':' in market names).
limit	integer
offset	integer
spotRefs	object	Optional map of coin symbol -> external spot price for basis calculation.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dex": {
      "type": "string",
      "description": "Filter to one builder dex by name (the part before ':' in market names)."
    },
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "spotRefs": {
      "type": "object",
      "description": "Optional map of coin symbol -> external spot price for basis calculation.",
      "additionalProperties": {
        "type": "number"
      }
    }
  },
  "additionalProperties": false
}

hl_link_telegram

Get a one-time Telegram link (valid 15 minutes). Open it and press Start: this key's standing alerts are then also pushed to that chat (up to 30 messages an hour; everything stays available via hl_poll_alerts).

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

hl_liquidation_map

[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.

read-only

Argument	Type	Description
coin*	string	Perp coin symbol.
topN	integer
cohort	array
bucketPct	number	Bucket width as % of mark price.
maxDistancePct	number	Ignore liq prices beyond this % from mark.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Perp coin symbol."
    },
    "topN": {
      "type": "integer",
      "default": 100,
      "maximum": 200,
      "minimum": 1
    },
    "cohort": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "bucketPct": {
      "type": "number",
      "default": 2,
      "maximum": 20,
      "minimum": 0.5,
      "description": "Bucket width as % of mark price."
    },
    "maxDistancePct": {
      "type": "number",
      "default": 30,
      "maximum": 90,
      "minimum": 1,
      "description": "Ignore liq prices beyond this % from mark."
    }
  },
  "additionalProperties": false
}

hl_list_alerts

[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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

hl_poll_alerts

[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.

Argument	Type	Description
limit	integer
reliable	boolean	true = at-least-once: events redeliver until acknowledged via ackThroughId.
ackThroughId	integer	Acknowledge all events with id <= this value (from a previous reliable poll).

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "reliable": {
      "type": "boolean",
      "default": false,
      "description": "true = at-least-once: events redeliver until acknowledged via ackThroughId."
    },
    "ackThroughId": {
      "type": "integer",
      "minimum": 0,
      "description": "Acknowledge all events with id <= this value (from a previous reliable poll)."
    }
  },
  "additionalProperties": false
}

hl_polymarket_divergence

[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.

read-only

Argument	Type	Description
coin*	string	Perp coin symbol, e.g. 'BTC'.
limit	integer
minEdge	number	Min \|Polymarket − HL\| probability gap to report.
volInterval	string
volWindowDays	integer	Lookback for realized volatility.
useFundingDrift	boolean	Use annualized funding as the drift term.

Input schema (JSON)

hl_portfolio_risk

[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.

read-only

Argument	Type	Description
dex	string	Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex.
shocks	array	Price-shock fractions to stress test (applied uniformly across positions).
address*	string	EVM 0x address.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "dex": {
      "type": "string",
      "description": "Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex."
    },
    "shocks": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "default": [
        -0.05,
        -0.1,
        -0.2
      ],
      "description": "Price-shock fractions to stress test (applied uniformly across positions)."
    },
    "address": {
      "type": "string",
      "description": "EVM 0x address."
    }
  },
  "additionalProperties": false
}

hl_request_free_key

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.

Argument	Type	Description
acknowledge	boolean	Acknowledges that analytics are informational and not investment advice.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "acknowledge": {
      "type": "boolean",
      "default": true,
      "description": "Acknowledges that analytics are informational and not investment advice."
    }
  },
  "additionalProperties": false
}

hl_score_calibration

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

hl_set_webhook

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.

Argument	Type	Description
url*	string	https URL that receives alert POSTs.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "https URL that receives alert POSTs."
    }
  },
  "additionalProperties": false
}

hl_signal_pubkey

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

hl_signal_track_record

[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.

read-only

Argument	Type	Description
type	string	Filter to one signal type (e.g. 'whale_net_flip', 'funding_apr').

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "type": {
      "type": "string",
      "description": "Filter to one signal type (e.g. 'whale_net_flip', 'funding_apr')."
    }
  },
  "additionalProperties": false
}

hl_smart_money_score

[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.

read-only

Argument	Type	Description
topN	integer
limit	integer
cohort	array	0x wallet addresses to score; else HL_WHALE_ADDRESSES.
offset	integer
lookbackDays	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "topN": {
      "type": "integer",
      "default": 50,
      "maximum": 100,
      "minimum": 1
    },
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "cohort": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "0x wallet addresses to score; else HL_WHALE_ADDRESSES."
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "lookbackDays": {
      "type": "integer",
      "default": 30,
      "maximum": 365,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

hl_trader_report

[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.

read-only

Argument	Type	Description
address*	string	EVM 0x address.
curvePoints	integer	Downsampled points in the returned PnL curve.
lookbackDays	integer

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "description": "EVM 0x address."
    },
    "curvePoints": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 2,
      "description": "Downsampled points in the returned PnL curve."
    },
    "lookbackDays": {
      "type": "integer",
      "default": 30,
      "maximum": 365,
      "minimum": 1
    }
  },
  "additionalProperties": false
}

hl_unlink_telegram

Stop pushing this key's alerts to Telegram (they remain available via hl_poll_alerts).

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

hl_vault_screener

[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.

read-only

Argument	Type	Description
sort	string
vaults	array	Vault 0x addresses to screen (max 50); else HL_VAULT_ADDRESSES.
minTvlUsd	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "sort": {
      "enum": [
        "apr",
        "sharpe",
        "sortino",
        "tvl",
        "maxDrawdown"
      ],
      "type": "string",
      "default": "sharpe"
    },
    "vaults": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 50,
      "description": "Vault 0x addresses to screen (max 50); else HL_VAULT_ADDRESSES."
    },
    "minTvlUsd": {
      "type": "number",
      "default": 0,
      "minimum": 0
    }
  },
  "additionalProperties": false
}

hl_whale_flow_alerts

[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.

read-only

Argument	Type	Description
dex	string	Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex (at most 20 wallets).
topN	integer
cohort	array	Explicit 0x wallet addresses; else HL_WHALE_ADDRESSES.
thresholdUsd	number	Min absolute net-notional change to alert on.
lookbackMinutes	integer	Compare against a snapshot ~this old.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dex": {
      "type": "string",
      "description": "Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex (at most 20 wallets)."
    },
    "topN": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1
    },
    "cohort": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Explicit 0x wallet addresses; else HL_WHALE_ADDRESSES."
    },
    "thresholdUsd": {
      "type": "number",
      "default": 250000,
      "minimum": 0,
      "description": "Min absolute net-notional change to alert on."
    },
    "lookbackMinutes": {
      "type": "integer",
      "default": 60,
      "maximum": 1440,
      "minimum": 5,
      "description": "Compare against a snapshot ~this old."
    }
  },
  "additionalProperties": false
}

hl_whale_positions

[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.

read-only

Argument	Type	Description
dex	string	Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex (at most 20 wallets).
coin	string	Restrict to one coin (a HIP-3 coin like 'xyz:XYZ100' reads its own dex); omit for all coins.
topN	integer	Max wallets to include from the cohort.
cohort	array	Explicit list of 0x wallet addresses.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "dex": {
      "type": "string",
      "description": "Perp dex: omit for the main dex, a HIP-3 builder dex name (e.g. 'xyz'), or 'all' for every dex (at most 20 wallets)."
    },
    "coin": {
      "type": "string",
      "description": "Restrict to one coin (a HIP-3 coin like 'xyz:XYZ100' reads its own dex); omit for all coins."
    },
    "topN": {
      "type": "integer",
      "default": 50,
      "maximum": 200,
      "minimum": 1,
      "description": "Max wallets to include from the cohort."
    },
    "cohort": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Explicit list of 0x wallet addresses."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "coin"
  ],
  "properties": {
    "coin": {
      "type": "string",
      "description": "Perp coin symbol, e.g. 'BTC'."
    },
    "limit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 1
    },
    "minEdge": {
      "type": "number",
      "default": 0.05,
      "maximum": 1,
      "minimum": 0,
      "description": "Min |Polymarket − HL| probability gap to report."
    },
    "volInterval": {
      "enum": [
        "1h",
        "4h",
        "1d"
      ],
      "type": "string",
      "default": "1d"
    },
    "volWindowDays": {
      "type": "integer",
      "default": 30,
      "maximum": 365,
      "minimum": 2,
      "description": "Lookback for realized volatility."
    },
    "useFundingDrift": {
      "type": "boolean",
      "default": false,
      "description": "Use annualized funding as the drift term."
    }
  },
  "additionalProperties": false
}