Ironflow Hyperliquid
Read-only Hyperliquid market data and wallet analytics from Ironflow's own nodes.
Что умеет
- 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.
Какие данные видит
Нужен ли аккаунт
Не нужен: сервер работает без входа
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.
Как подключить
Как подключить Ironflow Hyperliquid к Claude
Адрес сервера, который нужно вставить в настройках Claude:
https://hyperliquid--ironflow.run.tools
- Откройте Claude (сайт claude.ai или приложение для компьютера).
- Перейдите в Настройки → Коннекторы (в английском интерфейсе: Settings → Connectors).
- Нажмите Добавить пользовательский коннектор (Add custom connector).
- Вставьте адрес сервера, скопированный ниже, в поле URL удалённого MCP-сервера и нажмите Добавить.
- В чате нажмите + → Коннекторы и включите новый коннектор.
Пользовательские коннекторы доступны на тарифах Free, Pro, Max, Team и Enterprise. На Free можно добавить только один. В Team и Enterprise коннектор сначала добавляет владелец организации в Настройки организации → Коннекторы.
Авторизация
После нажатия Добавить откроется окно входа в сервис. Войдите под своим аккаунтом и подтвердите доступ. Пароль Claude не видит.
Как подключить Ironflow Hyperliquid к ChatGPT
Адрес сервера, который нужно вставить в настройках ChatGPT:
https://hyperliquid--ironflow.run.tools
- Откройте ChatGPT в браузере (chatgpt.com). Нужен тариф Plus, Pro, Business, Enterprise или Edu.
- Один раз включите режим разработчика: Настройки → Приложения → Дополнительные настройки → Режим разработчика (Settings → Apps → Advanced settings → Developer mode).
- Откройте Настройки → Коннекторы и нажмите Создать (Create).
- Заполните форму: Название (любое), Описание (одна фраза, что делает сервис), URL MCP-сервера (скопируйте ниже).
- В поле Аутентификация выберите OAuth, если сервис требует вход, иначе Нет. Нажмите Создать.
- В новом чате откройте + → Приложения/Коннекторы и включите коннектор.
Название раздела у OpenAI менялось (Connectors → Apps/Plugins). Если пункт называется иначе, ищите «режим разработчика» в настройках. В рабочих пространствах Business/Enterprise администратор должен разрешить пользовательские коннекторы.
Авторизация
При первом использовании ChatGPT откроет окно входа в сервис. Войдите и подтвердите доступ.
Как подключить Ironflow Hyperliquid к Cursor
Адрес сервера, который нужно вставить в настройках Cursor:
https://hyperliquid--ironflow.run.tools
Быстрый способ: нажмите кнопку Открыть в Cursor ниже, Cursor сам предложит добавить сервер.
Вручную:
- В Cursor откройте Settings → Cursor Settings → MCP и нажмите Add new global MCP server.
- Вставьте JSON, скопированный ниже, в открывшийся файл
~/.cursor/mcp.json(для одного проекта:.cursor/mcp.jsonв корне проекта). - Сохраните файл. Сервер появится в списке MCP; при необходимости пройдите авторизацию по кнопке рядом с ним.
Авторизация
Если сервис требует вход, рядом с сервером в списке MCP появится кнопка авторизации.
Список инструментов сервера (33)
Технические названия из tools/list. Нужны только разработчикам.
| 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 minutes, keyed calls up to 240. |
| 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 Hyperliquid vaults. Pass a vault address, a depositor address, or both; one is required. |
| 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. Needs a Builder or Enterprise key; keyless and free-key calls return 403. |
| 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 | Every 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_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. Returns a map of address to labels; fetch once and look addresses up locally. |
| 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 | Every 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. |