Read-only Hyperliquid data for AI agents: fills, candles, funding, liquidations, wallet analytics.
| Endpoint | https://mcp.ironflow.sh/mcp (streamable-http) |
|---|---|
| Registry version | 0.9.0 |
| Now | 36 tools · grade C (75) · pin ts_851ce92a7fd1e8067d482af0f75d45d6 · protocol 2025-06-18 |
| First / last listed | 2026-10-28 07:31 UTC / 2026-10-28 07:31 UTC |
| Grade over time | 2026-10-28: C (75), 36 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: describe_data run_query get_wallet_behavior get_price get_recent_trades get_candles get_funding_rates get_open_interest get_liquidations get_liquidation_summary get_fills get_mark_prices get_vault_operations get_liquidation_levels get_vault_leaderboard get_funding_stats get_user_state get_user_funding get_user_maker_taker get_user_ledger get_pnl_leaderboard get_market_top_wallets get_markets_snapshot get_user_summary get_wallet_labels get_user_pnl_series get_top_traders get_market_leaders get_early_movers get_trader_profile list_cohorts get_cohort_addresses get_status get_status_metrics get_status_history list_markets
describe_data | 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), their columns, how far back each goes, query tips, worked examples and your own limits. params: none |
run_query | 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 examples. Aggregate in SQL: results are capped (1,000 rows keyless). Keyless: last 24 hours, 5 s per quer params: sql*, max_rows |
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, often_liquidated, hip3_trader, spot_trader, prediction_trader) and the numbers behind them (maker share, buy/sell imbalance, fills per day, green-day share, profit factor, liquidations). Look up specific addresses, or list wallets with one params: addresses, label, sort_by, min_volume_usd, limit |
get_price | Latest mark price of a Hyperliquid market: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot. params: market* |
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. params: market*, limit |
get_candles | OHLCV candles for a Hyperliquid market, computed from tick-level trades. params: market*, interval, limit |
get_funding_rates | Hourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts. params: market*, limit |
get_open_interest | Latest open interest for a Hyperliquid perp. params: market* |
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. params: market*, limit |
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. params: minutes, market |
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. params: address*, market, limit |
get_mark_prices | Mark price and oracle price series for a Hyperliquid perp. params: market* |
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 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303). For flows across all vaults use get_vault_leaderboard. params: vault, address, limit |
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. params: market*, bucket_size |
get_vault_leaderboard | 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. params: limit |
get_funding_stats | Funding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate. params: market*, interval, limit |
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?' params: address* |
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. params: address*, market, from, to, bucket, limit |
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. params: address*, market, from, to |
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. params: address*, from, to, event_types, limit |
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. params: from, to, limit, sort_by |
get_market_top_wallets | Top wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows. params: market*, from, to, limit, sort_by |
get_markets_snapshot | 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 unless limit is set. params: market_class, issuer, sort_by, order, limit, min_volume_usd |
get_user_summary | One Hyperliquid wallet's stats over a window: volume, realized PnL, fill count, win rate, maker share and markets traded. params: address*, from, to |
get_wallet_labels | 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. params: addresses, whale_top_n, smart_top_n |
get_user_pnl_series | Realized PnL curve of a Hyperliquid wallet over time, bucketed (for example hourly or daily). params: address*, from, to, bucket_ms |
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. params: window, sort, limit |
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. params: market*, window, limit |
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. params: market*, window, limit |
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. params: address*, window |
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 params: none |
get_cohort_addresses | Get the wallet addresses in a specific cohort params: name* |
get_status | Get system status, data freshness, and venue health (unauthenticated) params: none |
get_status_metrics | Get rolling-window API + pipeline + synthetic performance metrics (unauthenticated) params: none |
get_status_history | Get an uptime / freshness timeline. period: '24h' (default) or '7d' (unauthenticated) params: period |
list_markets | 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). params: source, market_class, issuer, search, limit |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.