Read-only Hyperliquid data for AI agents: fills, candles, funding, liquidations, wallet analytics.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Returns the SQL tables of Ironflow's Hyperliquid data (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.
This tool takes no arguments.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
claude mcp add --transport http hyperliquid https://mcp.ironflow.sh/mcp
Returns the SQL tables of Ironflow's Hyperliquid data (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.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}OHLCV candles for a Hyperliquid market, computed from tick-level trades.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of candles to return (1-500, default 24) |
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
| interval | string | Candle interval (1m, 5m, 15m, 1h, 4h, 1d). Default: 1h |
{
"type": "object",
"required": [
"market"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of candles to return (1-500, default 24)"
},
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
},
"interval": {
"enum": [
"1m",
"5m",
"15m",
"1h",
"4h",
"1d"
],
"type": "string",
"description": "Candle interval (1m, 5m, 15m, 1h, 4h, 1d). Default: 1h"
}
}
}Wallet addresses in one named wallet cohort.
| Argument | Type | Description |
|---|---|---|
| name* | string | Cohort name (e.g. top_pnl_30d, high_volume_30d, whale_fills, or a custom cohort name) |
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "Cohort name (e.g. top_pnl_30d, high_volume_30d, whale_fills, or a custom cohort name)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of wallets (1-25, default 10) |
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
| window | string | Lookback window. Default 30d |
{
"type": "object",
"required": [
"market"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of wallets (1-25, default 10)"
},
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
},
"window": {
"enum": [
"7d",
"30d"
],
"type": "string",
"description": "Lookback window. Default 30d"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of fills (1-100, default 20) |
| market | string | Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA) |
| address* | string | Wallet address (e.g. 0x...) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of fills (1-100, default 20)"
},
"market": {
"type": "string",
"description": "Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA)"
},
"address": {
"type": "string",
"description": "Wallet address (e.g. 0x...)"
}
}
}Hourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of funding rate entries (1-100, default 10) |
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
{
"type": "object",
"required": [
"market"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of funding rate entries (1-100, default 10)"
},
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
}
}
}Funding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of data points (default 7) |
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
| interval | string | Time interval (1h, 4h, 8h, 1d, 7d). Default: 1d |
{
"type": "object",
"required": [
"market"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of data points (default 7)"
},
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
},
"interval": {
"enum": [
"1h",
"4h",
"8h",
"1d",
"7d"
],
"type": "string",
"description": "Time interval (1h, 4h, 8h, 1d, 7d). Default: 1d"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
| bucket_size | string | Price bucket size (1, 5, 10, 50, 100, 500, 1000, 5000). Default: 100 |
{
"type": "object",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
},
"bucket_size": {
"type": "string",
"description": "Price bucket size (1, 5, 10, 50, 100, 500, 1000, 5000). Default: 100"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| market | string | Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA) |
| minutes | number | Lookback in minutes (default 60, max 240) |
{
"type": "object",
"required": [],
"properties": {
"market": {
"type": "string",
"description": "Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA)"
},
"minutes": {
"type": "number",
"description": "Lookback in minutes (default 60, max 240)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of liquidation events (1-100, default 20) |
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
{
"type": "object",
"required": [
"market"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of liquidation events (1-100, default 20)"
},
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
}
}
}Latest mark price, oracle price and hourly funding rate of a Hyperliquid perp.
| Argument | Type | Description |
|---|---|---|
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
{
"type": "object",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
}
}
}The best traders on one Hyperliquid market, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of traders (1-50, default 20) |
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
| window | string | Lookback window. Default 30d |
{
"type": "object",
"required": [
"market"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of traders (1-50, default 20)"
},
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
},
"window": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Lookback window. Default 30d"
}
}
}Top wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows.
| Argument | Type | Description |
|---|---|---|
| to | string | Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default now |
| from | string | Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default 24 hours ago |
| limit | number | Number of rows, max 200, default 25 |
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
| sort_by | string | Ranking metric |
{
"type": "object",
"required": [
"market"
],
"properties": {
"to": {
"type": "string",
"description": "Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default now"
},
"from": {
"type": "string",
"description": "Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default 24 hours ago"
},
"limit": {
"type": "number",
"description": "Number of rows, max 200, default 25"
},
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
},
"sort_by": {
"enum": [
"volume",
"realized_pnl"
],
"type": "string",
"description": "Ranking metric"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Rows to return (1-200, default 25) |
| order | string | desc (default) or asc |
| issuer | string | HIP-3 builder code (e.g. 'xyz'). Omit to include every issuer. |
| sort_by | string | Ranking key (default volume). funding_rate is hourly; positive means longs pay shorts. |
| market_class | string | Filter to one class |
| min_volume_usd | number | Skip markets with less 24h volume than this (USD) |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "Rows to return (1-200, default 25)"
},
"order": {
"enum": [
"desc",
"asc"
],
"type": "string",
"description": "desc (default) or asc"
},
"issuer": {
"type": "string",
"description": "HIP-3 builder code (e.g. 'xyz'). Omit to include every issuer."
},
"sort_by": {
"enum": [
"volume",
"open_interest",
"funding",
"abs_funding",
"change_24h",
"abs_change_24h"
],
"type": "string",
"description": "Ranking key (default volume). funding_rate is hourly; positive means longs pay shorts."
},
"market_class": {
"enum": [
"perp",
"spot",
"prediction",
"option"
],
"type": "string",
"description": "Filter to one class"
},
"min_volume_usd": {
"type": "number",
"description": "Skip markets with less 24h volume than this (USD)"
}
}
}Latest open interest of a Hyperliquid perp, in base units, with its 24h volume in USD.
| Argument | Type | Description |
|---|---|---|
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
{
"type": "object",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| to | string | Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default now |
| from | string | Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default 30 days ago |
| limit | number | Number of rows, max 200, default 50 |
| sort_by | string | Ranking metric |
{
"type": "object",
"required": [],
"properties": {
"to": {
"type": "string",
"description": "Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default now"
},
"from": {
"type": "string",
"description": "Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default 30 days ago"
},
"limit": {
"type": "number",
"description": "Number of rows, max 200, default 50"
},
"sort_by": {
"enum": [
"realized_pnl",
"loss",
"volume"
],
"type": "string",
"description": "Ranking metric"
}
}
}Latest mark price of a Hyperliquid market: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot.
| Argument | Type | Description |
|---|---|---|
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
{
"type": "object",
"required": [
"market"
],
"properties": {
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of trades to return (1-100, default 20) |
| market* | string | Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA) |
{
"type": "object",
"required": [
"market"
],
"properties": {
"limit": {
"type": "number",
"description": "Number of trades to return (1-100, default 20)"
},
"market": {
"type": "string",
"description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
}
}
}Ironflow service status right now: overall state, data freshness per venue and component health.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Ironflow uptime and data freshness per hour over the last 24 hours (default) or 7 days.
| Argument | Type | Description |
|---|---|---|
| period | string | Lookback window. '24h' (default) or '7d'. |
{
"type": "object",
"required": [],
"properties": {
"period": {
"enum": [
"24h",
"7d"
],
"type": "string",
"description": "Lookback window. '24h' (default) or '7d'."
}
}
}Ironflow performance over rolling windows: API latency and error rate, ingestion lag and synthetic probe timings.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| sort | string | Ranking. Default top |
| limit | number | Number of traders (1-50, default 20) |
| window | string | Lookback window. Default 30d |
{
"type": "object",
"required": [],
"properties": {
"sort": {
"enum": [
"top",
"lowrisk",
"new"
],
"type": "string",
"description": "Ranking. Default top"
},
"limit": {
"type": "number",
"description": "Number of traders (1-50, default 20)"
},
"window": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Lookback window. Default 30d"
}
}
}A Hyperliquid wallet's trading record over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and its best markets.
| Argument | Type | Description |
|---|---|---|
| window | string | Lookback window. Default 30d |
| address* | string | 0x-prefixed 20-byte hex address |
{
"type": "object",
"required": [
"address"
],
"properties": {
"window": {
"enum": [
"7d",
"30d",
"90d"
],
"type": "string",
"description": "Lookback window. Default 30d"
},
"address": {
"type": "string",
"description": "0x-prefixed 20-byte hex address"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| to | string | Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z) |
| from | string | Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z) |
| limit | number | Most recent rows to return (default 200) |
| bucket | string | Aggregation bucket; default 1d |
| market | string | Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA) |
| address* | string | 0x-prefixed 20-byte hex address |
{
"type": "object",
"required": [
"address"
],
"properties": {
"to": {
"type": "string",
"description": "Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z)"
},
"from": {
"type": "string",
"description": "Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z)"
},
"limit": {
"type": "number",
"description": "Most recent rows to return (default 200)"
},
"bucket": {
"enum": [
"1h",
"1d",
"raw"
],
"type": "string",
"description": "Aggregation bucket; default 1d"
},
"market": {
"type": "string",
"description": "Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA)"
},
"address": {
"type": "string",
"description": "0x-prefixed 20-byte hex address"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| to | string | Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z) |
| from | string | Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z) |
| limit | number | Max entries, default 1000, cap 10000 |
| address* | string | 0x-prefixed 20-byte hex address |
| event_types | string | Comma-separated type filter (deposit,withdrawal,vault_deposit,vault_withdraw,vault_transfer_in,vault_transfer_out) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"to": {
"type": "string",
"description": "Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z)"
},
"from": {
"type": "string",
"description": "Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z)"
},
"limit": {
"type": "number",
"description": "Max entries, default 1000, cap 10000"
},
"address": {
"type": "string",
"description": "0x-prefixed 20-byte hex address"
},
"event_types": {
"type": "string",
"description": "Comma-separated type filter (deposit,withdrawal,vault_deposit,vault_withdraw,vault_transfer_in,vault_transfer_out)"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| to | string | Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z) |
| from | string | Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z) |
| market | string | Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA) |
| address* | string | 0x-prefixed 20-byte hex address |
{
"type": "object",
"required": [
"address"
],
"properties": {
"to": {
"type": "string",
"description": "Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z)"
},
"from": {
"type": "string",
"description": "Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z)"
},
"market": {
"type": "string",
"description": "Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA)"
},
"address": {
"type": "string",
"description": "0x-prefixed 20-byte hex address"
}
}
}Realized PnL curve of a Hyperliquid wallet over time, bucketed (for example hourly or daily).
| Argument | Type | Description |
|---|---|---|
| to | string | Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default now |
| from | string | Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z) |
| address* | string | 0x-prefixed 20-byte hex address |
| bucket_ms | number | Bucket size in ms (e.g. 3600000 for 1h) |
{
"type": "object",
"required": [
"address"
],
"properties": {
"to": {
"type": "string",
"description": "Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default now"
},
"from": {
"type": "string",
"description": "Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z)"
},
"address": {
"type": "string",
"description": "0x-prefixed 20-byte hex address"
},
"bucket_ms": {
"type": "number",
"description": "Bucket size in ms (e.g. 3600000 for 1h)"
}
}
}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?'
| Argument | Type | Description |
|---|---|---|
| address* | string | 0x-prefixed 20-byte hex address |
{
"type": "object",
"required": [
"address"
],
"properties": {
"address": {
"type": "string",
"description": "0x-prefixed 20-byte hex address"
}
}
}One Hyperliquid wallet's stats over a window: volume, realized PnL, fill count, win rate, maker share and markets traded.
| Argument | Type | Description |
|---|---|---|
| to | string | Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default now |
| from | string | Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default 24 hours ago |
| address* | string | 0x-prefixed 20-byte hex address |
{
"type": "object",
"required": [
"address"
],
"properties": {
"to": {
"type": "string",
"description": "Window end: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default now"
},
"from": {
"type": "string",
"description": "Window start: Unix ms or seconds, or ISO 8601 (2026-10-01T00:00:00Z). Default 24 hours ago"
},
"address": {
"type": "string",
"description": "0x-prefixed 20-byte hex address"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of vaults (default 10, max 1000) |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "Number of vaults (default 10, max 1000)"
}
}
}Deposits into and withdrawals from one Hyperliquid vault or one depositor. Pass vault, address, or both; at least one is required (HLP is 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303).
| Argument | Type | Description |
|---|---|---|
| limit | number | Number of events (1-100, default 20) |
| vault | string | Vault address (vault or address is required) |
| address | string | Depositor address (vault or address is required) |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "number",
"description": "Number of events (1-100, default 20)"
},
"vault": {
"type": "string",
"description": "Vault address (vault or address is required)"
},
"address": {
"type": "string",
"description": "Depositor address (vault or address is required)"
}
}
}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 label.
| Argument | Type | Description |
|---|---|---|
| label | string | Only wallets carrying this label |
| limit | number | Wallets to return (default 20, max 100) |
| sort_by | string | Sort order when listing (default volume) |
| addresses | string | Comma-separated wallet addresses (up to 50). Omit to list wallets instead. |
| min_volume_usd | number | Only wallets with at least this 30-day volume |
{
"type": "object",
"required": [],
"properties": {
"label": {
"enum": [
"market_maker",
"high_frequency",
"whale",
"directional",
"consistent_winner",
"big_loser",
"revenge_sizing",
"often_liquidated",
"hip3_trader",
"spot_trader",
"prediction_trader"
],
"type": "string",
"description": "Only wallets carrying this label"
},
"limit": {
"type": "number",
"description": "Wallets to return (default 20, max 100)"
},
"sort_by": {
"enum": [
"volume",
"pnl",
"fills",
"liquidations"
],
"type": "string",
"description": "Sort order when listing (default volume)"
},
"addresses": {
"type": "string",
"description": "Comma-separated wallet addresses (up to 50). Omit to list wallets instead."
},
"min_volume_usd": {
"type": "number",
"description": "Only wallets with at least this 30-day volume"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| addresses | string | Comma-separated wallet addresses to look up |
| smart_top_n | number | Top N smart-money wallets to include (max 500, default 100) |
| whale_top_n | number | Top N whales to include (max 500, default 100) |
{
"type": "object",
"required": [],
"properties": {
"addresses": {
"type": "string",
"description": "Comma-separated wallet addresses to look up"
},
"smart_top_n": {
"type": "number",
"description": "Top N smart-money wallets to include (max 500, default 100)"
},
"whale_top_n": {
"type": "number",
"description": "Top N whales to include (max 500, default 100)"
}
}
}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
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Find how a Hyperliquid market is named: perps (native and HIP-3), spot and live HIP-4 outcomes, with symbol, class, issuer, base asset and Hyperliquid coin. Search with q (q=nvda finds xyz:NVDA-PERP and the other NVDA perps). Pages of up to 100 rows; pass pagination.next_cursor as cursor for the next page.
| Argument | Type | Description |
|---|---|---|
| q | string | Case-insensitive search over symbol, base asset, Hyperliquid coin and issuer |
| limit | number | Rows per page (default 100, max 100) |
| cursor | string | pagination.next_cursor from the previous page, with the same filters |
| issuer | string | HIP-3 issuer code (e.g. 'xyz'). '' returns native markets only. Omit for every issuer. |
| source | string | Venue. Default 'hyperliquid'. |
| market_class | string | Only this class. 'prediction' is HIP-4 outcomes. Omit for all. |
| include_inactive | boolean | Also return closed markets (delisted, settled HIP-4 outcomes), which carry active_to_ms. Default false. |
{
"type": "object",
"required": [],
"properties": {
"q": {
"type": "string",
"description": "Case-insensitive search over symbol, base asset, Hyperliquid coin and issuer"
},
"limit": {
"type": "number",
"description": "Rows per page (default 100, max 100)"
},
"cursor": {
"type": "string",
"description": "pagination.next_cursor from the previous page, with the same filters"
},
"issuer": {
"type": "string",
"description": "HIP-3 issuer code (e.g. 'xyz'). '' returns native markets only. Omit for every issuer."
},
"source": {
"type": "string",
"description": "Venue. Default 'hyperliquid'."
},
"market_class": {
"enum": [
"perp",
"spot",
"prediction",
"option"
],
"type": "string",
"description": "Only this class. 'prediction' is HIP-4 outcomes. Omit for all."
},
"include_inactive": {
"type": "boolean",
"description": "Also return closed markets (delisted, settled HIP-4 outcomes), which carry active_to_ms. Default false."
}
}
}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). Aggregate in SQL: results are capped (1,000 rows keyless). Keyless: last 24 hours, 5 s per query, 60 query seconds per hour per IP; a free key from https://ironflow.sh/key gives 30 days of history.
| Argument | Type | Description |
|---|---|---|
| sql* | string | One ClickHouse SELECT (or WITH ... SELECT) over hl.* tables, without a FORMAT clause |
| max_rows | number | Most rows to return (default 200, capped by your tier) |
{
"type": "object",
"required": [
"sql"
],
"properties": {
"sql": {
"type": "string",
"description": "One ClickHouse SELECT (or WITH ... SELECT) over hl.* tables, without a FORMAT clause"
},
"max_rows": {
"type": "number",
"description": "Most rows to return (default 200, capped by your tier)"
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 3, 2026.