MCP

Last 30 days

Uptime

100%

Response time

245 ms typical, 245 ms slowest 5%

Last check

6 h ago

Next check

in 6 min

How to call it

Add it to any MCP client that supports remote servers.

{
  "mcpServers": {
    "mcp-250": {
      "type": "http",
      "url": "https://mcp.ironflow.sh/mcp"
    }
  }
}

36 tools

• describe_data

  Start here for any Hyperliquid question the other tools do not answer directly. Returns the SQL tables you can query with run_query (every fill, per-wallet daily totals, wallet behaviour labels, funding, mark and oracle prices, open interest, liquidations, builder-code fills, tra

• run_query

  Run one read-only ClickHouse SELECT over Ironflow's Hyperliquid tables (hl.fills, hl.wallet_daily, hl.wallet_behavior, hl.funding, hl.mark_prices, hl.oracle_prices, hl.open_interest, hl.liquidations, hl.builder_fills, hl.transfers, hl.vault_operations). Call describe_data first f

• get_wallet_behavior

  How Hyperliquid wallets trade, from their last 30 days: labels (market_maker, high_frequency, whale, directional, consistent_winner, big_loser, revenge_sizing, often_liquidated, hip3_trader, spot_trader, prediction_trader) and the numbers behind them (maker share, buy/sell imbala

• get_price

  Latest mark price of a Hyperliquid market: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot.

• get_recent_trades

  Latest tick-level trades on a Hyperliquid market from our own nodes: price, size, side and block time. Covers native perps, HIP-3 builder markets, HIP-4 outcomes and spot.

• get_candles

  OHLCV candles for a Hyperliquid market, computed from tick-level trades.

• get_funding_rates

  Hourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts.

• get_open_interest

  Latest open interest for a Hyperliquid perp.

• get_liquidations

  Liquidations on a Hyperliquid perp, read from our own nodes: price, size, side and the liquidated wallet. Hyperliquid's public API has no liquidation feed.

• get_liquidation_summary

  Liquidations across every Hyperliquid market (or one market) over the last N minutes, totalled: count, notional, longs vs shorts liquidated, the top markets and the largest single liquidation. Use it for 'who got liquidated in the last hour?'. Keyless calls can look back 60 minut

• get_fills

  Every fill for one Hyperliquid wallet, optionally for one market, from indexed history: price, size, side, fee and realized PnL. Hyperliquid's own userFills endpoints stop at the 10,000 most recent fills.

• get_mark_prices

  Mark price and oracle price series for a Hyperliquid perp.

• get_vault_operations

  Deposits into and withdrawals from one Hyperliquid vault or one depositor. Pass vault, address, or both; at least one is required (HLP is 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303). For flows across all vaults use get_vault_leaderboard.

• get_liquidation_levels

  Liquidated notional on a Hyperliquid perp bucketed by price: where longs and shorts were wiped out. Needs a Builder or Enterprise key; keyless and free-key calls return 403.

• get_vault_leaderboard

  Hyperliquid vaults ranked by net deposits (deposits minus withdrawals) over the last 7 days, with depositor counts. Keyless calls see the last 24 hours; a free key from https://ironflow.sh/key gives the full 7 days.

• get_funding_stats

  Funding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate.

• get_user_state

  Open positions and unrealized PnL for a Hyperliquid wallet right now, across native and HIP-3 perps. Use it for questions like 'is this wallet long or short?'

• get_user_funding

  Funding a Hyperliquid wallet paid or received, per market per bucket. Positive means received, negative means paid. bucket=1d gives daily totals, 1h the raw hourly payments.

• get_user_maker_taker

  Maker vs taker breakdown of a Hyperliquid wallet's fills per market: volume, fees and rebates. A high maker share with negative maker fees marks a market maker.

• get_user_ledger

  Vault deposits, withdrawals and transfers for a Hyperliquid wallet. Positive amounts go into the account. Account deposits and withdrawals are recorded only up to 2026-06-06.

• get_pnl_leaderboard

  Every Hyperliquid wallet ranked by realized PnL, biggest losses or volume over a window. Wallets with fewer than 5 fills in the window are left out.

• get_market_top_wallets

  Top wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows.

• get_markets_snapshot

  Active Hyperliquid markets ranked in one call: mark price, 24h change, 24h volume, open interest and current hourly funding. Sort by abs_funding for the most extreme funding, abs_change_24h for the biggest movers, or volume (default). Use min_volume_usd to skip illiquid markets.

• get_user_summary

  One Hyperliquid wallet's stats over a window: volume, realized PnL, fill count, win rate, maker share and markets traded.

• get_wallet_labels

  Labels for notable Hyperliquid wallets: top whales by 24h volume, top traders by 30-day realized PnL, vaults and vault leaders. Pass addresses to check specific wallets; without them it lists the whales and smart money.

• get_user_pnl_series

  Realized PnL curve of a Hyperliquid wallet over time, bucketed (for example hourly or daily).

• get_top_traders

  Hyperliquid traders ranked across all markets by results over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and best markets. sort=top ranks by realized PnL, lowrisk by smallest max drawdown, new by most recently first seen.

• get_market_leaders

  The best traders on one Hyperliquid market, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.

• get_early_movers

  Wallets whose large orders (at least $10k) on a Hyperliquid market were followed by a price move in their direction within 30 minutes. Returns a lead score in basis points and a hit rate per wallet. Past activity does not predict future results.

• get_trader_profile

  A Hyperliquid wallet's trading record over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and its best markets.

• list_cohorts

  List available address cohorts: six predefined groups (top_pnl_30d, high_volume_30d, whale_fills, net_withdrawers_7d, liquidation_prone, vault_whales) plus any custom cohorts the caller has created

• get_cohort_addresses

  Get the wallet addresses in a specific cohort

• get_status

  Get system status, data freshness, and venue health (unauthenticated)

• get_status_metrics

  Get rolling-window API + pipeline + synthetic performance metrics (unauthenticated)

• get_status_history

  Get an uptime / freshness timeline. period: '24h' (default) or '7d' (unauthenticated)

• list_markets

  Active Hyperliquid markets with display symbol, class (perp, spot, prediction), HIP-3 issuer and base asset. Use search to find how a market is named (e.g. search 'nvda' finds xyz:NVDA-PERP).

Security scan

• No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks