# Ironflowsh Hyperliquid MCP server

Source: https://glimind.com/server/mcp-registry%2Fio.github.ironflowsh%2Fhyperliquid
Registry id: `mcp-registry/io.github.ironflowsh/hyperliquid`
Status: live (checked 2026-11-22T14:50:28.009Z)

## Measurements (30 days)

- Uptime: 99.93%
- Checks: 807
- Outages (90 days): 1

## Install

```json
{
  "mcpServers": {
    "ironflowsh-hyperliquid-mcp-server": {
      "type": "http",
      "url": "https://mcp.ironflow.sh/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http ironflowsh-hyperliquid-mcp-server https://mcp.ironflow.sh/mcp
```

## Tools (46)

- `create_liquidation_alert`: Have Ironflow post Hyperliquid liquidations to the user's Discord, Slack, Telegram or HTTPS webhook within seconds, filtered by market, side, size and wallet. I
- `delete_liquidation_alert`: Needs an API key (a free key works). Stop and remove one Hyperliquid liquidation alert from this API key's account; nothing more is sent to its destination.
- `describe_data`: What can SQL answer about Hyperliquid? Lists the SQL tables of Ironflow's Hyperliquid data (fills, trades, hourly market totals, wallet daily totals and labels,
- `get_auto_deleveraging`: Did Hyperliquid auto-deleverage anyone? Auto-deleveraging (ADL) fills, newest first, across all markets or one: profitable positions Hyperliquid closed to cover
- `get_candles`: How has a Hyperliquid market's price moved? OHLCV candles of one market, built from every trade: open, high, low, close, volume and trade count per candle, olde
- `get_cohort_addresses`: Which wallets are in a Hyperliquid cohort? Addresses in one named cohort: up to 100, each with the value the cohort ranks by (realized PnL in USD for top_pnl_30
- `get_early_movers`: Which wallets trade ahead of the price on a Hyperliquid market? Wallets whose large orders (at least $10k) there tended to come before price moved their way wit
- `get_fills`: What did a Hyperliquid wallet trade? Every fill for one wallet, optionally for one market, from indexed history: price, size, side, fee and realized PnL. Hyperl
- `get_funding_rates`: What has funding been on a Hyperliquid perp? Hourly funding rate history, newest first, including HIP-3 builder perps. A positive rate means longs pay shorts. F
- `get_funding_stats`: What is a Hyperliquid perp's average or annualized funding? Funding statistics per time bucket: average, minimum, maximum and annualized rate.
- `get_liquidation_levels`: At which prices did liquidations happen on a Hyperliquid perp? Past liquidations bucketed by price and side: where longs and shorts were wiped out (side sell = 
- `get_liquidation_map`: Where are the liquidation levels on a Hyperliquid perp? Where open positions would be liquidated if the price moved: notional (size x liquidation price) by pric
- `get_liquidation_summary`: How much was liquidated on Hyperliquid, and what were the biggest? Liquidations over a trailing window, totalled across every market or the ones named: count, w
- `get_liquidations`: Who just got liquidated on a Hyperliquid perp? The latest liquidations of one market from our own nodes, newest first: price, size, side and the liquidated wall
- `get_mark_prices`: What is funding on a Hyperliquid perp right now? The latest mark price, oracle price and current hourly funding rate of one perp, with the time of the reading. 
- `get_market_leaders`: Who trades one Hyperliquid market best? The best traders there, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.
- `get_market_top_wallets`: Who trades the most, or makes the most, on one Hyperliquid market? Top wallets there by volume or realized PnL over a window (default the last 24 hours), up to 
- `get_markets_snapshot`: What is moving on Hyperliquid right now? Active markets ranked in one call: mark price, 24h change, 24h volume, open interest and current hourly funding. Sort b
- `get_open_interest`: What is open interest on a Hyperliquid perp? The latest open interest of one perp in units of the base asset (BTC for BTC-PERP), with its 24-hour traded volume 
- `get_open_interest_changes`: Where is money flowing in or out on Hyperliquid? Perps ranked by how their open interest moved over the last 1h, 4h, 24h or 7d: open interest at the start and n
- `get_outcome_markets`: What is trading on Hyperliquid's prediction markets? HIP-4 outcome markets (prediction markets on sports, central bank decisions, IPOs and daily BTC price contr
- `get_pnl_leaderboard`: Who made or lost the most on Hyperliquid? Every wallet ranked by realized PnL, biggest losses or volume over a window. Wallets with fewer than 5 fills in the wi
- `get_positions_at`: What did a Hyperliquid wallet hold at a past time? Exact perp positions at a past moment, up to 90 days back: market, side, signed size, mark price and notional
- `get_premium`: How far does a Hyperliquid perp trade from its oracle? Its mark price against its oracle price over time, with the premium in basis points ((mark / oracle - 1) 
- `get_price`: What is X trading at on Hyperliquid? The latest mark price of one market as a single number: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot. Fo
- `get_recent_trades`: What just traded on a Hyperliquid market? The latest tick-level trades from our own nodes: price, size, side and block time. Covers native perps, HIP-3 builder 
- `get_status`: Is Ironflow up? Service status right now: overall state, data freshness per venue and component health.
- `get_status_history`: Was Ironflow down? Its own uptime over the last 24 hours (default) or 7 days: points over the period, each with the service status and how fresh the data was in
- `get_status_metrics`: How fast is Ironflow? Performance over rolling windows: API latency and error rate, ingestion lag and synthetic probe timings.
- `get_top_traders`: Who are the top traders on Hyperliquid this week or month? Traders ranked across all markets by results over 7, 30 or 90 days: win rate, profit factor, realized
- `get_trader_profile`: Is this Hyperliquid trader any good, and how risky? Its record over 7, 30 or 90 days, rebuilt from its fills: overall win rate, profit factor, trade count, real
- `get_user_funding`: How much funding did a Hyperliquid wallet pay or receive? Per market per bucket: Hyperliquid's own ledger, every hourly payment back to September 2025 (Hyperliq
- `get_user_ledger`: Where did a Hyperliquid wallet's money come from or go? Vault deposits, withdrawals and transfers for the wallet, including account deposits and withdrawals and
- `get_user_maker_taker`: Is a Hyperliquid wallet a maker or a taker? Maker vs taker breakdown of its fills per market: volume, fees and rebates. A high maker share with negative maker f
- `get_user_pnl_series`: How has a Hyperliquid wallet's PnL gone over time? Its realized PnL over time: buckets with realized PnL and fees paid in each, by default daily over the last 3
- `get_user_state`: What positions does a Hyperliquid wallet have open? Its positions right now across native and HIP-3 perps: size, entry and mark price, leverage and unrealized P
- `get_user_summary`: How much did a Hyperliquid wallet trade or make? Totals over a time range (default the last 24 hours): fill count, volume in USD, realized PnL, fees, wins, loss
- `get_vault_leaderboard`: Which Hyperliquid vaults are drawing deposits? Vaults ranked by net deposits (deposits minus withdrawals) over the last 7 days, with depositor counts. Keyless c
- `get_vault_operations`: Who moved money in or out of a Hyperliquid vault? Deposits into and withdrawals from one vault or one depositor. Pass vault, address, or both; at least one is r
- `get_wallet_behavior`: How does a Hyperliquid wallet trade, and which wallets are whales or market makers? Labels from the last 30 days (market_maker, high_frequency, whale, direction
- `get_wallet_labels`: Whose wallet is this, and who are the whales on Hyperliquid? Labels for notable wallets: top whales by 24h volume, top traders by 30-day realized PnL, vaults an
- `list_cohorts`: Which ready-made Hyperliquid wallet groups are there? Lists address cohorts: six predefined groups (top_pnl_30d, high_volume_30d, whale_fills, net_withdrawers_7
- `list_liquidation_alerts`: Needs an API key (a free key works). The Hyperliquid liquidation alerts on this API key's account: where each posts (host only), its filter, whether it is activ
- `list_markets`: What is a Hyperliquid market called? Lists perps (native and HIP-3), spot and live HIP-4 outcomes with symbol, class, issuer, base asset and Hyperliquid coin. S
- `run_query`: Anything the other tools do not answer: runs one read-only ClickHouse SELECT over Ironflow's Hyperliquid tables (hl.fills, hl.trades, hl.wallet_fills, hl.wallet
- `test_liquidation_alert`: Needs an API key (a free key works). Send a sample Hyperliquid liquidation, marked as a test, to an alert's destination now and report whether it arrived (deliv

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.
