MCP server

Ironflowsh

io.github.ironflowsh/mcp

Checked 25 Oct 2026, 20:29 UTC · Connected to it and listed its tools

Read-only Hyperliquid data for AI agents: fills, candles, funding, liquidations, wallet analytics.

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

36

Token cost

About 5,750 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

25 Oct 2026, 20:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.ironflowsh]
url = "https://mcp.ironflow.sh/mcp"

Gemini CLI

{"mcpServers":{"ironflowsh":{"httpUrl":"https://mcp.ironflow.sh/mcp"}}}

Cursor

{"mcpServers":{"ironflowsh":{"url":"https://mcp.ironflow.sh/mcp"}}}

VS Code

{"servers":{"ironflowsh":{"type":"http","url":"https://mcp.ironflow.sh/mcp"}}}

Antigravity

agy mcp add ironflowsh https://mcp.ironflow.sh/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"ironflowsh","server_url":"https://mcp.ironflow.sh/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"ironflowsh","server_url":"https://mcp.ironflow.sh/mcp"}

Tools

• describe_data ~141 tokens
  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, transfers, vault flows)
• get_candles ~179 tokens
  OHLCV candles for a Hyperliquid market, computed from tick-level trades.
• get_cohort_addresses ~83 tokens
  Get the wallet addresses in a specific cohort
• get_early_movers ~179 tokens
  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_fills ~181 tokens
  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_funding_rates ~156 tokens
  Hourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts.
• get_funding_stats ~169 tokens
  Funding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate.
• get_liquidation_levels ~165 tokens
  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_liquidation_summary ~169 tokens
  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 minutes, keyed calls up t
• get_liquidations ~164 tokens
  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_mark_prices ~97 tokens
  Mark price and oracle price series for a Hyperliquid perp.
• get_market_leaders ~150 tokens
  The best traders on one Hyperliquid market, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.
• get_market_top_wallets ~176 tokens
  Top wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows.
• get_markets_snapshot ~324 tokens
  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. Returns the top 25 u
• get_open_interest ~107 tokens
  Latest open interest for a Hyperliquid perp.
• get_pnl_leaderboard ~168 tokens
  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_price ~123 tokens
  Latest mark price of a Hyperliquid market: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot.
• get_recent_trades ~169 tokens
  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_status ~49 tokens
  Get system status, data freshness, and venue health (unauthenticated)
• get_status_history ~86 tokens
  Get an uptime / freshness timeline. period: '24h' (default) or '7d' (unauthenticated)
• get_status_metrics ~55 tokens
  Get rolling-window API + pipeline + synthetic performance metrics (unauthenticated)
• get_top_traders ~178 tokens
  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_trader_profile ~122 tokens
  A Hyperliquid wallet's trading record over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and its best markets.
• get_user_funding ~221 tokens
  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_ledger ~208 tokens
  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_user_maker_taker ~155 tokens
  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_pnl_series ~145 tokens
  Realized PnL curve of a Hyperliquid wallet over time, bucketed (for example hourly or daily).
• get_user_state ~100 tokens
  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_summary ~133 tokens
  One Hyperliquid wallet's stats over a window: volume, realized PnL, fill count, win rate, maker share and markets traded.
• get_vault_leaderboard ~117 tokens
  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_vault_operations ~174 tokens
  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_wallet_behavior ~344 tokens
  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 imbalance, fills per day,
• get_wallet_labels ~177 tokens
  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.
• list_cohorts ~86 tokens
  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
• list_markets ~262 tokens
  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).
• run_query ~238 tokens
  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 for columns and examp

Browse

• GitHub tools
• Website monitoring
• GitHub and code hosting
• Databases
• Government and public data

Related MCP servers

• Tape — Hyperliquid Analytics
  Live Hyperliquid perps analytics for agents: funding, OI, whale prints, leaderboard, wallet risk.
• LiqFlow
  Hyperliquid liquidation levels, whale positions, liquidations, cohorts and funding. Free.
• chiefofstaff Hyperliquid perp data + token safety
  Hyperliquid perp data (funding, whale liq levels, positioning, brief) + token safety, x402 per call.
• Whale Data
  Real-time whale trades, Smart Money Radar, market snapshots, news sentiment, signal outcomes.
• Buildix: Hyperliquid Orderflow
  Read-only Hyperliquid analytics: orderflow, liquidation levels, whale positioning, funding.
• SQD
  Query 130+ SQD Portal datasets across blockchains, including native Tron transactions and events.
• Crypto, web, finance and app data tools
  160 tools: crypto derivatives, EVM, cloud & LLM prices, Polymarket, OFAC, SEC, FRED, DNS, CVE.
• SingIt x402
  Web search, page reading, prices and market data for agents via x402, in USDC on Base or Solana.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.ironflowsh/mcp.svg)](https://aptlynx.net/servers/io.github.ironflowsh/mcp)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents