Tool catalog

Every MCP tool is a thin wrapper around a public API endpoint. Tier requirements match the underlying endpoint — discovery and market data are Free, single-trader and HIP-4 analytics are Starter, and the deep lifecycle / execution-quality / archetype tools are Pro. For the canonical schema (inputs, outputs, examples), see the API reference — every tool maps 1:1 to an endpoint. As of connector v0.11.0, that includes builder analytics: eight builder_* tools covering the leaderboard, per-builder profiles, attributed traders and fills, cohort composition, retention, audience overlap, and the inverse per-wallet view.

Builder analytics (v0.11.0)

Tool	Tier	What it answers
`builder_leaderboard`	Starter	Builders ranked by exact ledger revenue, with attributed volume/users and prev-window deltas
`builder_profile`	Starter	One builder: revenue, daily series, top coins, profitable-user share
`builder_traders`	Pro	Wallets trading via a builder, with exchange-wide cohort tiers
`builder_fills`	Pro	Individual attributed fills through a builder (perp/spot/HIP-4)
`builder_cohorts`	Pro	A builder’s user base split by behavioral tier
`builder_retention`	Pro	Monthly new-user retention triangle (orders plane, 12 months)
`builder_overlap`	Pro	The other builders a builder’s users also trade through
`trader_builders`	Starter	Every builder one wallet trades through, by fees paid

All eight carry the attribution caveat in their responses (dataNotes): trigger-order (stop/TP) fills attribute at ledger level only until the parser upgrade completes, so attributed detail slightly undercounts exact ledger revenue.

Discovery & taxonomy

Tool	Description
`list_markets`	All markets with prices, OI, funding. Optional `dex` filter.
`list_assets`	Canonical asset directory with venue breakdown.
`list_asset`	One asset’s venue breakdown (accepts synonyms).
`pulse_cross_market_asset`	Aggregated OI / positions / bias across all venues for a canonical asset.

Pulse — trader & cohort analytics

Tool	Description
`pulse_global_stats`	Total traders, trades, volume, PnL, data coverage.
`pulse_market_overview`	Global stats + per-market breakdown.
`pulse_leaderboard`	Top traders ranked by PnL with tier labels.
`pulse_hidden_gems`	Underrated wallets matching profile filters.
`pulse_most_traded_coins`	Coins ranked by recent volume.
`pulse_biggest_trades`	Largest individual fills in a time window.
`pulse_recent_trades`	Recent global fills.
`pulse_recent_closed_positions`	Recently closed positions across all wallets.
`pulse_token_leaderboard`	Top traders on a specific coin.

Pulse — single trader

Tool	Description
`pulse_trader_profile`	Stats, win rate, PnL, tier classification.
`pulse_trader_performance`	Recent vs all-time performance + trend.
`pulse_trader_trades`	Recent fills for one wallet.
`pulse_trader_daily_stats`	Day-by-day PnL / volume history.
`pulse_trader_token_stats`	Per-token breakdown for one wallet.
`pulse_trader_closed_positions`	Closed positions for one wallet.
`pulse_trader_closed_position_stats`	Aggregate closed-position stats.
`pulse_compare`	Side-by-side lifecycle comparison of 2–5 wallets.

Pulse — cohorts

Tool	Description
`pulse_cohort_summary`	All cohorts with size, PnL, win-rate medians.
`pulse_cohort_positions`	Current positions held by a specific cohort.
`pulse_cohort_trades`	Recent trades from one cohort.
`pulse_cohort_history`	Cohort performance over time.
`pulse_cohort_bias_history`	Cohort long/short bias over time.
`pulse_cohort_performance_daily`	Daily cohort PnL / volume.

Pulse — position lifecycles

Every position reconstructed open→close from on-chain fills, with MAE/MFE. See Position lifecycles.

Tool	Description
`pulse_trader_lifecycles`	One wallet’s open→close position history (90-day window).
`pulse_trader_lifecycle_summary`	Aggregate lifecycle stats for one wallet — win rate, avg hold, biggest win/loss.
`pulse_lifecycle`	One lifecycle by ID, with every composing fill.
`pulse_trader_demo`	One-call wallet briefing: lifecycle summary + recent top wins/losses.
`pulse_lifecycles_recent`	Global feed of recently closed positions across all wallets.

Pulse — execution quality (MAE/MFE) · Pro

Tool	Description
`pulse_wallet_drawdown_curve`	Per-position drawdown (MAE) and run-up (MFE) for one wallet.
`pulse_max_pain_events`	Winners that survived the deepest drawdowns before recovering.
`pulse_perfect_exits`	Exits that captured most of the maximum favorable move.
`pulse_backstop_events`	The most catastrophic individual liquidations.

Pulse — trader archetypes

Tool	Description
`pulse_survivors`	Wallets that hit a deep trough then recovered to green.
`pulse_anti_survivors`	Wallets that blew up and never recovered.
`pulse_persistent_winners`	Profitable across multiple distinct months.
`pulse_capital_titans`	Best PnL per dollar of fees.
`pulse_one_month_wonders`	Huge in one month, then gave it back.
`pulse_newcomer_whales`	Recent first lifecycle, already moving big notional.
`pulse_coin_kings`	Top earner(s) per coin.
`pulse_top_liquidators`	Wallets that profit by liquidating others.
`pulse_lethal_coins`	Coins with the highest per-lifecycle liquidation rate.

Pulse — market structure

Tool	Description
`pulse_coin_alpha_map`	Per-coin winner / loser / net profit pools.
`pulse_hour_profitability`	Global PnL by UTC hour of close.
`pulse_market_concentration`	Percentile profit share — how concentrated alpha is.
`pulse_style_distribution`	HFT vs swing vs holder PnL split.

Pulse — refreshed cohorts (30-day rolling tier)

Cohorts labelled by last-30-day tier (pnl_tier_recent / size_tier_recent) — who’s printing right now, not all-time.

Tool	Description
`pulse_cohort_recent_positions`	Live positions held by a recent-tier cohort.
`pulse_cohort_recent_trades`	Recent trades from a recent-tier cohort.
`pulse_cohort_recent_lifecycle_stats`	Per-wallet lifecycle stats for a recent-tier cohort.
`pulse_cohort_recent_top_positions`	Top closed lifecycles from a recent-tier cohort.
`pulse_cohort_recent_alpha_concentration`	Profit concentration within a recent-tier cohort.

Live — real-time market + risk

Tool	Description
`live_long_short_ratio`	Global L/S ratio by wallet count and notional.
`live_cohort_bias`	Per-cohort bias for one coin.
`live_cohort_bias_history`	Historical cohort bias trajectory.
`live_oi_history`	Open interest time series.
`live_official_oi`	OI sourced from Hyperliquid’s official feed.
`live_liquidation_heatmap`	Liquidation density by price level for one coin.
`live_liquidation_summary`	Recent liquidation totals by side.
`live_recent_liquidations`	Stream of recent liquidation events.
`live_coin_risk_snapshot`	Coin-level risk metrics (now).
`live_coin_risk_history`	Coin-level risk over time.
`live_risk_overview`	Cross-coin risk dashboard.
`live_mark_dislocations`	Mark vs. oracle deviation events.

Market — direct Hyperliquid passthrough

Tool	Description
`market_price`	Mark/index/funding/OI for a symbol.
`market_positions`	Open positions for an address.
`market_orderbook`	L2 orderbook for a symbol.
`market_recent_candles`	Recent candles for a symbol.
`market_historical_oi`	Historical OI series.

Entity resolution — owner-level intelligence · Pro ^{new in 0.9}

Hyperliquid traders run named sub-accounts that trade independently — per-wallet views undercount every multi-account trader. These tools resolve wallets to their owner entity and aggregate across the whole family.

Tool	Description
`pulse_entity_profile`	Resolve ANY wallet to its owner entity: master, named sub-accounts, each member’s open book, combined positions, and a verified-vs-chain stamp. Pro tier.
`pulse_entity_leaderboard`	Top entities (owners, not wallets) by combined gross open notional — a fund running 35 sub-accounts shows as one entity. Pro tier.

Exchange aggregates ^{new in 0.9}

Tool	Description
`pulse_exchange_volume`	24h volume, total and per dex — builder dexes are ~43% of Hyperliquid volume and most trackers’ headlines omit them.
`pulse_exchange_oi`	Open interest by dex with long/short notional split.
`pulse_active_traders`	Distinct wallets that traded in the last 24h.
`pulse_exchange_positions`	Open positions by dex + 24h flow: closes, liquidations, exchange-wide realized PnL.
`pulse_pnl_leaders`	Today’s biggest realized winners and losers (24h closed positions). Starter tier.

Plans & limits ^{new in 0.9}

Tool	Description
`pulse_my_plan`	The caller’s tier, effective rate limits, and every tier’s limits with an upgrade link. Agents call this when a request is rejected for tier or rate-limit reasons.

HIP-4 — outcome contracts

Tool	Description
`hip4_outcomes`	All known outcome contracts.
`hip4_outcome`	Metadata for one outcome.
`hip4_outcome_summary`	Volume + holder stats for one outcome.
`hip4_outcome_recent_trades`	Recent fills on one outcome.
`hip4_questions`	Outcome contracts grouped by question.
`hip4_recent_settlements`	Recently settled outcomes.
`hip4_daily_volume`	Daily HIP-4 trading volume.
`hip4_most_active`	Most-traded outcomes.
`hip4_top_traders`	Top outcome traders by volume / PnL.
`hip4_trader_outcomes`	Outcomes one wallet has traded.
`hip4_cross_product_overlap`	Overlap between outcome traders and perp traders.
`hip4_perp_position_context`	Whether outcome holders have open perp positions on the underlying. Pro tier.

Every tool accepts a useToonFormat flag (default true) that returns data in compact TOON format — about 50% fewer tokens than JSON for tabular data. Agents typically want this on; set to false if you need standard JSON.

Getting started

MCP

Concepts

Builder analytics (v0.11.0)

Discovery & taxonomy

Pulse — trader & cohort analytics

Pulse — single trader

Pulse — cohorts

Pulse — position lifecycles

Pulse — execution quality (MAE/MFE) · Pro

Pulse — trader archetypes

Pulse — market structure

Pulse — refreshed cohorts (30-day rolling tier)

Live — real-time market + risk

Market — direct Hyperliquid passthrough

Entity resolution — owner-level intelligence · Pro ^{new in 0.9}

Exchange aggregates ^{new in 0.9}

Plans & limits ^{new in 0.9}

HIP-4 — outcome contracts

​Builder analytics (v0.11.0)

​Discovery & taxonomy

​Pulse — trader & cohort analytics

​Pulse — single trader

​Pulse — cohorts

​Pulse — position lifecycles

​Pulse — execution quality (MAE/MFE) · Pro

​Pulse — trader archetypes

​Pulse — market structure

​Pulse — refreshed cohorts (30-day rolling tier)

​Live — real-time market + risk

​Market — direct Hyperliquid passthrough

​Entity resolution — owner-level intelligence · Pro new in 0.9

​Exchange aggregates new in 0.9

​Plans & limits new in 0.9

​HIP-4 — outcome contracts

Builder analytics (v0.11.0)

Discovery & taxonomy

Pulse — trader & cohort analytics

Pulse — single trader

Pulse — cohorts

Pulse — position lifecycles

Pulse — execution quality (MAE/MFE) · Pro

Pulse — trader archetypes

Pulse — market structure

Pulse — refreshed cohorts (30-day rolling tier)

Live — real-time market + risk

Market — direct Hyperliquid passthrough

Entity resolution — owner-level intelligence · Pro ^{new in 0.9}

Exchange aggregates ^{new in 0.9}

Plans & limits ^{new in 0.9}

HIP-4 — outcome contracts