io.github.ironflowsh/mcp
REMOTE · MCP.IRONFLOW.SH · 2 COMPONENTS · SCANNED OCT 4
Read-only Hyperliquid data for AI agents: fills, candles, funding, liquidations, wallet analytics.
Available components
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security80
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC check failed: this domain isn't protected by DNSSEC. See how to fix → View diagnostics → Fail
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability77
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 4053 tokens (~112/item across 36 items; 36 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management33
- Stability observed for 10 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 36 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 37 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
How do I install the io.github.ironflowsh/mcp server?
io.github.ironflowsh/mcp is a hosted endpoint at https://mcp.ironflow.sh/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · mcp.ironflow.sh
claude mcp add --transport http ironflowsh-mcp 'https://mcp.ironflow.sh/mcp'
{
"mcpServers": {
"ironflowsh-mcp": {
"url": "https://mcp.ironflow.sh/mcp"
}
}
} {
"servers": {
"ironflowsh-mcp": {
"type": "http",
"url": "https://mcp.ironflow.sh/mcp"
}
}
} [mcp_servers.ironflowsh-mcp] url = "https://mcp.ironflow.sh/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ironflowsh-mcp": {
"type": "remote",
"url": "https://mcp.ironflow.sh/mcp",
"enabled": true
}
}
} openclaw mcp add ironflowsh-mcp --url 'https://mcp.ironflow.sh/mcp' --transport streamable-http
mcp_servers:
ironflowsh-mcp:
url: "https://mcp.ironflow.sh/mcp" {
"McpServers": {
"ironflowsh-mcp": {
"Transport": "http",
"Url": "https://mcp.ironflow.sh/mcp"
}
}
} assistant mcp add ironflowsh-mcp -t streamable-http -u 'https://mcp.ironflow.sh/mcp'
{
"mcpServers": {
"ironflowsh-mcp": {
"type": "http",
"url": "https://mcp.ironflow.sh/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 2 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.
- 30 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.
- 28 Sept 26 +8
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
- 26 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.
- 25 Sept 26 0
- Stability: unverified → 0.03 ▲ functional
- 24 Sept 26 67
First indexed and scored.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 4 Oct 2026 · Probed https://mcp.ironflow.sh/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=ironflow.sh | CN=YE1,O=Let's Encrypt,C=US | 24 Sept 2026 | 23 Dec 2026 | ECDSA 256 | ECDSA-SHA384 | 5158de91184221e52fd79ca2f68b7e5aed8 |
| SANs: *.ironflow.sh, ironflow.sh | ||||||
| CN=YE1,O=Let's Encrypt,C=US (CA) | CN=Root YE,O=ISRG,C=US | 3 Sept 2025 | 2 Sept 2028 | ECDSA 384 | ECDSA-SHA384 | 5ddd70dd31f801c85c186a7a04b80afe |
| CN=Root YE,O=ISRG,C=US (CA) | CN=ISRG Root X2,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | ECDSA-SHA384 | 872165fc34b6e5fba8add5b3705fb53a |
| CN=ISRG Root X2,O=Internet Security Research Group,C=US (CA) | CN=ISRG Root X1,O=Internet Security Research Group,C=US | 13 May 2026 | 2 Sept 2032 | ECDSA 384 | SHA256-RSA | 6c8f1dc727c7117f7baf853ac980f9cd |
Background: What to check on a remote MCP endpoint →
DNSSEC insecure
Validation of mcp.ironflow.sh. — Not signed
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| sh. | present | 55297 | 8 | Verified |
| ironflow.sh. | absent | Unsigned (proven) parent-signed NSEC/NSEC3 proves an unsigned delegation |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=31536000; includeSubDomains; preload |
| x-content-type-options | nosniff |
| x-frame-options | DENY |
| referrer-policy | strict-origin-when-cross-origin |
| permissions-policy | camera=(), microphone=(), geolocation=() |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://mcp.ironflow.sh/mcp | Verified | 200 | |
| http (plaintext) | http://mcp.ironflow.sh/mcp | HTTPS enforced | 308 | https://mcp.ironflow.sh/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
describe_data ~88
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| dialect | – | – | SQL dialect and database name |
| examples | array | – | Worked examples |
| limits | – | – | Your tier's limits: history_days, max_execution_seconds, max_rows, budget_seconds_per_hour |
| tables | array | – | Queryable tables |
| tiers | array | – | Every tier's limits |
| tips | array | – | Query tips |
No examples provided.
get_candles ~149
OHLCV candles for a Hyperliquid market, computed from tick-level trades.
| Name | Type | Req | Description |
|---|---|---|---|
| interval | string | – | Candle interval (1m, 5m, 15m, 1h, 4h, 1d). Default: 1h |
| limit | number | – | Number of candles to return (1-500, default 24) |
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | OHLCV candles |
| pagination | object | – | Cursor pagination |
No examples provided.
get_cohort_addresses ~55
Get the wallet addresses in a specific cohort
| Name | Type | Req | Description |
|---|---|---|---|
| name | string | yes | Cohort name (e.g. top_pnl_30d, high_volume_30d, whale_fills, or a custom cohort name) |
| Name | Type | Req | Description |
|---|---|---|---|
| addresses | array | – | Wallets |
| fetched_at | – | – | Unix milliseconds |
No examples provided.
get_early_movers ~123
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of wallets (1-25, default 10) |
| market | string | yes | Market symbol (e.g. "BTC-PERP", "xyz:SKHX-PERP") |
| window | string | – | Lookback window. Default 30d |
| Name | Type | Req | Description |
|---|---|---|---|
| formula | – | – | How the lead score is computed |
| market | – | – | Display symbol, e.g. "BTC-PERP" or "xyz:NVDA-PERP" |
| signals | array | – | Wallets |
| window | – | – | Lookback window, e.g. "30d" |
No examples provided.
get_fills ~142
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Wallet address (e.g. 0x...) |
| limit | number | – | Number of fills (1-100, default 20) |
| market | string | – | Optional market filter — native HL (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Fills for one wallet, newest first |
| pagination | object | – | Cursor pagination |
No examples provided.
get_funding_rates ~122
Hourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of funding rate entries (1-100, default 10) |
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Hourly funding rates |
| pagination | object | – | Cursor pagination |
No examples provided.
get_funding_stats ~129
Funding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate.
| Name | Type | Req | Description |
|---|---|---|---|
| interval | string | – | Time interval (1h, 4h, 8h, 1d, 7d). Default: 1d |
| limit | number | – | Number of data points (default 7) |
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Buckets |
No examples provided.
get_liquidation_levels ~140
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.
| Name | Type | Req | Description |
|---|---|---|---|
| bucket_size | string | – | Price bucket size (1, 5, 10, 50, 100, 500, 1000, 5000). Default: 100 |
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Price buckets |
No examples provided.
get_liquidation_summary ~121
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.
| Name | Type | Req | Description |
|---|---|---|---|
| market | string | – | Optional market filter (e.g. "BTC-PERP") |
| minutes | number | – | Lookback in minutes (default 60, max 240) |
| Name | Type | Req | Description |
|---|---|---|---|
| by_market | array | – | Top markets by liquidated notional |
| complete | – | – | False when the page cap was hit and totals are a lower bound |
| count | – | – | Number of liquidations |
| from | – | – | Window start, Unix milliseconds |
| largest | object | – | Largest single liquidation, or null when there were none |
| longs_liquidated_usd | – | – | Notional of liquidated longs in USD |
| market | – | – | Market filter, or null for all markets |
| notional_usd | – | – | Liquidated notional in USD |
| shorts_liquidated_usd | – | – | Notional of liquidated shorts in USD |
| to | – | – | Window end, Unix milliseconds |
No examples provided.
get_liquidations ~130
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of liquidation events (1-100, default 20) |
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Liquidations |
| pagination | object | – | Cursor pagination |
No examples provided.
get_mark_prices ~70
Mark price and oracle price series for a Hyperliquid perp.
| Name | Type | Req | Description |
|---|---|---|---|
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP") or HIP-3 builder market "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Mark price samples |
| pagination | object | – | Cursor pagination |
No examples provided.
get_market_leaders ~97
The best traders on one Hyperliquid market, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of traders (1-50, default 20) |
| market | string | yes | Market symbol (e.g. "BTC-PERP", "xyz:NVDA-PERP") |
| window | string | – | Lookback window. Default 30d |
| Name | Type | Req | Description |
|---|---|---|---|
| market | – | – | Display symbol, e.g. "BTC-PERP" or "xyz:NVDA-PERP" |
| traders | array | – | Traders |
| window | – | – | Lookback window, e.g. "30d" |
No examples provided.
get_market_top_wallets ~118
Top wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows.
| Name | Type | Req | Description |
|---|---|---|---|
| from | number | – | Unix ms window start (default 24h ago) |
| limit | number | – | Number of rows, max 200, default 25 |
| market | string | yes | Market symbol (e.g. 'BTC-PERP' or 'flx:GAS-PERP') |
| sort_by | string | – | Ranking metric |
| to | number | – | Unix ms window end (default now) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Wallets |
| from | – | – | Window start, Unix milliseconds |
| market | – | – | Display symbol, e.g. "BTC-PERP" or "xyz:NVDA-PERP" |
| sort_by | – | – | Ranking metric |
| to | – | – | Window end, Unix milliseconds |
No examples provided.
get_markets_snapshot ~201
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.
| Name | Type | Req | Description |
|---|---|---|---|
| issuer | string | – | HIP-3 builder code (e.g. 'xyz'). Omit to include every issuer. |
| limit | number | – | Rows to return (1-200, default 25) |
| market_class | string | – | Filter to one class |
| min_volume_usd | number | – | Skip markets with less 24h volume than this (USD) |
| order | string | – | desc (default) or asc |
| sort_by | string | – | Ranking key (default volume). funding_rate is hourly; positive means longs pay shorts. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Ranked markets |
| matched | – | – | Markets past the volume floor |
| order | – | – | desc or asc |
| returned | – | – | Rows in data |
| sort_by | – | – | Ranking key used |
| total_markets | – | – | Active markets before filtering |
No examples provided.
get_open_interest ~83
Latest open interest for a Hyperliquid perp.
| Name | Type | Req | Description |
|---|---|---|---|
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Open interest samples |
| pagination | object | – | Cursor pagination |
No examples provided.
get_pnl_leaderboard ~106
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.
| Name | Type | Req | Description |
|---|---|---|---|
| from | number | – | Unix ms window start (default 30d ago) |
| limit | number | – | Number of rows, max 200, default 50 |
| sort_by | string | – | Ranking metric |
| to | number | – | Unix ms window end (default now) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Wallets |
| from | – | – | Window start, Unix milliseconds |
| sort_by | – | – | Ranking metric |
| to | – | – | Window end, Unix milliseconds |
No examples provided.
get_price ~106
Latest mark price of a Hyperliquid market: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot.
| Name | Type | Req | Description |
|---|---|---|---|
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| market | – | – | Display symbol, e.g. "BTC-PERP" or "xyz:NVDA-PERP" |
| price | – | – | Price in USD |
No examples provided.
get_recent_trades ~136
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of trades to return (1-100, default 20) |
| market | string | yes | Market symbol — native HL perp (e.g. "BTC-PERP", "ETH-PERP") or HIP-3 builder market namespaced as "<issuer>:<base>-PERP" (e.g. "flx:GAS-PERP", "xyz:NVDA-PERP") |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Trades, newest first |
| pagination | object | – | Cursor pagination |
No examples provided.
get_status ~23
Get system status, data freshness, and venue health (unauthenticated)
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| components | – | – | data_pipeline, rest_api and streaming health |
| platform | – | – | Event and market counts |
| status | – | – | operational, degraded or down |
| timestamp | – | – | Unix milliseconds |
| uptime | – | – | Time since the last incident |
| venues | – | – | Freshness per venue |
No examples provided.
get_status_history ~57
Get an uptime / freshness timeline. period: '24h' (default) or '7d' (unauthenticated)
| Name | Type | Req | Description |
|---|---|---|---|
| period | string | – | Lookback window. '24h' (default) or '7d'. |
| Name | Type | Req | Description |
|---|---|---|---|
| period | – | – | 24h or 7d |
| points | array | – | Hourly buckets |
| uptime_percent | – | – | Share of operational hours |
No examples provided.
get_status_metrics ~24
Get rolling-window API + pipeline + synthetic performance metrics (unauthenticated)
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| api | – | – | Latency and error rate |
| pipeline | – | – | Ingestion latency and throughput |
| synthetic | – | – | Synthetic probe latencies |
| timestamp | – | – | Unix milliseconds |
No examples provided.
get_top_traders ~118
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.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of traders (1-50, default 20) |
| sort | string | – | Ranking. Default top |
| window | string | – | Lookback window. Default 30d |
| Name | Type | Req | Description |
|---|---|---|---|
| aggregate | object | – | Totals |
| sort | – | – | Ranking used |
| traders | array | – | Traders |
| window | – | – | Lookback window, e.g. "30d" |
No examples provided.
get_trader_profile ~80
A Hyperliquid wallet's trading record over 7, 30 or 90 days: win rate, profit factor, realized PnL, max drawdown and its best markets.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 0x-prefixed 20-byte hex address |
| window | string | – | Lookback window. Default 30d |
| Name | Type | Req | Description |
|---|---|---|---|
| address | – | – | Wallet address (0x…) |
| liquidation_count | – | – | Liquidations in the window |
| markets | array | – | Best markets, ranked |
| overall | object | – | Headline stats |
| trades | – | – | Recent round-trip trades |
| window | – | – | Lookback window, e.g. "30d" |
No examples provided.
get_user_funding ~140
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 0x-prefixed 20-byte hex address |
| bucket | string | – | Aggregation bucket; default 1d |
| from | number | – | Unix ms window start (inclusive) |
| limit | number | – | Most recent rows to return (default 200) |
| market | string | – | Optional market filter (e.g. BTC-PERP) |
| to | number | – | Unix ms window end (exclusive) |
| Name | Type | Req | Description |
|---|---|---|---|
| address | – | – | Wallet address (0x…) |
| bucket | – | – | Bucket size |
| data | array | – | Buckets |
| from | – | – | Window start, Unix milliseconds |
| returned | – | – | Rows in data, most recent first |
| to | – | – | Window end, Unix milliseconds |
| total_rows | – | – | Rows in the window before the limit |
No examples provided.
get_user_ledger ~139
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 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) |
| from | number | – | Unix ms window start |
| limit | number | – | Max entries, default 1000, cap 10000 |
| to | number | – | Unix ms window end |
| Name | Type | Req | Description |
|---|---|---|---|
| address | – | – | Wallet address (0x…) |
| data | array | – | Ledger entries |
| from | – | – | Window start, Unix milliseconds |
| to | – | – | Window end, Unix milliseconds |
No examples provided.
get_user_maker_taker ~96
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.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 0x-prefixed 20-byte hex address |
| from | number | – | Unix ms window start |
| market | string | – | Optional market filter |
| to | number | – | Unix ms window end |
| Name | Type | Req | Description |
|---|---|---|---|
| address | – | – | Wallet address (0x…) |
| data | array | – | Per market |
| from | – | – | Window start, Unix milliseconds |
| to | – | – | Window end, Unix milliseconds |
| total | object | – | All markets |
No examples provided.
get_user_pnl_series ~101
Realized PnL curve of a Hyperliquid wallet over time, bucketed (for example hourly or daily).
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 0x-prefixed 20-byte hex address |
| bucket_ms | number | – | Bucket size in ms (e.g. 3600000 for 1h) |
| from | number | – | Unix ms window start |
| to | number | – | Unix ms window end (default now) |
| Name | Type | Req | Description |
|---|---|---|---|
| address | – | – | Wallet address (0x…) |
| bucket | – | – | Bucket size |
| data | array | – | Buckets |
| from | – | – | Window start, Unix milliseconds |
| to | – | – | Window end, Unix milliseconds |
No examples provided.
get_user_state ~66
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?'
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 0x-prefixed 20-byte hex address |
| Name | Type | Req | Description |
|---|---|---|---|
| address | – | – | Wallet address (0x…) |
| as_of_ts | – | – | Snapshot time, Unix milliseconds |
| asset_positions | array | – | Open positions |
| margin_summary | object | – | Account totals |
No examples provided.
get_user_summary ~87
One Hyperliquid wallet's stats over a window: volume, realized PnL, fill count, win rate, maker share and markets traded.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | 0x-prefixed 20-byte hex address |
| from | number | – | Unix ms window start (default 24h ago) |
| to | number | – | Unix ms window end (default now) |
| Name | Type | Req | Description |
|---|---|---|---|
| address | – | – | Wallet address (0x…) |
| from | – | – | Window start, Unix milliseconds |
| state | object | – | Open positions right now |
| to | – | – | Window end, Unix milliseconds |
| window | object | – | Window totals |
No examples provided.
get_vault_leaderboard ~54
Hyperliquid vaults ranked by net deposits. Needs a Builder or Enterprise key; keyless and free-key calls return 403.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Number of vaults (default 10) |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Vaults |
No examples provided.
get_vault_operations ~75
Deposits into and withdrawals from Hyperliquid vaults. Pass a vault address, a depositor address, or both; one is required.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | – | User address |
| limit | number | – | Number of events (1-100, default 20) |
| vault | string | – | Vault address |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Vault deposits and withdrawals |
| pagination | object | – | Cursor pagination |
No examples provided.
get_wallet_behavior ~196
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.
| Name | Type | Req | Description |
|---|---|---|---|
| addresses | string | – | Comma-separated wallet addresses (up to 50). Omit to list wallets instead. |
| label | string | – | Only wallets carrying this label |
| limit | number | – | Wallets to return (default 20, max 100) |
| min_volume_usd | number | – | Only wallets with at least this 30-day volume |
| sort_by | string | – | Sort order when listing (default volume) |
| Name | Type | Req | Description |
|---|---|---|---|
| wallets | array | – | Wallets |
| window_days | – | – | Days the features cover |
No examples provided.
get_wallet_labels ~120
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.
| Name | Type | Req | 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) |
| Name | Type | Req | Description |
|---|---|---|---|
| counts | – | – | Wallets per label kind |
| generated_at | – | – | Unix milliseconds |
| labels | object | – | Address to its labels |
| note | – | – | What the labels map includes |
| source | – | – | Venue, always hyperliquid |
| ttl_seconds | – | – | Cache lifetime |
No examples provided.
list_cohorts ~61
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
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Cohorts |
No examples provided.
list_markets ~180
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).
| Name | Type | Req | Description |
|---|---|---|---|
| issuer | string | – | HIP-3 issuer code (e.g. 'flx'). Pass empty string '' to return only native non-builder markets. Omit to include every issuer. |
| limit | number | – | Rows to return (default 100) |
| market_class | string | – | Market class. Omit to return perp + spot + prediction. 'prediction' filters to HIP-4 outcome contracts. |
| search | string | – | Case-insensitive match on symbol, base asset or Hyperliquid coin |
| source | string | – | Venue. Defaults to 'hyperliquid'. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | array | – | Markets |
| matched | – | – | Markets matching the search |
| returned | – | – | Rows in data |
| total_markets | – | – | Active markets before search |
No examples provided.
run_query ~182
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 query, 60 query seconds per hour per IP; a free key from https://ironflow.sh/key gives 30 days of history.
| Name | Type | Req | Description |
|---|---|---|---|
| max_rows | number | – | Most rows to return (default 200, capped by your tier) |
| sql | string | yes | One ClickHouse SELECT (or WITH ... SELECT) over hl.* tables, without a FORMAT clause |
| Name | Type | Req | Description |
|---|---|---|---|
| budget_remaining_seconds | – | – | Query seconds left this hour |
| column_types | array | – | ClickHouse types in row order |
| columns | array | – | Column names in row order |
| limits | – | – | Your tier's limits |
| row_count | – | – | Rows returned |
| rows | array | – | Rows as positional arrays |
| stats | – | – | elapsed_ms, rows_read, bytes_read |
| truncated | – | – | true when more rows existed than were returned |
No examples provided.
What is the io.github.ironflowsh/mcp server?
io.github.ironflowsh/mcp is listed in the public MCP registry as io.github.ironflowsh/mcp. Read-only Hyperliquid data for AI agents: fills, candles, funding, liquidations, wallet analytics. This page covers its hosted endpoint (https://mcp.ironflow.sh/mcp).
Is the io.github.ironflowsh/mcp server safe to use?
io.github.ironflowsh/mcp scores 78 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.ironflowsh/mcp server expose?
io.github.ironflowsh/mcp exposes 36 tools: describe_data, run_query, get_wallet_behavior, get_price, get_recent_trades, and 31 more. Their descriptions and schemas cost roughly 3,915 tokens of context every time the server is loaded.
Does the io.github.ironflowsh/mcp server require authentication?
No. We connected to io.github.ironflowsh/mcp without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the io.github.ironflowsh/mcp server still maintained?
io.github.ironflowsh/mcp is still listed as active in the MCP registry. We last reached this channel on 4 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.