Ironflow Hyperliquid

Read-only Hyperliquid market data and wallet analytics from Ironflow's own nodes.

CommunityOnlineNo sign-inGlobalFreeRead-only

What it can do

  • 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.

What data it sees

Do you need an account

No: the server works without sign-in

Read-only Hyperliquid market data and wallet analytics from Ironflow's own nodes. Covers native perps, HIP-3 builder markets, HIP-4 outcome contracts and spot.

What it answers

  • Trades, candles, funding rates, open interest and mark prices for any market
  • Liquidations per market, plus a summary across all markets for the last N minutes
  • Any wallet's fills, open positions, funding paid, maker/taker split and PnL curve
  • Trader rankings: top traders, best traders per market, wallets whose large orders preceded moves

Access No API key needed: 10 requests per minute and 24 hours of history. A free key from ironflow.sh/key raises that to 60 per minute and 30 days. Every tool is read-only and never places an order.

How to connect

How to connect Ironflow Hyperliquid to Claude

The server address to paste into Claude settings:

https://hyperliquid--ironflow.run.tools

  1. Open Claude (claude.ai or the desktop app).
  2. Go to Settings → Connectors.
  3. Click Add custom connector.
  4. Paste the server address copied below into Remote MCP server URL and click Add.
  5. In a chat, click + → Connectors and switch the new connector on.

Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.

Authorization

After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.

How to connect Ironflow Hyperliquid to ChatGPT

The server address to paste into ChatGPT settings:

https://hyperliquid--ironflow.run.tools

  1. Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
  2. Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
  3. Open Settings → Connectors and click Create.
  4. Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
  5. Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
  6. In a new chat open + → Apps/Connectors and enable the connector.

OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.

Authorization

On first use ChatGPT opens the service's sign-in window. Sign in and approve access.

How to connect Ironflow Hyperliquid to Cursor

The server address to paste into Cursor settings:

https://hyperliquid--ironflow.run.tools

Fastest: click Open in Cursor below and confirm the prompt.

Manually:

  1. In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
  2. Paste the JSON copied below into ~/.cursor/mcp.json (per project: .cursor/mcp.json in the repo root).
  3. Save the file. The server appears in the MCP list; authorize it there if asked.

Authorization

If the service needs sign-in, an authorize button appears next to the server in the MCP list.

Server tool list (33)

Raw names from tools/list. Only developers need these.

get_priceLatest mark price of a Hyperliquid market: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot.
get_recent_tradesLatest 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_candlesOHLCV candles for a Hyperliquid market, computed from tick-level trades.
get_funding_ratesHourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts.
get_open_interestLatest open interest for a Hyperliquid perp.
get_liquidationsLiquidations 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_summaryLiquidations 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 to 240.
get_fillsEvery 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_pricesMark price and oracle price series for a Hyperliquid perp.
get_vault_operationsDeposits into and withdrawals from Hyperliquid vaults. Pass a vault address, a depositor address, or both; one is required.
get_liquidation_levelsLiquidated 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_leaderboardHyperliquid vaults ranked by net deposits. Needs a Builder or Enterprise key; keyless and free-key calls return 403.
get_funding_statsFunding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate.
get_user_stateOpen 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_fundingFunding 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_takerMaker 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_ledgerVault 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_leaderboardEvery 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_walletsTop wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows.
get_markets_snapshotEvery active Hyperliquid market in one call: mark price, 24h change, open interest and latest funding. Use it to scan for funding extremes or big movers. Filter by market_class or HIP-3 issuer.
get_user_summaryOne Hyperliquid wallet's stats over a window: volume, realized PnL, fill count, win rate, maker share and markets traded.
get_wallet_labelsLabels for notable Hyperliquid wallets: top whales by 24h volume, top traders by 30-day realized PnL, vaults and vault leaders. Returns a map of address to labels; fetch once and look addresses up locally.
get_user_pnl_seriesRealized PnL curve of a Hyperliquid wallet over time, bucketed (for example hourly or daily).
get_top_tradersHyperliquid 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_leadersThe best traders on one Hyperliquid market, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.
get_early_moversWallets 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_profileA Hyperliquid wallet's trading record over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and its best markets.
list_cohortsList 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_addressesGet the wallet addresses in a specific cohort
get_statusGet system status, data freshness, and venue health (unauthenticated)
get_status_metricsGet rolling-window API + pipeline + synthetic performance metrics (unauthenticated)
get_status_historyGet an uptime / freshness timeline. period: '24h' (default) or '7d' (unauthenticated)
list_marketsEvery active Hyperliquid market with its display symbol, class (perp, spot, prediction), HIP-3 issuer and base asset. Call it when unsure how a market is named.