Public log

@ironflowsh/mcp

Ironflow Hyperliquid MCP server: market data, liquidations, wallet analytics and liquidation alerts for AI agents and trading bots

npm · fingerprint bdb4299a12a6ebef3a8884db · repository · RSS

46tools
4recorded versions
6dtracked
changed 1d ago

What changed

Changed 2026-11-18 15:39 UTC

8 tools removed.

tool removed: create_ironbox

tool removed: delete_ironbox

tool removed: get_box_activity

tool removed: get_ironbox

tool removed: list_box_strategies

tool removed: list_ironboxes

tool removed: start_box_strategy

tool removed: stop_box_strategy

Changed 2026-11-15 14:00 UTC

42 descriptions rewritten.

--- pinned/describe_data
+++ observed/describe_data
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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 behaviour labels, funding rates and per-wallet funding payments, 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.",
+   "description": "What can SQL answer about Hyperliquid? Lists the SQL tables of Ironflow's Hyperliquid data (fills, trades, hourly market totals, wallet daily totals and labels, funding, prices, open interest, liquidations, builder fills, transfers, vault flows), their columns, how far back each goes, query tips, worked examples and your own limits. Call it before run_query. Costs no credits.",
    "inputSchema": {
      "properties": {},
      "required": [],
--- pinned/get_auto_deleveraging
+++ observed/get_auto_deleveraging
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Hyperliquid auto-deleveraging (ADL) fills, newest first, across all markets or one: profitable positions Hyperliquid closed to cover a liquidation its backstop could not absorb. Per fill: wallet, market, side, price, size, notional, realized PnL, trade id (shared with the liquidated side) and transaction hash. Recorded from 2026-08-01; the default window is the last 7 days. For the liquidated side use get_liquidations.",
+   "description": "Did Hyperliquid auto-deleverage anyone? Auto-deleveraging (ADL) fills, newest first, across all markets or one: profitable positions Hyperliquid closed to cover a liquidation its backstop could not absorb. Per fill: wallet, market, side, price, size, notional, realized PnL, trade id (shared with the liquidated side) and transaction hash. Recorded from 2026-08-01; the default window is the last 7 days. For the liquidated side use get_liquidations.",
    "inputSchema": {
      "properties": {
        "days": {
--- pinned/get_candles
+++ observed/get_candles
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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 candles by default (up to 500), at 1m to 1d intervals. Use it for price history, ranges and charts. For only the current price use get_price; for individual trades use get_recent_trades.",
+   "description": "How has a Hyperliquid market's price moved? OHLCV candles of one market, built from every trade: open, high, low, close, volume and trade count per candle, oldest first. For only the current price use get_price; for individual trades use get_recent_trades.",
    "inputSchema": {
      "properties": {
        "interval": {
--- pinned/get_cohort_addresses
+++ observed/get_cohort_addresses
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Wallet addresses in one named cohort: up to 100, each with the value the cohort ranks by (realized PnL in USD for top_pnl_30d, volume in USD for high_volume_30d), and fetched_at, when the cohort was last computed. Call list_cohorts first for the names and what each one selects. Feed the addresses to get_user_summary, get_trader_profile or get_wallet_behavior to look at each wallet.",
+   "description": "Which wallets are in a Hyperliquid cohort? Addresses in one named cohort: up to 100, each with the value the cohort ranks by (realized PnL in USD for top_pnl_30d, volume in USD for high_volume_30d), and fetched_at, when the cohort was last computed. Call list_cohorts first for the names and what each one selects. Feed the addresses to get_user_summary, get_trader_profile or get_wallet_behavior to look at each wallet.",
    "inputSchema": {
      "properties": {
        "name": {
--- pinned/get_early_movers
+++ observed/get_early_movers
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Wallets whose large orders (at least $10k) on one Hyperliquid market tended to come before price moved their way within 30 minutes, over the last 7 or 30 days. Per wallet: scored orders, notional, a lead score (notional-weighted 30-minute move in the order's direction, in basis points), hit rate, last order time and the share cancelled without a fill. At least 5 scored orders per wallet; the response states the formulas. Check the wallets with get_trader_profile or get_user_state. Past activity does not predict future results.",
+   "description": "Which wallets trade ahead of the price on a Hyperliquid market? Wallets whose large orders (at least $10k) there tended to come before price moved their way within 30 minutes, over the last 7 or 30 days. Per wallet: scored orders, notional, a lead score (notional-weighted 30-minute move in the order's direction, in basis points), hit rate, last order time and the share cancelled without a fill. At least 5 scored orders per wallet. Check the wallets with get_trader_profile or get_user_state. Past activity does not predict future results.",
    "inputSchema": {
      "properties": {
        "limit": {
--- pinned/get_fills
+++ observed/get_fills
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "What did a Hyperliquid wallet trade? Every fill for one 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.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_funding_rates
+++ observed/get_funding_rates
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Hourly funding rate history for a Hyperliquid perp, including HIP-3 builder perps. A positive rate means longs pay shorts.",
+   "description": "What has funding been on a Hyperliquid perp? Hourly funding rate history, newest first, including HIP-3 builder perps. A positive rate means longs pay shorts. For the rate right now use get_mark_prices; for averages and annualized rates, get_funding_stats.",
    "inputSchema": {
      "properties": {
        "limit": {
--- pinned/get_funding_stats
+++ observed/get_funding_stats
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Funding statistics per time bucket for a Hyperliquid perp: average, minimum, maximum and annualized rate.",
+   "description": "What is a Hyperliquid perp's average or annualized funding? Funding statistics per time bucket: average, minimum, maximum and annualized rate.",
    "inputSchema": {
      "properties": {
        "interval": {
--- pinned/get_liquidation_levels
+++ observed/get_liquidation_levels
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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 past liquidations; for where open positions would be liquidated next, use get_liquidation_map. Without a key you get the 10 busiest levels of the last 24 hours; any key, including a free one (https://ironflow.sh/key), returns every level.",
+   "description": "At which prices did liquidations happen on a Hyperliquid perp? Past liquidations bucketed by price and side: where longs and shorts were wiped out (side sell = a liquidated long). For where open positions would be liquidated next, use get_liquidation_map. Without a key you get the 10 busiest levels of the last 24 hours; any key, including a free one (https://ironflow.sh/key), returns every level.",
    "inputSchema": {
      "properties": {
        "bucket_size": {
--- pinned/get_liquidation_map
+++ observed/get_liquidation_map
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Where open positions on a Hyperliquid perp would be liquidated if the price moved: notional (size x liquidation price) by price range, longs below the current price and shorts above, with running totals from the price outward. Built from every open position in our node's latest snapshot, about every 12 minutes (snapshot.age_s says how old). Cross-margin prices assume the account's other positions stay at mark. For liquidations that already happened use get_liquidation_levels. Without a key you get the 10 largest ranges within 10% of the price; any key, including a free one (https://ironflow.sh/key), returns every range.",
+   "description": "Where are the liquidation levels on a Hyperliquid perp? Where open positions would be liquidated if the price moved: notional (size x liquidation price) by price range, longs below the current price and shorts above, with running totals from the price outward. Built from every open position in our node's latest snapshot, about every 12 minutes (snapshot.age_s says how old). Cross-margin prices assume the account's other positions stay at mark. For liquidations that already happened use get_liquidation_levels. Without a key you get the 10 largest ranges within 10% of the price; any key, including a free one (https://ironflow.sh/key), returns every range.",
    "inputSchema": {
      "properties": {
        "bucket_size": {
--- pinned/get_liquidation_summary
+++ observed/get_liquidation_summary
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Liquidations on Hyperliquid over a trailing window, totalled across every market or the ones named: count, wallets, notional, longs vs shorts liquidated, the top markets and the largest single liquidation with its price. Use it for 'who got liquidated in the last hour?' or 'how much was liquidated today?'. For the individual liquidations use get_liquidations; for liquidations grouped by price use get_liquidation_levels; for where open positions would be liquidated next use get_liquidation_map. Windows from 15m to 24h without a key, 7d with one. Totals are computed by the API over every liquidation, not sampled.",
+   "description": "How much was liquidated on Hyperliquid, and what were the biggest? Liquidations over a trailing window, totalled across every market or the ones named: count, wallets, notional, longs vs shorts liquidated, the top markets and the largest single liquidation with its price. For the individual liquidations use get_liquidations; for liquidations grouped by price use get_liquidation_levels; for where open positions would be liquidated next use get_liquidation_map. Windows from 15m to 24h without a key, 7d with one.",
    "inputSchema": {
      "properties": {
        "market": {
--- pinned/get_liquidations
+++ observed/get_liquidations
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "Who just got liquidated on a Hyperliquid perp? The latest liquidations of one market from our own nodes, newest first: price, size, side and the liquidated wallet. Hyperliquid's public API has no liquidation feed. For totals and the largest across every market use get_liquidation_summary.",
    "inputSchema": {
      "properties": {
        "limit": {
--- pinned/get_mark_prices
+++ observed/get_mark_prices
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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 (0.0000125 = 0.00125%); positive means longs pay shorts. Use it when you need the oracle price or funding next to the mark, for example for basis or premium. For only the price use get_price, for funding history get_funding_rates, and for many markets at once get_markets_snapshot.",
+   "description": "What is funding on a Hyperliquid perp right now? The latest mark price, oracle price and current hourly funding rate of one perp, with the time of the reading. The funding rate is a fraction per hour (0.0000125 = 0.00125%); positive means longs pay shorts. For only the price use get_price, for funding history get_funding_rates, and for many markets at once get_markets_snapshot.",
    "inputSchema": {
      "properties": {
        "market": {
--- pinned/get_market_leaders
+++ observed/get_market_leaders
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "The best traders on one Hyperliquid market, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.",
+   "description": "Who trades one Hyperliquid market best? The best traders there, ranked by profit factor then win rate, among wallets with at least 5 closed trades there.",
    "inputSchema": {
      "properties": {
        "limit": {
--- pinned/get_market_top_wallets
+++ observed/get_market_top_wallets
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Top wallets on one Hyperliquid market by volume or realized PnL, up to 200 rows.",
+   "description": "Who trades the most, or makes the most, on one Hyperliquid market? Top wallets there by volume or realized PnL over a window (default the last 24 hours), up to 200 rows.",
    "inputSchema": {
      "properties": {
        "from": {
--- pinned/get_markets_snapshot
+++ observed/get_markets_snapshot
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "What is moving on Hyperliquid right now? Active 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.",
    "inputSchema": {
      "properties": {
        "issuer": {
--- pinned/get_open_interest
+++ observed/get_open_interest
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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. Multiply by get_price for open interest in USD. To compare open interest across markets use get_markets_snapshot; for its history use run_query (see describe_data).",
+   "description": "What is open interest on a Hyperliquid perp? The latest open interest of one 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. Multiply by get_price for open interest in USD. To compare open interest across markets use get_markets_snapshot; for its history use run_query (see describe_data).",
    "inputSchema": {
      "properties": {
        "market": {
--- pinned/get_open_interest_changes
+++ observed/get_open_interest_changes
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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 the latest mark and in percent. Sorted by the size of the USD change by default, or by percent. Filter to one HIP-3 dex (xyz) or to native perps only. Markets with less than $100k of open interest at both ends are left out unless you lower min_oi_usd. Use it for 'where is money flowing in or out'. For one market's latest open interest use get_open_interest.",
+   "description": "Where is money flowing in or out on 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 the latest mark and in percent. For one market's latest open interest use get_open_interest.",
    "inputSchema": {
      "properties": {
        "dex": {
--- pinned/get_outcome_markets
+++ observed/get_outcome_markets
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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 week: traded volume (each trade counted once), fills, wallets and active markets, plus the most traded outcomes with their last traded price (the implied probability, 0 to 1) and last-24-hour traded volume. Each outcome has a Yes and a No side whose prices sum to 1. For one outcome's trades or candles pass its symbol to get_recent_trades or get_candles; settled outcomes stay queryable. For per-wallet outcome activity use run_query on hl.wallet_daily with market_class = 'prediction'.",
+   "description": "What is trading on Hyperliquid's prediction markets? 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 week: traded volume, fills, wallets and active markets, plus the most traded outcomes with their last traded price (the implied probability, 0 to 1) and last-24-hour traded volume. Each outcome has a Yes and a No side whose prices sum to 1. For one outcome's trades or candles pass its symbol to get_recent_trades or get_candles; settled outcomes stay queryable. For per-wallet outcome activity use run_query on hl.wallet_daily with market_class = 'prediction'.",
    "inputSchema": {
      "properties": {
        "limit": {
--- pinned/get_pnl_leaderboard
+++ observed/get_pnl_leaderboard
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "Who made or lost the most on Hyperliquid? Every wallet ranked by realized PnL, biggest losses or volume over a window. Wallets with fewer than 5 fills in the window are left out.",
    "inputSchema": {
      "properties": {
        "from": {
--- pinned/get_positions_at
+++ observed/get_positions_at
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Exact perp positions one Hyperliquid wallet held at a past moment, up to 90 days back: market, side, signed size, mark price and notional at that moment, plus today's size and how many fills it made since. Built from Hyperliquid's live positions minus the wallet's fills after that moment, so sizes are exact across native and HIP-3 perps. Needs a free API key; how far back you can go follows the key's history window. Use it for questions like 'what was this wallet holding before the crash'. For positions right now use get_user_state; for trades in between use get_fills.",
+   "description": "What did a Hyperliquid wallet hold at a past time? Exact perp positions at a past moment, up to 90 days back: market, side, signed size, mark price and notional at that moment, plus today's size and how many fills it made since. Built from Hyperliquid's live positions minus the wallet's fills after that moment, so sizes are exact across native and HIP-3 perps. Needs a free API key; how far back you can go follows the key's history window. For positions right now use get_user_state; for trades in between use get_fills.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_premium
+++ observed/get_premium
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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 (latest, mean, min, max). On HIP-3 stock, index and commodity perps such as xyz:NVDA-PERP, xyz:GOLD-PERP or xyz:SP500-PERP the oracle follows the underlying, so this shows how far the perp trades from what it tracks, weekends included. Default 1h buckets over the last 7 days. For funding payments use get_funding_rates.",
+   "description": "How far does a Hyperliquid perp trade from its oracle? Its 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 (latest, mean, min, max). On HIP-3 stock, index and commodity perps such as xyz:NVDA-PERP, xyz:GOLD-PERP or xyz:SP500-PERP the oracle follows the underlying, so this shows how far the perp trades from what it tracks, weekends included. Default 1h buckets over the last 7 days. For funding payments use get_funding_rates.",
    "inputSchema": {
      "properties": {
        "days": {
--- pinned/get_price
+++ observed/get_price
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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 X trading at'. For the oracle price and funding use get_mark_prices; for price history use get_candles; to compare many markets at once use get_markets_snapshot.",
+   "description": "What is X trading at on Hyperliquid? The latest mark price of one market as a single number: native perps, HIP-3 builder perps (e.g. xyz:NVDA-PERP) and spot. For the oracle price and funding use get_mark_prices; for price history use get_candles; to compare many markets at once use get_markets_snapshot.",
    "inputSchema": {
      "properties": {
        "market": {
--- pinned/get_recent_trades
+++ observed/get_recent_trades
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "What just traded on a Hyperliquid market? The latest tick-level trades from our own nodes: price, size, side and block time. Covers native perps, HIP-3 builder markets, HIP-4 outcomes and spot.",
    "inputSchema": {
      "properties": {
        "limit": {
--- pinned/get_status
+++ observed/get_status
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Ironflow service status right now: overall state, data freshness per venue and component health.",
+   "description": "Is Ironflow up? Service status right now: overall state, data freshness per venue and component health.",
    "inputSchema": {
      "properties": {},
      "required": [],
--- pinned/get_status_history
+++ observed/get_status_history
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Ironflow's own uptime over the last 24 hours (default) or 7 days: points over the period, each with the service status and how fresh the data was in seconds, plus the overall uptime percent. Use it to check whether a gap or odd value in other results came from an Ironflow outage. For the status right now use get_status; for API latency and error rates use get_status_metrics.",
+   "description": "Was Ironflow down? Its own uptime over the last 24 hours (default) or 7 days: points over the period, each with the service status and how fresh the data was in seconds, plus the overall uptime percent. Use it to check whether a gap or odd value in other results came from an Ironflow outage. For the status right now use get_status; for API latency and error rates use get_status_metrics.",
    "inputSchema": {
      "properties": {
        "period": {
--- pinned/get_status_metrics
+++ observed/get_status_metrics
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Ironflow performance over rolling windows: API latency and error rate, ingestion lag and synthetic probe timings.",
+   "description": "How fast is Ironflow? Performance over rolling windows: API latency and error rate, ingestion lag and synthetic probe timings.",
    "inputSchema": {
      "properties": {},
      "required": [],
--- pinned/get_top_traders
+++ observed/get_top_traders
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "Who are the top traders on Hyperliquid this week or month? 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. For one market use get_market_leaders.",
    "inputSchema": {
      "properties": {
        "limit": {
--- pinned/get_trader_profile
+++ observed/get_trader_profile
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "How good and how risky one Hyperliquid trader is over 7, 30 or 90 days, rebuilt from its fills: overall win rate, profit factor, trade count, realized PnL and max drawdown; the same numbers per market; its liquidations; and its trades from open to close with direction, timing and peak size. Use it to vet a wallet before following it. For plain totals over any time range use get_user_summary; for positions open right now use get_user_state; for style labels such as market_maker use get_wallet_behavior. A 90d window on a very active wallet can take several seconds.",
+   "description": "Is this Hyperliquid trader any good, and how risky? Its record over 7, 30 or 90 days, rebuilt from its fills: overall win rate, profit factor, trade count, realized PnL and max drawdown; the same numbers per market; its liquidations; and its trades from open to close with direction, timing and peak size. Use it to vet a wallet before following it. For plain totals over any time range use get_user_summary; for positions open right now use get_user_state; for style labels such as market_maker use get_wallet_behavior. A 90d window on a very active wallet can take several seconds.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_user_funding
+++ observed/get_user_funding
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Funding a Hyperliquid wallet paid or received, per market per bucket: Hyperliquid's own ledger, every hourly payment back to September 2025 (Hyperliquid's API returns only daily totals that far back). Positive means received, negative means paid. bucket=1d gives daily totals, 1h the hourly payments.",
+   "description": "How much funding did a Hyperliquid wallet pay or receive? Per market per bucket: Hyperliquid's own ledger, every hourly payment back to September 2025 (Hyperliquid's API returns only daily totals that far back). Positive means received, negative means paid. bucket=1d gives daily totals, 1h the hourly payments.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_user_ledger
+++ observed/get_user_ledger
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Vault deposits, withdrawals and transfers for a Hyperliquid wallet, including account deposits and withdrawals and transfers the wallet received. Positive amounts go into the account.",
+   "description": "Where did a Hyperliquid wallet's money come from or go? Vault deposits, withdrawals and transfers for the wallet, including account deposits and withdrawals and transfers the wallet received. Positive amounts go into the account.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_user_maker_taker
+++ observed/get_user_maker_taker
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "Is a Hyperliquid wallet a maker or a taker? Maker vs taker breakdown of its fills per market: volume, fees and rebates. A high maker share with negative maker fees marks a market maker.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_user_pnl_series
+++ observed/get_user_pnl_series
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Realized PnL of one Hyperliquid wallet over time: buckets with realized PnL and fees paid in each, by default daily over the last 30 days. Add the buckets up for a running PnL curve. Realized only: unrealized PnL on open positions is in get_user_state. For totals over a range use get_user_summary.",
+   "description": "How has a Hyperliquid wallet's PnL gone over time? Its realized PnL over time: buckets with realized PnL and fees paid in each, by default daily over the last 30 days. Add the buckets up for a running PnL curve. Realized only: unrealized PnL on open positions is in get_user_state. For totals over a range use get_user_summary.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_user_state
+++ observed/get_user_state
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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?'",
+   "description": "What positions does a Hyperliquid wallet have open? Its positions right now across native and HIP-3 perps: size, entry and mark price, leverage and unrealized PnL. Use it for 'is this wallet long or short?'. For PnL over time use get_user_pnl_series; for its trading record, get_trader_profile.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_user_summary
+++ observed/get_user_summary
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Totals for one Hyperliquid wallet over a time range (default the last 24 hours): fill count, volume in USD, realized PnL, fees, wins, losses, win rate and maker versus taker share, plus its current account state (open positions and margin). Use it for questions like 'how much did this wallet trade or make this week'. For a scored record with profit factor, drawdown and a per-market breakdown use get_trader_profile; for PnL over time use get_user_pnl_series.",
+   "description": "How much did a Hyperliquid wallet trade or make? Totals over a time range (default the last 24 hours): fill count, volume in USD, realized PnL, fees, wins, losses, win rate and maker versus taker share, plus its current account state (open positions and margin). For a scored record with profit factor, drawdown and a per-market breakdown use get_trader_profile; for PnL over time use get_user_pnl_series.",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_vault_leaderboard
+++ observed/get_vault_leaderboard
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "Which Hyperliquid vaults are drawing deposits? 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.",
    "inputSchema": {
      "properties": {
        "limit": {
--- pinned/get_vault_operations
+++ observed/get_vault_operations
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Deposits into and withdrawals from one Hyperliquid vault or one depositor. Pass vault, address, or both; at least one is required (HLP is 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303).",
+   "description": "Who moved money in or out of a Hyperliquid vault? Deposits into and withdrawals from one vault or one depositor. Pass vault, address, or both; at least one is required (HLP is 0xdfc24b077bc1425ad1dea75bcb6f8158e10df303).",
    "inputSchema": {
      "properties": {
        "address": {
--- pinned/get_wallet_behavior
+++ observed/get_wallet_behavior
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "How does a Hyperliquid wallet trade, and which wallets are whales or market makers? Labels from the last 30 days (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.",
    "inputSchema": {
      "properties": {
        "addresses": {
--- pinned/get_wallet_labels
+++ observed/get_wallet_labels
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "Whose wallet is this, and who are the whales on Hyperliquid? Labels for notable 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.",
    "inputSchema": {
      "properties": {
        "addresses": {
--- pinned/list_cohorts
+++ observed/list_cohorts
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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",
+   "description": "Which ready-made Hyperliquid wallet groups are there? Lists 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",
    "inputSchema": {
      "properties": {},
      "required": [],
--- pinned/list_markets
+++ observed/list_markets
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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.",
+   "description": "What is a Hyperliquid market called? Lists 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).",
    "inputSchema": {
      "properties": {
        "cursor": {
--- pinned/run_query
+++ observed/run_query
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "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_hourly, hl.funding, hl.funding_payments, hl.mark_prices, hl.oracle_prices, hl.open_interest, hl.liquidations, hl.builder_fills, hl.transfers, hl.vault_operations). For volume, taker flow or liquidation totals per market over hours to months read hl.market_hourly, not hl.fills; call describe_data for columns. 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.",
+   "description": "Anything the other tools do not answer: runs 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_hourly, hl.funding, hl.funding_payments, hl.mark_prices, hl.oracle_prices, hl.open_interest, hl.liquidations, hl.builder_fills, hl.transfers, hl.vault_operations). For volume, taker flow or liquidation totals per market over hours to months read hl.market_hourly, not hl.fills; call describe_data for columns. Aggregate in SQL: results are capped (1,000 rows keyless). Each query costs 10 credits. 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.",
    "inputSchema": {
      "properties": {
        "max_rows": {

Changed 2026-11-14 13:31 UTC

3 descriptions rewritten, 50 schema or annotation changes with the description left byte-identical.

--- pinned/create_ironbox
+++ observed/create_ironbox
  {
    "annotations": {
      "destructiveHint": false,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "paper": {
          "description": "True on a paper box: the agent's own simulated Hyperliquid account"
--- pinned/create_liquidation_alert
+++ observed/create_liquidation_alert
  {
    "annotations": {
      "destructiveHint": false,
-   "description": "Have Ironflow post Hyperliquid liquidations to the user's Discord channel, Slack channel, Telegram chat or HTTPS webhook as they happen (within seconds), filtered by market, side, size and wallet. It keeps running after the conversation: use it when the user wants to be told about liquidations, not just to see them now. Needs an API key (a free key works: 1 alert; Explorer 5; Builder 20). Give url (a Discord channel webhook from channel settings, Integrations, Webhooks, Copy Webhook URL; a Slack incoming webhook; or any public https URL) or telegram_chat (then tell the user to add the bot named in the result's setup to that chat). A plain webhook gets signed JSON, and its signing_secret appears only in this result, so pass it on. Then call test_liquidation_alert to check that it arrives.",
+   "description": "Have Ironflow post Hyperliquid liquidations to the user's Discord, Slack, Telegram or HTTPS webhook within seconds, filtered by market, side, size and wallet. It keeps running after the conversation: use it when the user wants to be told about liquidations, not just to see them now. Needs an API key (a free key works). Give url (a Discord channel webhook, a Slack incoming webhook or any public https URL) or telegram_chat (then tell the user to add the bot named in the result's setup). A plain webhook gets signed JSON; its signing_secret appears only in this result, so pass it on. Then call test_liquidation_alert.",
    "inputSchema": {
      "properties": {
        "address": {
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "sent_count": {
          "description": "Liquidations delivered so far"
--- pinned/delete_ironbox
+++ observed/delete_ironbox
  {
    "annotations": {
      "destructiveHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "paper": {
          "description": "True on a paper box: the agent's own simulated Hyperliquid account"
--- pinned/delete_liquidation_alert
+++ observed/delete_liquidation_alert
  {
    "annotations": {
      "destructiveHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        }
      },
      "type": "object"
--- pinned/describe_data
+++ observed/describe_data
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "tables": {
          "description": "Queryable tables",
--- pinned/get_auto_deleveraging
+++ observed/get_auto_deleveraging
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "recorded_from": {
          "description": "First moment recorded, Unix milliseconds"
--- pinned/get_box_activity
+++ observed/get_box_activity
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "paper": {
          "description": "true"
--- pinned/get_candles
+++ observed/get_candles
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/get_cohort_addresses
+++ observed/get_cohort_addresses
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        }
      },
      "type": "object"
--- pinned/get_early_movers
+++ observed/get_early_movers
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Wallets whose large orders (at least $10k) on one Hyperliquid market tended to come before price moved their way within 30 minutes, over the last 7 or 30 days. Per wallet: the number of scored orders, their total notional, a lead score (notional-weighted average 30-minute move in the order's direction, in basis points), a hit rate (share of orders followed by a move their way), the last order time and the share of its large orders cancelled without a fill. Needs at least 5 scored orders per wallet; the response states the formulas. Use it to find wallets worth watching on one market, then check them with get_trader_profile or get_user_state. Past activity does not predict future results.",
+   "description": "Wallets whose large orders (at least $10k) on one Hyperliquid market tended to come before price moved their way within 30 minutes, over the last 7 or 30 days. Per wallet: scored orders, notional, a lead score (notional-weighted 30-minute move in the order's direction, in basis points), hit rate, last order time and the share cancelled without a fill. At least 5 scored orders per wallet; the response states the formulas. Check the wallets with get_trader_profile or get_user_state. Past activity does not predict future results.",
    "inputSchema": {
      "properties": {
        "limit": {
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "signals": {
          "description": "Wallets",
--- pinned/get_fills
+++ observed/get_fills
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/get_funding_rates
+++ observed/get_funding_rates
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/get_funding_stats
+++ observed/get_funding_stats
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        }
      },
      "type": "object"
--- pinned/get_ironbox
+++ observed/get_ironbox
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "paper": {
          "description": "True on a paper box: the agent's own simulated Hyperliquid account"
--- pinned/get_liquidation_map
+++ observed/get_liquidation_map
  {
    "annotations": {
      "openWorldHint": true,
-   "description": "Where open positions on a Hyperliquid perp would be liquidated if the price moved: notional (size x liquidation price) by price range, longs below the current price and shorts above, with running totals from the price outward. Built from every open position in our node's latest state snapshot, about every 12 minutes (snapshot.age_s says how old). Cross-margin prices assume the account's other positions stay at mark, so a real move that drags correlated markets liquidates earlier; portfolio-margin accounts use Hyperliquid's own liquidation price. For liquidations that already happened use get_liquidation_levels. Without a key you get the 10 largest ranges within 10% of the price; any key, including a free one (https://ironflow.sh/key), returns every range.",
+   "description": "Where open positions on a Hyperliquid perp would be liquidated if the price moved: notional (size x liquidation price) by price range, longs below the current price and shorts above, with running totals from the price outward. Built from every open position in our node's latest snapshot, about every 12 minutes (snapshot.age_s says how old). Cross-margin prices assume the account's other positions stay at mark. For liquidations that already happened use get_liquidation_levels. Without a key you get the 10 largest ranges within 10% of the price; any key, including a free one (https://ironflow.sh/key), returns every range.",
    "inputSchema": {
      "properties": {
        "bucket_size": {
--- pinned/get_liquidation_summary
+++ observed/get_liquidation_summary
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "notional_usd": {
          "description": "Liquidated notional in USD"
--- pinned/get_liquidations
+++ observed/get_liquidations
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/get_mark_prices
+++ observed/get_mark_prices
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/get_market_leaders
+++ observed/get_market_leaders
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "traders": {
          "description": "Traders",
--- pinned/get_market_top_wallets
+++ observed/get_market_top_wallets
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "sort_by": {
          "description": "Ranking metric"
--- pinned/get_markets_snapshot
+++ observed/get_markets_snapshot
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "order": {
          "description": "desc or asc"
--- pinned/get_open_interest
+++ observed/get_open_interest
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/get_open_interest_changes
+++ observed/get_open_interest_changes
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "sort": {
          "description": "usd or pct"
--- pinned/get_outcome_markets
+++ observed/get_outcome_markets
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "notional_total": {
          "description": "Not traded volume: USD over every fill row, both sides of each trade plus settlements, splits and merges. Use volume_usd"
--- pinned/get_pnl_leaderboard
+++ observed/get_pnl_leaderboard
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "sort_by": {
          "description": "Ranking metric"
--- pinned/get_positions_at
+++ observed/get_positions_at
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "positions": {
          "description": "Positions, largest notional first",
--- pinned/get_premium
+++ observed/get_premium
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "summary": {
          "description": "Premium over the window, in basis points",
--- pinned/get_price
+++ observed/get_price
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "price": {
          "description": "Price in USD"
--- pinned/get_recent_trades
+++ observed/get_recent_trades
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/get_status
+++ observed/get_status
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "platform": {
          "description": "Event and market counts"
--- pinned/get_status_history
+++ observed/get_status_history
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "period": {
          "description": "24h or 7d"
--- pinned/get_status_metrics
+++ observed/get_status_metrics
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pipeline": {
          "description": "Ingestion latency and throughput"
--- pinned/get_top_traders
+++ observed/get_top_traders
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "sort": {
          "description": "Ranking used"
--- pinned/get_trader_profile
+++ observed/get_trader_profile
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "overall": {
          "description": "Headline stats",
--- pinned/get_user_funding
+++ observed/get_user_funding
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "returned": {
          "description": "Rows in data, most recent first"
--- pinned/get_user_ledger
+++ observed/get_user_ledger
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "to": {
          "description": "Window end, Unix milliseconds"
--- pinned/get_user_maker_taker
+++ observed/get_user_maker_taker
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "to": {
          "description": "Window end, Unix milliseconds"
--- pinned/get_user_pnl_series
+++ observed/get_user_pnl_series
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "to": {
          "description": "Window end, Unix milliseconds"
--- pinned/get_user_state
+++ observed/get_user_state
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        }
      },
      "type": "object"
--- pinned/get_user_summary
+++ observed/get_user_summary
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "state": {
          "description": "Open positions right now",
--- pinned/get_vault_leaderboard
+++ observed/get_vault_leaderboard
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "window_days": {
          "description": "Days covered (keyless: 1); absent when served by the Builder endpoint"
--- pinned/get_vault_operations
+++ observed/get_vault_operations
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/get_wallet_behavior
+++ observed/get_wallet_behavior
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "wallets": {
          "description": "Wallets",
--- pinned/get_wallet_labels
+++ observed/get_wallet_labels
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "source": {
          "description": "Venue, always hyperliquid"
--- pinned/list_box_strategies
+++ observed/list_box_strategies
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "paper": {
          "description": "true"
--- pinned/list_cohorts
+++ observed/list_cohorts
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        }
      },
      "type": "object"
--- pinned/list_ironboxes
+++ observed/list_ironboxes
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        }
      },
      "type": "object"
--- pinned/list_liquidation_alerts
+++ observed/list_liquidation_alerts
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        }
      },
      "type": "object"
--- pinned/list_markets
+++ observed/list_markets
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "pagination": {
          "description": "Cursor pagination",
--- pinned/run_query
+++ observed/run_query
  {
    "annotations": {
      "openWorldHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "row_count": {
          "description": "Rows returned"
--- pinned/start_box_strategy
+++ observed/start_box_strategy
  {
    "annotations": {
      "destructiveHint": false,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "paper": {
          "description": "true"
--- pinned/stop_box_strategy
+++ observed/stop_box_strategy
  {
    "annotations": {
      "destructiveHint": true,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "paper": {
          "description": "true"
--- pinned/test_liquidation_alert
+++ observed/test_liquidation_alert
  {
    "annotations": {
      "destructiveHint": false,
-         "description": "Present when the API added a note: how a market name was read, that data starts later than asked because of the history window, or a next step such as a free key"
+         "description": "A note from the API: how a market name was read, why data starts later than asked, or a next step such as a free key"
        },
        "status": {
          "description": "The alert's status afterwards"

Current tools

Show all 46 tool fingerprints
create_liquidation_alert
d62622dcfa8dbc2f
delete_liquidation_alert
adf5b99f443f3355
describe_data
8272849b01494734
get_auto_deleveraging
1480729448593f61
get_candles
f7c46f36c420a482
get_cohort_addresses
99dfc4b6aa249ede
get_early_movers
44d501b9239eac51
get_fills
67f7b5ff778b684b
get_funding_rates
1cede84452a33b44
get_funding_stats
7de70c94eba8b7ef
get_liquidation_levels
f6cf9465e5c4a9f1
get_liquidation_map
6b7d52a1d23eedce
get_liquidation_summary
cdab4ebbc2bbd261
get_liquidations
7ffe5106f19ff055
get_mark_prices
e2fd117be6f88536
get_market_leaders
3787cec18dda2e78
get_market_top_wallets
1255507154d0735d
get_markets_snapshot
778162db3bd362fa
get_open_interest
4e4288d3bbcd6f7f
get_open_interest_changes
220561e96fee45d7
get_outcome_markets
9086f8d10d0b94f1
get_pnl_leaderboard
6e2bfe05482d71d3
get_positions_at
f8b299d276bef1ae
get_premium
82798efaa1d88427
get_price
c2a900589acd3fb4
get_recent_trades
a3a60a874dcdc050
get_status
72910c36a9d0f6c1
get_status_history
62dbc1722010fb84
get_status_metrics
e9e2260f44a411c7
get_top_traders
44fc9ac4291c67ea
get_trader_profile
a6431868e1e43a4b
get_user_funding
39af8c99b1c94c47
get_user_ledger
70876db0b2e898ad
get_user_maker_taker
147ef1fd57640153
get_user_pnl_series
646a3f0af607db60
get_user_state
d9c1e5438bb2eff2
get_user_summary
c7a11ee71ee0da2e
get_vault_leaderboard
62f502cb483db95d
get_vault_operations
3fdb755acaa451d1
get_wallet_behavior
728d0bf6411bb3e4
get_wallet_labels
3ee8fcd4b383cd6e
list_cohorts
12966e0553f41c6a
list_liquidation_alerts
3c5bf5595ccdaba9
list_markets
1fb805305941dc1c
run_query
51d8ff8949640454
test_liquidation_alert
03601dbf027dbb5e

Watch this server yourself

If you run this server, put the proxy in front of it. It pins these exact fingerprints on first connect and stops the session if they move.

npx -y mcp-pin@0.2.4 -- <your @ironflowsh/mcp command>

Or subscribe to this page's RSS feed to be told when it changes.

Badge

mcp-pin status badge for @ironflowsh/mcp

The badge states one fact about time and nothing else. It never claims a server is safe.

[![mcp-pin](https://mcp-pin.gautamkhosla.com/badge/1a7b56e3c4416c54.svg)](https://mcp-pin.gautamkhosla.com/servers/1a7b56e3c4416c54.html)