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.