io.github.ironflowsh/hyperliquid

up checked 2026-11-11T08:37:40.143Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

Ironflow: Hyperliquid data

Publisher-provided description

Hyperliquid data and liquidation alerts for AI agents: fills, candles, funding, wallet analytics.

Summary by lookupd

Lets agents query Hyperliquid market data, wallet analytics and liquidation alerts, and run sandboxed paper trading strategies.

Install

Claude Code, remote (streamable-http)

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

Claude Code, npm package (stdio)

claude mcp add hyperliquid -- npx -y @ironflowsh/mcp

Codex, remote (streamable-http)

codex mcp add hyperliquid --url https://mcp.ironflow.sh/mcp

Codex, npm package (stdio)

codex mcp add hyperliquid -- npx -y @ironflowsh/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

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

Cursor, npm package (stdio) → .cursor/mcp.json

{
  "mcpServers": {
    "hyperliquid": {
      "command": "npx",
      "args": [
        "-y",
        "@ironflowsh/mcp"
      ]
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (showing 30 of 54)

Publisher-provided text

• describe_data Returns the SQL tables of Ironflow's Hyperliquid data (every fill and trade, per-market hourly volume and liquidation totals, per-wallet daily totals, wallet be
• run_query Run one read-only ClickHouse SELECT over Ironflow's Hyperliquid tables (hl.fills, hl.trades, hl.wallet_fills, hl.wallet_daily, hl.wallet_behavior, hl.market_hou
• 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,
• get_price Latest mark price of one Hyperliquid market as a single number: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot. The quickest answer to 'what is
• 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 outcome
• get_candles OHLCV candles for one Hyperliquid market, built from every trade: open, high, low, close, volume and trade count per candle, oldest first. Returns the latest 24
• 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 of one Hyperliquid perp in units of the base asset (BTC for BTC-PERP), with its 24-hour traded volume in USD and the time of the reading. M
• get_open_interest_changes Hyperliquid perps ranked by how their open interest moved over the last 1h, 4h, 24h or 7d: open interest at the start and now (in coins), the change in USD at t
• get_outcome_markets Hyperliquid HIP-4 outcome markets (prediction markets on sports, central bank decisions, IPOs and daily BTC price contracts) over the last 4 hours, 1 day or 1 w
• get_premium A Hyperliquid perp's mark price against its oracle price over time, with the premium in basis points ((mark / oracle - 1) x 10,000) per bucket and a summary (la
• 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.
• create_liquidation_alert Have Ironflow post Hyperliquid liquidations to the user's Discord channel, Slack channel, Telegram chat or HTTPS webhook as they happen (within seconds), filter
• list_liquidation_alerts The Hyperliquid liquidation alerts on this API key's account: where each posts (host only), its filter, whether it is active, failed deliveries in a row with th
• test_liquidation_alert Send a sample Hyperliquid liquidation, marked as a test, to an alert's destination now and report whether it arrived (delivered true or false, with the destinat
• delete_liquidation_alert Stop and remove one Hyperliquid liquidation alert from this API key's account; nothing more is sent to its destination.
• create_ironbox Spin up an Ironbox: a secure sandbox next to Hyperliquid where an agent runs and trades, with Ironflow data, analytics, alerts and execution built in. No key ne
• list_ironboxes The Ironboxes on this API key's account, the sandboxes where agents run and trade next to Hyperliquid: id, name, state (creating, running, stopped, deleted or e
• get_ironbox One Ironbox by id: its state (creating, running, stopped, deleted or error), size, mode, runtime, Hyperliquid markets and region.
• delete_ironbox Stop and delete one Ironbox from this API key's account; the agent in it stops running on Hyperliquid.
• start_box_strategy Start a strategy on a Hyperliquid paper box: it runs around the clock with no client connected, in simulation only. No key needed, the box URL authorises it, so
• list_box_strategies The strategies on a Hyperliquid paper box, running and recently stopped, each with its status, stop reason and result. Needs only the box URL.
• stop_box_strategy Stop one strategy on a Hyperliquid paper box: its orders are cancelled and its position is closed at the book, unless close_position is false. The answer says s
• get_box_activity What a Hyperliquid paper box and its strategies really did: strategy started, decisions with their reasons, orders, fills, funding, stops, plus equity, PnL, fee
• get_auto_deleveraging Hyperliquid auto-deleveraging (ADL) fills, newest first, across all markets or one: profitable positions Hyperliquid closed to cover a liquidation its backstop
• get_liquidation_summary Liquidations on Hyperliquid over a trailing window, totalled across every market or the ones named: count, wallets, notional, longs vs shorts liquidated, the to
• 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 end
• get_mark_prices Latest mark price, oracle price and current hourly funding rate of one Hyperliquid perp, with the time of the reading. The funding rate is a fraction per hour (
• 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 0xdfc24b077bc1425ad1de
• get_liquidation_levels Liquidations that happened on a Hyperliquid perp, bucketed by price and side: where longs and shorts were wiped out (side sell = a liquidated long). These are p

Changes

Newest first, as lookupd saw them

• 2026-11-11: version 0.17.2 → 0.17.3

Details

• Version: 0.17.3
• Transports: streamable-http, stdio
• Uptime (7 days): 100%
• Median latency: 1196 ms
• First indexed: 2026-11-03T10:17:38.462Z
• Last seen in registry: 2026-11-11T12:17:27.630Z
• Repository: https://github.com/ironflowsh/mcp

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.ironflowsh/hyperliquid.svg)](https://lookupd.com/servers/io.github.ironflowsh/hyperliquid)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp