{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.ironflow.sh",
    "site": "ironflow.sh",
    "addresses": [
      {
        "address": "172.67.174.93",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.160.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.21.64.18",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.64.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3036::ac43:ae5d",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3036::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3033::6815:4012",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3033::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.174.93",
          "104.21.64.18",
          "2606:4700:3036::ac43:ae5d",
          "2606:4700:3033::6815:4012"
        ],
        "first_seen": "2026-11-21T15:50:03.249Z",
        "last_seen": "2026-11-21T15:50:03.249Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "ironflow",
      "version": "0.21.1",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare",
      "strict-transport-security": "max-age=31536000; includeSubDomains; preload",
      "access-control-allow-origin": "*"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "io.github.ironflowsh",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/ironflowsh/mcp",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "30401",
    "server_name": "io.github.ironflowsh/hyperliquid",
    "url": "https://mcp.ironflow.sh/mcp",
    "host": "mcp.ironflow.sh",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-21T15:50:03.249Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "ed85c08ed736c88b654584e57f3494b7f1607023a061f19ab201cb62c0364efa",
    "first_listed_at": "2026-11-21T15:50:03.249Z",
    "created_at": "2026-11-21T10:00:09.041Z",
    "resolved_addresses": [
      "172.67.174.93",
      "104.21.64.18",
      "2606:4700:3036::ac43:ae5d",
      "2606:4700:3033::6815:4012"
    ]
  },
  "server": {
    "name": "io.github.ironflowsh/hyperliquid",
    "title": "Ironflow: Hyperliquid data",
    "description": "Hyperliquid market data, wallet analytics and liquidation alerts for AI agents.",
    "version": "0.22.0",
    "registry_status": "active",
    "repository_url": "https://github.com/ironflowsh/mcp",
    "website_url": null,
    "published_at": "2026-11-22T15:41:18.251Z",
    "updated_at": "2026-11-22T15:41:18.251Z",
    "first_seen": "2026-11-21T10:00:08.526Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "runs-code"
    ],
    "evm_addresses": [
      "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303"
    ],
    "chains": [],
    "tokens": [
      "BTC",
      "ETH",
      "USDC"
    ],
    "computed_at": "2026-11-22T15:40:16.824Z"
  },
  "operator": null,
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 1,
    "answered": 1,
    "answered_percent": 100,
    "avg_listing_latency_ms": 1201,
    "first_check_in_window": "2026-11-21T15:50:03.249Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "ed85c08ed736c88b654584e57f3494b7f1607023a061f19ab201cb62c0364efa",
    "tools": 46,
    "resources": 0,
    "prompts": 4,
    "first_seen": "2026-11-21T15:50:04.452Z",
    "tool_names": [
      "get_liquidation_summary",
      "get_liquidations",
      "get_liquidation_map",
      "get_markets_snapshot",
      "get_price",
      "get_candles",
      "get_funding_rates",
      "get_open_interest_changes",
      "get_user_state",
      "get_user_pnl_series",
      "get_user_funding",
      "get_top_traders",
      "get_market_top_wallets",
      "list_markets",
      "describe_data",
      "run_query",
      "get_wallet_behavior",
      "get_recent_trades",
      "get_open_interest",
      "get_outcome_markets",
      "get_premium",
      "get_auto_deleveraging",
      "get_fills",
      "get_mark_prices",
      "get_vault_operations",
      "get_liquidation_levels",
      "get_vault_leaderboard",
      "get_funding_stats",
      "get_positions_at",
      "get_user_maker_taker",
      "get_user_ledger",
      "get_pnl_leaderboard",
      "get_user_summary",
      "get_wallet_labels",
      "get_market_leaders",
      "get_early_movers",
      "get_trader_profile",
      "list_cohorts",
      "get_cohort_addresses",
      "get_status",
      "get_status_metrics",
      "get_status_history",
      "create_liquidation_alert",
      "list_liquidation_alerts",
      "test_liquidation_alert",
      "delete_liquidation_alert"
    ],
    "declared": {
      "tools": [
        {
          "name": "get_liquidation_summary",
          "title": "Liquidation summary",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "market": {
                "type": "string",
                "description": "Optional: one market or a comma list (BTC-PERP,ETH-PERP); Hyperliquid names work (BTC, xyz:NVDA)"
              },
              "window": {
                "enum": [
                  "15m",
                  "1h",
                  "4h",
                  "12h",
                  "24h",
                  "7d"
                ],
                "type": "string",
                "description": "Trailing window. Default 1h"
              },
              "minutes": {
                "type": "number",
                "description": "Older form of window, rounded up to the next one (90 becomes 4h)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "description": "Window end, Unix milliseconds"
              },
              "from": {
                "description": "Window start, Unix milliseconds"
              },
              "count": {
                "description": "Number of liquidations"
              },
              "market": {
                "description": "Market filter, or null for all markets"
              },
              "notice": {
                "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": {
                "description": "Trailing window, e.g. 1h"
              },
              "largest": {
                "type": "object",
                "properties": {
                  "side": {
                    "description": "\"long\" or \"short\""
                  },
                  "price": {
                    "description": "Price in USD"
                  },
                  "market": {
                    "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                  },
                  "address": {
                    "description": "Wallet address (0x…)"
                  },
                  "timestamp": {
                    "description": "Unix milliseconds"
                  },
                  "notional_usd": {
                    "description": "Notional in USD"
                  }
                },
                "description": "Largest single liquidation, or null when there were none"
              },
              "wallets": {
                "description": "Distinct wallets liquidated"
              },
              "complete": {
                "description": "Always true: totals cover every liquidation in the window"
              },
              "by_market": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "count": {
                      "description": "Liquidations"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "notional_usd": {
                      "description": "Notional in USD"
                    }
                  },
                  "description": "One market"
                },
                "description": "Top markets by liquidated notional"
              },
              "notional_usd": {
                "description": "Liquidated notional in USD"
              },
              "longs_liquidated_usd": {
                "description": "Notional of liquidated longs in USD"
              },
              "shorts_liquidated_usd": {
                "description": "Notional of liquidated shorts in USD"
              }
            },
            "description": "Liquidation totals over the window"
          },
          "annotations": {
            "title": "Liquidation summary",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_liquidations",
          "title": "Liquidations",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of liquidation events (1-100, default 20)"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "side": {
                      "description": "The liquidated wallet's fill side: \"sell\" closed a long, \"buy\" closed a short"
                    },
                    "size": {
                      "description": "Size in base units"
                    },
                    "price": {
                      "description": "Price in USD"
                    },
                    "venue": {
                      "description": "Venue, always hyperliquid"
                    },
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "address": {
                      "description": "Liquidated wallet"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "base_market": {
                      "description": "Display symbol without the HIP-3 issuer prefix"
                    },
                    "market_type": {
                      "description": "perp, spot or prediction"
                    },
                    "quote_asset": {
                      "description": "Quote asset, e.g. USDC"
                    },
                    "block_number": {
                      "description": "Hyperliquid block height"
                    },
                    "realized_pnl": {
                      "description": "Realized PnL in USD"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One row"
                },
                "description": "Liquidations"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "has_more": {
                    "description": "Whether more rows exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor to fetch the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "Liquidations"
          },
          "annotations": {
            "title": "Liquidations",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_liquidation_map",
          "title": "Liquidation map",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "side": {
                "enum": [
                  "both",
                  "long",
                  "short"
                ],
                "type": "string",
                "description": "Which side's liquidations. Default both"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              },
              "range_pct": {
                "type": "number",
                "description": "How far from the current price to cover, in percent. Default 20, max 50"
              },
              "bucket_size": {
                "type": "string",
                "description": "Price range width: auto (default, about 0.25% of price) or a number in the market's price units, as text or a number"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "side": {
                "description": "both, long or short"
              },
              "as_of": {
                "description": "When the map was priced (RFC 3339)"
              },
              "stale": {
                "description": "True when the last snapshot could not be read and an older map is served"
              },
              "levels": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "long_usd": {
                      "description": "Long notional liquidated in this range"
                    },
                    "price_hi": {
                      "description": "Range high"
                    },
                    "price_lo": {
                      "description": "Range low"
                    },
                    "short_usd": {
                      "description": "Short notional liquidated in this range"
                    },
                    "cum_long_usd": {
                      "description": "Long notional liquidated from the price down to here"
                    },
                    "cum_short_usd": {
                      "description": "Short notional liquidated from the price up to here"
                    }
                  },
                  "description": "One range"
                },
                "description": "Price ranges, low to high"
              },
              "market": {
                "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
              },
              "notice": {
                "description": "Present without a key: the result is a 10-range sample"
              },
              "mark_px": {
                "description": "Current mark price"
              },
              "coverage": {
                "type": "object",
                "properties": {
                  "notional_usd": {
                    "description": "Open notional on the market"
                  },
                  "with_liq_px_pct": {
                    "description": "Percent of it with a liquidation price"
                  },
                  "portfolio_margin_pct": {
                    "description": "Percent priced with Hyperliquid's own liquidationPx"
                  }
                },
                "description": "What the map covers"
              },
              "snapshot": {
                "type": "object",
                "properties": {
                  "time": {
                    "description": "Block time (RFC 3339)"
                  },
                  "age_s": {
                    "description": "Seconds since the snapshot"
                  },
                  "height": {
                    "description": "Block height"
                  }
                },
                "description": "The node state snapshot the positions come from"
              },
              "range_pct": {
                "description": "Percent from the price covered"
              },
              "bucket_size": {
                "description": "Price range width used"
              }
            },
            "description": "Projected liquidations by price for one market"
          },
          "annotations": {
            "title": "Liquidation map",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_markets_snapshot",
          "title": "Markets snapshot",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Rows to return (1-200, default 25)"
              },
              "order": {
                "enum": [
                  "desc",
                  "asc"
                ],
                "type": "string",
                "description": "desc (default) or asc"
              },
              "issuer": {
                "type": "string",
                "description": "HIP-3 builder code (e.g. 'xyz'). Omit to include every issuer."
              },
              "sort_by": {
                "enum": [
                  "volume",
                  "open_interest",
                  "funding",
                  "abs_funding",
                  "change_24h",
                  "abs_change_24h"
                ],
                "type": "string",
                "description": "Ranking key (default volume). funding_rate is hourly; positive means longs pay shorts."
              },
              "market_class": {
                "enum": [
                  "perp",
                  "spot",
                  "prediction",
                  "option"
                ],
                "type": "string",
                "description": "Filter to one class"
              },
              "min_volume_usd": {
                "type": "number",
                "description": "Skip markets with less 24h volume than this (USD)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "market_id": {
                      "description": "Stable market id"
                    },
                    "mark_price": {
                      "description": "Current mark price"
                    },
                    "mark_ts_ms": {
                      "description": "Mark sample time, Unix milliseconds"
                    },
                    "funding_rate": {
                      "description": "Current hourly funding rate"
                    },
                    "mark_24h_ago": {
                      "description": "Mark price 24h ago"
                    },
                    "market_class": {
                      "description": "perp, spot, prediction or option"
                    },
                    "change_24h_pct": {
                      "description": "24h change as a fraction, e.g. -0.031 for -3.1%"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "volume_24h_usd": {
                      "description": "24h volume in USD"
                    },
                    "open_interest_usd": {
                      "description": "Open interest in USD"
                    },
                    "open_interest_base": {
                      "description": "Open interest in base units"
                    }
                  },
                  "description": "One market"
                },
                "description": "Ranked markets"
              },
              "order": {
                "description": "desc or asc"
              },
              "notice": {
                "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"
              },
              "matched": {
                "description": "Markets past the volume floor"
              },
              "sort_by": {
                "description": "Ranking key used"
              },
              "returned": {
                "description": "Rows in data"
              },
              "total_markets": {
                "description": "Active markets before filtering"
              }
            },
            "description": "Markets ranked by the requested key"
          },
          "annotations": {
            "title": "Markets snapshot",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_price",
          "title": "Market price",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "price": {
                "description": "Price in USD"
              },
              "market": {
                "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
              },
              "notice": {
                "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"
              }
            },
            "description": "Latest mark price"
          },
          "annotations": {
            "title": "Market price",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_candles",
          "title": "Candles (OHLCV)",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of candles to return (1-500, default 24)"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              },
              "interval": {
                "enum": [
                  "1m",
                  "5m",
                  "15m",
                  "1h",
                  "4h",
                  "1d"
                ],
                "type": "string",
                "description": "Candle interval (1m, 5m, 15m, 1h, 4h, 1d). Default: 1h"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "low": {
                      "description": "Low price"
                    },
                    "high": {
                      "description": "High price"
                    },
                    "open": {
                      "description": "Open price"
                    },
                    "close": {
                      "description": "Close price"
                    },
                    "venue": {
                      "description": "Venue, always hyperliquid"
                    },
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "volume": {
                      "description": "Volume in base units"
                    },
                    "interval": {
                      "description": "Candle interval"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "base_market": {
                      "description": "Display symbol without the HIP-3 issuer prefix"
                    },
                    "quote_asset": {
                      "description": "Quote asset, e.g. USDC"
                    },
                    "trade_count": {
                      "description": "Trades in the candle"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One row"
                },
                "description": "OHLCV candles"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "has_more": {
                    "description": "Whether more rows exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor to fetch the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "OHLCV candles"
          },
          "annotations": {
            "title": "Candles (OHLCV)",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_funding_rates",
          "title": "Funding rate history",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of funding rate entries (1-100, default 10)"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "rate": {
                      "description": "Hourly funding rate; positive means longs pay shorts"
                    },
                    "venue": {
                      "description": "Venue, always hyperliquid"
                    },
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "sequence": {
                      "description": "Order of the event within its block"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "base_market": {
                      "description": "Display symbol without the HIP-3 issuer prefix"
                    },
                    "quote_asset": {
                      "description": "Quote asset, e.g. USDC"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One row"
                },
                "description": "Hourly funding rates"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "has_more": {
                    "description": "Whether more rows exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor to fetch the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "Hourly funding rates"
          },
          "annotations": {
            "title": "Funding rate history",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_open_interest_changes",
          "title": "Open interest movers",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "dex": {
                "type": "string",
                "description": "Optional: a HIP-3 dex such as xyz, or native for validator-run perps"
              },
              "sort": {
                "enum": [
                  "usd",
                  "pct"
                ],
                "type": "string",
                "description": "Rank by USD change (default) or percent change"
              },
              "limit": {
                "type": "number",
                "description": "Number of markets (1-200, default 25)"
              },
              "window": {
                "enum": [
                  "1h",
                  "4h",
                  "24h",
                  "7d"
                ],
                "type": "string",
                "description": "Lookback window (default 24h)"
              },
              "min_oi_usd": {
                "type": "number",
                "description": "Leave out markets below this open interest in USD (default 100000)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "dex": {
                      "description": "HIP-3 dex, e.g. \"xyz\" (absent for native perps)"
                    },
                    "mark": {
                      "description": "Latest mark price"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "oi_end": {
                      "description": "Open interest now, in coins"
                    },
                    "oi_start": {
                      "description": "Open interest at the window start, in coins"
                    },
                    "change_pct": {
                      "description": "Change in percent"
                    },
                    "change_usd": {
                      "description": "Change in USD at the latest mark"
                    },
                    "oi_end_usd": {
                      "description": "Open interest now in USD"
                    }
                  },
                  "description": "One market"
                },
                "description": "Markets"
              },
              "sort": {
                "description": "usd or pct"
              },
              "count": {
                "description": "Markets returned"
              },
              "notice": {
                "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": {
                "description": "Lookback window: 1h, 4h, 24h or 7d"
              }
            },
            "description": "Perps ranked by open interest change"
          },
          "annotations": {
            "title": "Open interest movers",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_user_state",
          "title": "Wallet positions",
          "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": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "address": {
                "type": "string",
                "description": "0x-prefixed 20-byte hex address"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "notice": {
                "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"
              },
              "address": {
                "description": "Wallet address (0x…)"
              },
              "as_of_ts": {
                "description": "Snapshot time, Unix milliseconds"
              },
              "margin_summary": {
                "type": "object",
                "properties": {
                  "open_markets_count": {
                    "description": "Markets with an open position"
                  },
                  "total_realized_pnl": {
                    "description": "Sum of realized PnL in USD"
                  },
                  "total_position_value": {
                    "description": "Sum of position values in USD"
                  },
                  "total_unrealized_pnl": {
                    "description": "Sum of unrealized PnL in USD"
                  }
                },
                "description": "Account totals"
              },
              "asset_positions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "size": {
                      "description": "Signed size: positive long, negative short"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "leverage": {
                      "description": "Leverage"
                    },
                    "mark_price": {
                      "description": "Current mark price"
                    },
                    "entry_price": {
                      "description": "Average entry price"
                    },
                    "market_class": {
                      "description": "perp, spot, prediction or option"
                    },
                    "realized_pnl": {
                      "description": "Realized PnL in USD"
                    },
                    "leverage_type": {
                      "description": "cross or isolated"
                    },
                    "position_value": {
                      "description": "Position value in USD"
                    },
                    "unrealized_pnl": {
                      "description": "Unrealized PnL in USD"
                    },
                    "return_on_equity": {
                      "description": "Unrealized PnL divided by margin"
                    }
                  },
                  "description": "Open position"
                },
                "description": "Open positions"
              }
            },
            "description": "Open positions right now"
          },
          "annotations": {
            "title": "Wallet positions",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_user_pnl_series",
          "title": "Wallet PnL curve",
          "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": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "to": {
                "type": "string",
                "description": "Window end: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now). Default now"
              },
              "from": {
                "type": "string",
                "description": "Window start: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now). Default 30 days ago"
              },
              "address": {
                "type": "string",
                "description": "0x-prefixed 20-byte hex address"
              },
              "bucket_ms": {
                "type": "number",
                "description": "Bucket size in milliseconds: 3600000 for hourly, 86400000 for daily (default)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "description": "Window end, Unix milliseconds"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "ts": {
                      "description": "Bucket start, Unix milliseconds"
                    },
                    "fees_usd": {
                      "description": "Fees in USD"
                    },
                    "realized_pnl": {
                      "description": "Realized PnL in USD"
                    }
                  },
                  "description": "One bucket"
                },
                "description": "Buckets"
              },
              "from": {
                "description": "Window start, Unix milliseconds"
              },
              "bucket": {
                "description": "Bucket size"
              },
              "notice": {
                "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"
              },
              "address": {
                "description": "Wallet address (0x…)"
              }
            },
            "description": "Realized PnL per bucket"
          },
          "annotations": {
            "title": "Wallet PnL curve",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_user_funding",
          "title": "Wallet funding 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": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "to": {
                "type": "string",
                "description": "Window end: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now)"
              },
              "from": {
                "type": "string",
                "description": "Window start: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now)"
              },
              "limit": {
                "type": "number",
                "description": "Most recent rows to return (default 200)"
              },
              "bucket": {
                "enum": [
                  "1h",
                  "1d",
                  "raw"
                ],
                "type": "string",
                "description": "Aggregation bucket; default 1d"
              },
              "market": {
                "type": "string",
                "description": "Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA)"
              },
              "address": {
                "type": "string",
                "description": "0x-prefixed 20-byte hex address"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "description": "Window end, Unix milliseconds"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "avg_position": {
                      "description": "Average position size"
                    },
                    "bucket_start": {
                      "description": "Bucket start, Unix milliseconds"
                    },
                    "market_class": {
                      "description": "perp, spot, prediction or option"
                    },
                    "interval_count": {
                      "description": "Hourly payments in the bucket"
                    },
                    "funding_payment": {
                      "description": "USD; positive received, negative paid"
                    },
                    "avg_funding_rate": {
                      "description": "Average hourly rate"
                    }
                  },
                  "description": "One bucket and market"
                },
                "description": "Buckets"
              },
              "from": {
                "description": "Window start, Unix milliseconds"
              },
              "bucket": {
                "description": "Bucket size"
              },
              "notice": {
                "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"
              },
              "address": {
                "description": "Wallet address (0x…)"
              },
              "returned": {
                "description": "Rows in data, most recent first"
              },
              "total_rows": {
                "description": "Rows in the window before the limit"
              }
            },
            "description": "Funding paid or received per market per bucket"
          },
          "annotations": {
            "title": "Wallet funding payments",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_top_traders",
          "title": "Top traders",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "sort": {
                "enum": [
                  "top",
                  "lowrisk",
                  "new"
                ],
                "type": "string",
                "description": "Ranking. Default top"
              },
              "limit": {
                "type": "number",
                "description": "Number of traders (1-50, default 20)"
              },
              "window": {
                "enum": [
                  "7d",
                  "30d",
                  "90d"
                ],
                "type": "string",
                "description": "Lookback window. Default 30d"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "sort": {
                "description": "Ranking used"
              },
              "notice": {
                "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": {
                "description": "Lookback window, e.g. \"30d\""
              },
              "traders": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "trades": {
                      "description": "Closed trades in the window"
                    },
                    "address": {
                      "description": "Wallet address (0x…)"
                    },
                    "win_rate": {
                      "description": "Share of closed trades that were profitable, 0 to 1"
                    },
                    "top_pairs": {
                      "description": "Best markets with their win rates"
                    },
                    "taker_share": {
                      "description": "Share of volume as taker, 0 to 1"
                    },
                    "liquidations": {
                      "description": "Liquidations in the window"
                    },
                    "last_trade_ms": {
                      "description": "Last trade, Unix milliseconds"
                    },
                    "profit_factor": {
                      "description": "Gross profit divided by gross loss"
                    },
                    "first_trade_ms": {
                      "description": "First trade, Unix milliseconds"
                    },
                    "avg_notional_usd": {
                      "description": "Average trade size in USD"
                    },
                    "max_drawdown_pct": {
                      "description": "Largest peak-to-trough drop of the PnL curve, 0 to 1"
                    },
                    "realized_pnl_usd": {
                      "description": "Realized PnL in USD"
                    }
                  },
                  "description": "One trader"
                },
                "description": "Traders"
              },
              "aggregate": {
                "type": "object",
                "properties": {
                  "active_today": {
                    "description": "Traders active today"
                  },
                  "trader_count": {
                    "description": "Traders ranked"
                  },
                  "total_pnl_usd": {
                    "description": "Sum of realized PnL in USD"
                  }
                },
                "description": "Totals"
              }
            },
            "description": "Traders ranked across all markets"
          },
          "annotations": {
            "title": "Top traders",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_market_top_wallets",
          "title": "Top wallets in a market",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "to": {
                "type": "string",
                "description": "Window end: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now). Default now"
              },
              "from": {
                "type": "string",
                "description": "Window start: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now). Default 24 hours ago"
              },
              "limit": {
                "type": "number",
                "description": "Number of rows, max 200, default 25"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              },
              "sort_by": {
                "enum": [
                  "volume",
                  "realized_pnl"
                ],
                "type": "string",
                "description": "Ranking metric"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "description": "Window end, Unix milliseconds"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "wins": {
                      "description": "Profitable closing fills"
                    },
                    "fills": {
                      "description": "Fills in the window"
                    },
                    "losses": {
                      "description": "Losing closing fills"
                    },
                    "address": {
                      "description": "Wallet address (0x…)"
                    },
                    "pct_maker": {
                      "description": "Share of fills as maker, 0 to 1"
                    },
                    "volume_usd": {
                      "description": "Traded notional in USD"
                    },
                    "maker_fills": {
                      "description": "Fills as maker"
                    },
                    "taker_fills": {
                      "description": "Fills as taker"
                    },
                    "last_seen_ms": {
                      "description": "Last fill in the window, Unix milliseconds"
                    },
                    "realized_pnl": {
                      "description": "Realized PnL in USD"
                    },
                    "first_seen_ms": {
                      "description": "First fill in the window, Unix milliseconds"
                    }
                  },
                  "description": "One wallet"
                },
                "description": "Wallets"
              },
              "from": {
                "description": "Window start, Unix milliseconds"
              },
              "market": {
                "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
              },
              "notice": {
                "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"
              }
            },
            "description": "Top wallets on one market"
          },
          "annotations": {
            "title": "Top wallets in a market",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "list_markets",
          "title": "List markets",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "q": {
                "type": "string",
                "description": "Case-insensitive search over symbol, base asset, Hyperliquid coin and issuer"
              },
              "limit": {
                "type": "number",
                "description": "Rows per page (default 100, max 100)"
              },
              "cursor": {
                "type": "string",
                "description": "pagination.next_cursor from the previous page, with the same filters"
              },
              "issuer": {
                "type": "string",
                "description": "HIP-3 issuer code (e.g. 'xyz'). '' returns native markets only. Omit for every issuer."
              },
              "source": {
                "type": "string",
                "description": "Venue. Default 'hyperliquid'."
              },
              "market_class": {
                "enum": [
                  "perp",
                  "spot",
                  "prediction",
                  "option"
                ],
                "type": "string",
                "description": "Only this class. 'prediction' is HIP-4 outcomes. Omit for all."
              },
              "include_inactive": {
                "type": "boolean",
                "description": "Also return closed markets (delisted, settled HIP-4 outcomes), which carry active_to_ms. Default false."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "hl_coin": {
                      "description": "Hyperliquid coin string"
                    },
                    "market_id": {
                      "description": "Stable market id"
                    },
                    "base_asset": {
                      "description": "Base asset"
                    },
                    "base_market": {
                      "description": "Display symbol without the HIP-3 issuer prefix"
                    },
                    "quote_asset": {
                      "description": "Quote asset, e.g. USDC"
                    },
                    "active_to_ms": {
                      "description": "Close time, Unix milliseconds; only on closed markets (include_inactive)"
                    },
                    "market_class": {
                      "description": "perp, spot, prediction or option"
                    },
                    "max_leverage": {
                      "description": "Maximum leverage"
                    },
                    "active_from_ms": {
                      "description": "Listing time, Unix milliseconds"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One market"
                },
                "description": "Markets"
              },
              "notice": {
                "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"
              },
              "matched": {
                "description": "Markets matching the filters and search, across all pages"
              },
              "returned": {
                "description": "Rows in data"
              },
              "pagination": {
                "type": "object",
                "properties": {
                  "total": {
                    "description": "Markets matching the filters and search"
                  },
                  "has_more": {
                    "description": "Whether more pages exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor, with the same filters, for the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "One page of markets"
          },
          "annotations": {
            "title": "List markets",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "describe_data",
          "title": "Describe SQL tables",
          "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": {
            "type": "object",
            "required": [],
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "tips": {
                "type": "array",
                "items": {
                  "description": "One tip"
                },
                "description": "Query tips"
              },
              "tiers": {
                "type": "array",
                "items": {
                  "description": "One tier"
                },
                "description": "Every tier's limits"
              },
              "limits": {
                "description": "Your tier's limits: history_days, max_execution_seconds, max_rows, budget_seconds_per_hour"
              },
              "notice": {
                "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": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "description": "Table name, e.g. hl.fills"
                    },
                    "columns": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": {
                            "description": "Name"
                          },
                          "type": {
                            "description": "ClickHouse type"
                          },
                          "description": {
                            "description": "Meaning"
                          }
                        },
                        "description": "One column"
                      },
                      "description": "Columns"
                    },
                    "data_from": {
                      "description": "How far back the table goes"
                    },
                    "description": {
                      "description": "What one row is"
                    },
                    "time_column": {
                      "description": "Column the history window filters on"
                    }
                  },
                  "description": "One table"
                },
                "description": "Queryable tables"
              },
              "dialect": {
                "description": "SQL dialect and database name"
              },
              "examples": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "sql": {
                      "description": "SQL that answers it"
                    },
                    "question": {
                      "description": "Question"
                    }
                  },
                  "description": "One example"
                },
                "description": "Worked examples"
              }
            },
            "description": "Catalog of the SQL tables run_query can read"
          },
          "annotations": {
            "title": "Describe SQL tables",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "run_query",
          "title": "Run SQL query",
          "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": {
            "type": "object",
            "required": [
              "sql"
            ],
            "properties": {
              "sql": {
                "type": "string",
                "description": "One ClickHouse SELECT (or WITH ... SELECT) over hl.* tables, without a FORMAT clause"
              },
              "max_rows": {
                "type": "number",
                "description": "Most rows to return (default 200, capped by your tier)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "rows": {
                "type": "array",
                "items": {
                  "description": "One row"
                },
                "description": "Rows as positional arrays"
              },
              "stats": {
                "description": "elapsed_ms, rows_read, bytes_read"
              },
              "limits": {
                "description": "Your tier's limits"
              },
              "notice": {
                "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"
              },
              "columns": {
                "type": "array",
                "items": {
                  "description": "Name"
                },
                "description": "Column names in row order"
              },
              "row_count": {
                "description": "Rows returned"
              },
              "truncated": {
                "description": "true when more rows existed than were returned"
              },
              "column_types": {
                "type": "array",
                "items": {
                  "description": "Type"
                },
                "description": "ClickHouse types in row order"
              },
              "budget_remaining_seconds": {
                "description": "Query seconds left this hour"
              }
            },
            "description": "Query result"
          },
          "annotations": {
            "title": "Run SQL query",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_wallet_behavior",
          "title": "Wallet behavior labels",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "label": {
                "enum": [
                  "market_maker",
                  "high_frequency",
                  "whale",
                  "directional",
                  "consistent_winner",
                  "big_loser",
                  "revenge_sizing",
                  "often_liquidated",
                  "hip3_trader",
                  "spot_trader",
                  "prediction_trader"
                ],
                "type": "string",
                "description": "Only wallets carrying this label"
              },
              "limit": {
                "type": "number",
                "description": "Wallets to return (default 20, max 100)"
              },
              "sort_by": {
                "enum": [
                  "volume",
                  "pnl",
                  "fills",
                  "liquidations"
                ],
                "type": "string",
                "description": "Sort order when listing (default volume)"
              },
              "addresses": {
                "type": "string",
                "description": "Comma-separated wallet addresses (up to 50). Omit to list wallets instead."
              },
              "min_volume_usd": {
                "type": "number",
                "description": "Only wallets with at least this 30-day volume"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "notice": {
                "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": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "labels": {
                      "type": "array",
                      "items": {
                        "description": "Label"
                      },
                      "description": "Behaviour labels"
                    },
                    "address": {
                      "description": "Wallet address"
                    },
                    "volume_usd": {
                      "description": "30-day volume in USD"
                    },
                    "maker_share": {
                      "description": "Maker volume / volume"
                    },
                    "liquidations": {
                      "description": "Liquidation events"
                    },
                    "fills_per_day": {
                      "description": "Fills per active day"
                    },
                    "realized_pnl_usd": {
                      "description": "30-day realized PnL in USD"
                    }
                  },
                  "description": "One wallet"
                },
                "description": "Wallets"
              },
              "window_days": {
                "description": "Days the features cover"
              }
            },
            "description": "Wallet trading behaviour over the last 30 days"
          },
          "annotations": {
            "title": "Wallet behavior labels",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_recent_trades",
          "title": "Recent trades",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of trades to return (1-100, default 20)"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "fee": {
                      "description": "Fee paid in USD"
                    },
                    "side": {
                      "description": "Fill side, \"buy\" or \"sell\""
                    },
                    "size": {
                      "description": "Size in base units"
                    },
                    "price": {
                      "description": "Price in USD"
                    },
                    "venue": {
                      "description": "Venue, always hyperliquid"
                    },
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "address": {
                      "description": "Wallet address (0x…)"
                    },
                    "sequence": {
                      "description": "Order of the event within its block"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "base_market": {
                      "description": "Display symbol without the HIP-3 issuer prefix"
                    },
                    "market_type": {
                      "description": "perp, spot or prediction"
                    },
                    "quote_asset": {
                      "description": "Quote asset, e.g. USDC"
                    },
                    "block_number": {
                      "description": "Hyperliquid block height"
                    },
                    "realized_pnl": {
                      "description": "Realized PnL in USD"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One row"
                },
                "description": "Trades, newest first"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "has_more": {
                    "description": "Whether more rows exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor to fetch the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "Trades, newest first"
          },
          "annotations": {
            "title": "Recent trades",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_open_interest",
          "title": "Open interest",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "venue": {
                      "description": "Venue, always hyperliquid"
                    },
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "volume_24h": {
                      "description": "24h volume in USD"
                    },
                    "base_market": {
                      "description": "Display symbol without the HIP-3 issuer prefix"
                    },
                    "quote_asset": {
                      "description": "Quote asset, e.g. USDC"
                    },
                    "open_interest": {
                      "description": "Open interest in base units"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One row"
                },
                "description": "Open interest samples"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "has_more": {
                    "description": "Whether more rows exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor to fetch the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "Open interest samples"
          },
          "annotations": {
            "title": "Open interest",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_outcome_markets",
          "title": "HIP-4 outcome markets overview",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of outcomes to return, most traded first (1-200, default 20)"
              },
              "window": {
                "enum": [
                  "4h",
                  "1d",
                  "1w"
                ],
                "type": "string",
                "description": "Lookback window for the totals (default 1d)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "notice": {
                "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"
              },
              "volume_usd": {
                "description": "Traded volume in USD over the window, each trade counted once"
              },
              "computed_at": {
                "description": "When the summary was computed, Unix seconds"
              },
              "fills_total": {
                "description": "Fill rows over the window, both sides of each trade plus settlements, splits and merges"
              },
              "top_markets": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "hl_coin": {
                      "description": "Hyperliquid coin, e.g. \"#14730\""
                    },
                    "fills_24h": {
                      "description": "Fill rows in the last 24 hours"
                    },
                    "market_id": {
                      "description": "Ironflow market id"
                    },
                    "last_price": {
                      "description": "Last traded price, the implied probability (0 to 1); null when this side had no trade in 24 hours"
                    },
                    "volume_24h": {
                      "description": "Traded volume in USD on this side in the last 24 hours, each trade once. The two sides of an outcome share one book: add both for the outcome's volume"
                    },
                    "last_fill_ms": {
                      "description": "Last fill of any kind, Unix milliseconds"
                    },
                    "notional_24h": {
                      "description": "Not traded volume: USD over every fill row of this side in 24 hours. Use volume_24h"
                    },
                    "last_trade_ms": {
                      "description": "Last trade, Unix milliseconds"
                    },
                    "display_symbol": {
                      "description": "Outcome symbol, e.g. \"BTC-77719-20261105-Yes\""
                    },
                    "last_trade_price": {
                      "description": "Same as last_price, 0 when this side had no trade in 24 hours"
                    }
                  },
                  "description": "One outcome side"
                },
                "description": "Most traded outcome sides, highest 24h traded volume first"
              },
              "window_hours": {
                "description": "Window of the totals, in hours"
              },
              "wallets_total": {
                "description": "Wallets with any fill over the window, including wallets that only settled, split or merged"
              },
              "markets_active": {
                "description": "Outcome sides with a fill in the window"
              },
              "notional_total": {
                "description": "Not traded volume: USD over every fill row, both sides of each trade plus settlements, splits and merges. Use volume_usd"
              }
            },
            "description": "HIP-4 outcome markets overview"
          },
          "annotations": {
            "title": "HIP-4 outcome markets overview",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_premium",
          "title": "Mark against oracle premium",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "days": {
                "type": "number",
                "description": "How many days back (default 7; limited by your key's history window)"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              },
              "interval": {
                "enum": [
                  "1m",
                  "5m",
                  "15m",
                  "1h",
                  "4h",
                  "1d"
                ],
                "type": "string",
                "description": "Bucket size (default 1h)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "t": {
                      "description": "Bucket start, Unix milliseconds"
                    },
                    "mark": {
                      "description": "Average mark price"
                    },
                    "oracle": {
                      "description": "Average oracle price"
                    },
                    "premium_bps": {
                      "description": "(mark / oracle - 1) x 10,000"
                    }
                  },
                  "description": "One bucket"
                },
                "description": "Buckets, oldest first"
              },
              "market": {
                "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "buckets": {
                    "description": "Number of buckets"
                  },
                  "max_bps": {
                    "description": "Highest bucket"
                  },
                  "min_bps": {
                    "description": "Lowest bucket"
                  },
                  "mean_bps": {
                    "description": "Mean over the buckets"
                  },
                  "latest_bps": {
                    "description": "Latest bucket"
                  }
                },
                "description": "Premium over the window, in basis points"
              },
              "interval": {
                "description": "Bucket size"
              }
            },
            "description": "Mark against oracle premium"
          },
          "annotations": {
            "title": "Mark against oracle premium",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_auto_deleveraging",
          "title": "Auto-deleveraging fills",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "days": {
                "type": "number",
                "description": "How many days back (default 7)"
              },
              "limit": {
                "type": "number",
                "description": "Number of fills (1-1000, default 100)"
              },
              "market": {
                "type": "string",
                "description": "Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "tid": {
                      "description": "Trade id, shared with the liquidated side"
                    },
                    "hash": {
                      "description": "Transaction hash (0x…)"
                    },
                    "side": {
                      "description": "Fill side, \"buy\" or \"sell\""
                    },
                    "size": {
                      "description": "Size in base units"
                    },
                    "block": {
                      "description": "Hyperliquid block height"
                    },
                    "price": {
                      "description": "Price in USD"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "address": {
                      "description": "Wallet whose position was closed"
                    },
                    "notional": {
                      "description": "Notional in USD"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "realized_pnl": {
                      "description": "Realized PnL in USD"
                    }
                  },
                  "description": "One fill"
                },
                "description": "ADL fills"
              },
              "count": {
                "description": "Fills returned"
              },
              "notice": {
                "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"
              }
            },
            "description": "Auto-deleveraging fills, newest first"
          },
          "annotations": {
            "title": "Auto-deleveraging fills",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_fills",
          "title": "Wallet 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": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of fills (1-100, default 20)"
              },
              "market": {
                "type": "string",
                "description": "Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA)"
              },
              "address": {
                "type": "string",
                "description": "Wallet address (e.g. 0x...)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "fee": {
                      "description": "Fee paid in USD"
                    },
                    "side": {
                      "description": "Fill side, \"buy\" or \"sell\""
                    },
                    "size": {
                      "description": "Size in base units"
                    },
                    "price": {
                      "description": "Price in USD"
                    },
                    "venue": {
                      "description": "Venue, always hyperliquid"
                    },
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "address": {
                      "description": "Wallet address (0x…)"
                    },
                    "direction": {
                      "description": "e.g. \"Open Long\", \"Close Short\""
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "base_market": {
                      "description": "Display symbol without the HIP-3 issuer prefix"
                    },
                    "market_type": {
                      "description": "perp, spot or prediction"
                    },
                    "quote_asset": {
                      "description": "Quote asset, e.g. USDC"
                    },
                    "block_number": {
                      "description": "Hyperliquid block height"
                    },
                    "realized_pnl": {
                      "description": "Realized PnL in USD"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One row"
                },
                "description": "Fills for one wallet, newest first"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "has_more": {
                    "description": "Whether more rows exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor to fetch the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "Fills for one wallet, newest first"
          },
          "annotations": {
            "title": "Wallet fills",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_mark_prices",
          "title": "Mark and oracle price",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "venue": {
                      "description": "Venue, always hyperliquid"
                    },
                    "issuer": {
                      "description": "HIP-3 builder code (\"\" for native markets)"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "mark_price": {
                      "description": "Mark price"
                    },
                    "base_market": {
                      "description": "Display symbol without the HIP-3 issuer prefix"
                    },
                    "quote_asset": {
                      "description": "Quote asset, e.g. USDC"
                    },
                    "funding_rate": {
                      "description": "Current hourly funding rate"
                    },
                    "oracle_price": {
                      "description": "Oracle price"
                    },
                    "display_symbol": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One row"
                },
                "description": "Mark price samples"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "has_more": {
                    "description": "Whether more rows exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor to fetch the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "Mark price samples"
          },
          "annotations": {
            "title": "Mark and oracle price",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_vault_operations",
          "title": "Vault deposits and withdrawals",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of events (1-100, default 20)"
              },
              "vault": {
                "type": "string",
                "description": "Vault address (vault or address is required)"
              },
              "address": {
                "type": "string",
                "description": "Depositor address (vault or address is required)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "token": {
                      "description": "Token, usually USDC"
                    },
                    "vault": {
                      "description": "Vault address"
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "address": {
                      "description": "Depositor"
                    },
                    "operation": {
                      "description": "deposit or withdraw"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    },
                    "commission": {
                      "description": "Leader commission"
                    },
                    "net_amount": {
                      "description": "Amount after commission and closing cost"
                    },
                    "block_number": {
                      "description": "Hyperliquid block height"
                    },
                    "closing_cost": {
                      "description": "Cost of closing positions for the withdrawal"
                    },
                    "requested_amount": {
                      "description": "Requested amount"
                    }
                  },
                  "description": "One row"
                },
                "description": "Vault deposits and withdrawals"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "has_more": {
                    "description": "Whether more rows exist"
                  },
                  "next_cursor": {
                    "description": "Pass as cursor to fetch the next page; null on the last page"
                  }
                },
                "description": "Cursor pagination"
              }
            },
            "description": "Vault deposits and withdrawals"
          },
          "annotations": {
            "title": "Vault deposits and withdrawals",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_liquidation_levels",
          "title": "Liquidation levels",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              },
              "bucket_size": {
                "type": "string",
                "description": "Price bucket width: auto (default, about 0.25% of price, right for any coin) or a fixed 1, 5, 10, 50, 100, 500, 1000 or 5000 (a number works too)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One bucket"
                },
                "description": "Price buckets"
              },
              "notice": {
                "description": "Present without a key: the result is a 10-level sample"
              },
              "bucket_size": {
                "description": "Bucket width used (the one picked for auto)"
              }
            },
            "description": "Liquidated notional by price bucket"
          },
          "annotations": {
            "title": "Liquidation levels",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_vault_leaderboard",
          "title": "Vault leaderboard",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of vaults (default 10, max 1000)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "vault": {
                      "description": "Vault address"
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "net_flow": {
                      "description": "Deposits minus withdrawals, USDC"
                    },
                    "unique_users": {
                      "description": "Distinct depositors and withdrawers"
                    },
                    "total_deposits": {
                      "description": "USDC deposited in the window"
                    },
                    "total_withdrawals": {
                      "description": "USDC withdrawn in the window"
                    }
                  },
                  "description": "One vault"
                },
                "description": "Vaults"
              },
              "notice": {
                "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"
              }
            },
            "description": "Vaults ranked by net deposits"
          },
          "annotations": {
            "title": "Vault leaderboard",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_funding_stats",
          "title": "Funding statistics",
          "description": "What is a Hyperliquid perp's average or annualized funding? Funding statistics per time bucket: average, minimum, maximum and annualized rate.",
          "inputSchema": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of data points (default 7)"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              },
              "interval": {
                "enum": [
                  "1h",
                  "4h",
                  "8h",
                  "1d",
                  "7d"
                ],
                "type": "string",
                "description": "Time interval (1h, 4h, 8h, 1d, 7d). Default: 1d"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "bucket": {
                      "description": "Bucket start, Unix milliseconds"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "source": {
                      "description": "Venue, always hyperliquid"
                    },
                    "avg_rate": {
                      "description": "Average hourly rate"
                    },
                    "max_rate": {
                      "description": "Highest hourly rate"
                    },
                    "min_rate": {
                      "description": "Lowest hourly rate"
                    },
                    "cumulative_rate": {
                      "description": "Sum of hourly rates in the bucket"
                    }
                  },
                  "description": "One bucket"
                },
                "description": "Buckets"
              },
              "notice": {
                "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"
              }
            },
            "description": "Funding statistics per time bucket"
          },
          "annotations": {
            "title": "Funding statistics",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_positions_at",
          "title": "Wallet positions at a past time",
          "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": {
            "type": "object",
            "required": [
              "address",
              "at"
            ],
            "properties": {
              "at": {
                "type": "string",
                "description": "The past moment: ISO 8601 (2026-11-01T12:00:00Z), unix seconds or unix milliseconds"
              },
              "address": {
                "type": "string",
                "description": "0x-prefixed 20-byte hex address"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "at": {
                "description": "The moment, Unix milliseconds"
              },
              "count": {
                "description": "Positions returned"
              },
              "method": {
                "description": "How the sizes were rebuilt"
              },
              "notice": {
                "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"
              },
              "address": {
                "description": "Wallet address (0x…)"
              },
              "positions": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "side": {
                      "description": "long or short"
                    },
                    "size": {
                      "description": "Signed size in coins: positive long, negative short"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "notional": {
                      "description": "Size times mark price, in USD"
                    },
                    "size_now": {
                      "description": "Signed size today"
                    },
                    "mark_price": {
                      "description": "Last mark price at or before the moment"
                    },
                    "fills_since": {
                      "description": "Fills in this market after the moment"
                    }
                  },
                  "description": "One position"
                },
                "description": "Positions, largest notional first"
              }
            },
            "description": "Perp positions at a past moment"
          },
          "annotations": {
            "title": "Wallet positions at a past time",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_user_maker_taker",
          "title": "Wallet maker/taker split",
          "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": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "to": {
                "type": "string",
                "description": "Window end: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now)"
              },
              "from": {
                "type": "string",
                "description": "Window start: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now)"
              },
              "market": {
                "type": "string",
                "description": "Optional market filter: BTC-PERP or a Hyperliquid name (BTC, xyz:NVDA)"
              },
              "address": {
                "type": "string",
                "description": "0x-prefixed 20-byte hex address"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "description": "Window end, Unix milliseconds"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    }
                  },
                  "description": "One market"
                },
                "description": "Per market"
              },
              "from": {
                "description": "Window start, Unix milliseconds"
              },
              "total": {
                "type": "object",
                "properties": {
                  "maker_fee": {
                    "description": "Maker fees in USD; negative means rebates"
                  },
                  "pct_maker": {
                    "description": "Share of fills as maker, 0 to 1"
                  },
                  "taker_fee": {
                    "description": "Taker fees in USD"
                  },
                  "maker_fills": {
                    "description": "Fills as maker"
                  },
                  "taker_fills": {
                    "description": "Fills as taker"
                  },
                  "total_fills": {
                    "description": "All fills"
                  },
                  "maker_notional": {
                    "description": "Maker notional in USD"
                  },
                  "taker_notional": {
                    "description": "Taker notional in USD"
                  }
                },
                "description": "All markets"
              },
              "notice": {
                "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"
              },
              "address": {
                "description": "Wallet address (0x…)"
              }
            },
            "description": "Maker vs taker breakdown"
          },
          "annotations": {
            "title": "Wallet maker/taker split",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_user_ledger",
          "title": "Wallet ledger",
          "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": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "to": {
                "type": "string",
                "description": "Window end: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now)"
              },
              "from": {
                "type": "string",
                "description": "Window start: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now)"
              },
              "limit": {
                "type": "number",
                "description": "Max entries, default 1000, cap 10000"
              },
              "address": {
                "type": "string",
                "description": "0x-prefixed 20-byte hex address"
              },
              "event_types": {
                "type": "string",
                "description": "Comma-separated type filter (deposit,withdrawal,vault_deposit,vault_withdraw,vault_transfer_in,vault_transfer_out)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "description": "Window end, Unix milliseconds"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "type": {
                      "description": "Event type"
                    },
                    "amount": {
                      "description": "USD; positive into the account"
                    },
                    "timestamp": {
                      "description": "Unix milliseconds"
                    }
                  },
                  "description": "One entry"
                },
                "description": "Ledger entries"
              },
              "from": {
                "description": "Window start, Unix milliseconds"
              },
              "notice": {
                "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"
              },
              "address": {
                "description": "Wallet address (0x…)"
              }
            },
            "description": "Vault and transfer ledger"
          },
          "annotations": {
            "title": "Wallet ledger",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_pnl_leaderboard",
          "title": "PnL leaderboard",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "to": {
                "type": "string",
                "description": "Window end: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now). Default now"
              },
              "from": {
                "type": "string",
                "description": "Window start: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now). Default 30 days ago"
              },
              "limit": {
                "type": "number",
                "description": "Number of rows, max 200, default 50"
              },
              "sort_by": {
                "enum": [
                  "realized_pnl",
                  "loss",
                  "volume"
                ],
                "type": "string",
                "description": "Ranking metric"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "description": "Window end, Unix milliseconds"
              },
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "wins": {
                      "description": "Profitable closing fills"
                    },
                    "fills": {
                      "description": "Fills in the window"
                    },
                    "losses": {
                      "description": "Losing closing fills"
                    },
                    "address": {
                      "description": "Wallet address (0x…)"
                    },
                    "win_rate": {
                      "description": "Share of closed trades that were profitable, 0 to 1"
                    },
                    "pct_maker": {
                      "description": "Share of fills as maker, 0 to 1"
                    },
                    "volume_usd": {
                      "description": "Traded notional in USD"
                    },
                    "maker_fills": {
                      "description": "Fills as maker"
                    },
                    "taker_fills": {
                      "description": "Fills as taker"
                    },
                    "realized_pnl": {
                      "description": "Realized PnL in USD"
                    },
                    "markets_count": {
                      "description": "Markets traded"
                    },
                    "max_drawdown_pct": {
                      "description": "Largest peak-to-trough drop of the PnL curve, 0 to 1"
                    }
                  },
                  "description": "One wallet"
                },
                "description": "Wallets"
              },
              "from": {
                "description": "Window start, Unix milliseconds"
              },
              "notice": {
                "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"
              }
            },
            "description": "Wallets ranked over the window"
          },
          "annotations": {
            "title": "PnL leaderboard",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_user_summary",
          "title": "Wallet summary",
          "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": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "to": {
                "type": "string",
                "description": "Window end: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now). Default now"
              },
              "from": {
                "type": "string",
                "description": "Window start: Unix ms or seconds, ISO 8601 (2026-10-01T00:00:00Z), or relative (-7d, -24h, now). Default 24 hours ago"
              },
              "address": {
                "type": "string",
                "description": "0x-prefixed 20-byte hex address"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "to": {
                "description": "Window end, Unix milliseconds"
              },
              "from": {
                "description": "Window start, Unix milliseconds"
              },
              "state": {
                "type": "object",
                "properties": {
                  "address": {
                    "description": "Wallet address (0x…)"
                  },
                  "as_of_ts": {
                    "description": "Snapshot time, Unix milliseconds"
                  },
                  "margin_summary": {
                    "type": "object",
                    "properties": {
                      "open_markets_count": {
                        "description": "Markets with an open position"
                      },
                      "total_realized_pnl": {
                        "description": "Sum of realized PnL in USD"
                      },
                      "total_position_value": {
                        "description": "Sum of position values in USD"
                      },
                      "total_unrealized_pnl": {
                        "description": "Sum of unrealized PnL in USD"
                      }
                    },
                    "description": "Account totals"
                  },
                  "asset_positions": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "size": {
                          "description": "Signed size: positive long, negative short"
                        },
                        "market": {
                          "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                        },
                        "leverage": {
                          "description": "Leverage"
                        },
                        "mark_price": {
                          "description": "Current mark price"
                        },
                        "entry_price": {
                          "description": "Average entry price"
                        },
                        "market_class": {
                          "description": "perp, spot, prediction or option"
                        },
                        "realized_pnl": {
                          "description": "Realized PnL in USD"
                        },
                        "leverage_type": {
                          "description": "cross or isolated"
                        },
                        "position_value": {
                          "description": "Position value in USD"
                        },
                        "unrealized_pnl": {
                          "description": "Unrealized PnL in USD"
                        },
                        "return_on_equity": {
                          "description": "Unrealized PnL divided by margin"
                        }
                      },
                      "description": "Open position"
                    },
                    "description": "Open positions"
                  }
                },
                "description": "Open positions right now"
              },
              "notice": {
                "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": {
                "type": "object",
                "properties": {
                  "fees": {
                    "description": "Fees in USD"
                  },
                  "wins": {
                    "description": "Profitable closing fills"
                  },
                  "losses": {
                    "description": "Losing closing fills"
                  },
                  "win_rate": {
                    "description": "Share of closed trades that were profitable, 0 to 1"
                  },
                  "pct_maker": {
                    "description": "Share of fills as maker, 0 to 1"
                  },
                  "fill_count": {
                    "description": "Fills"
                  },
                  "volume_usd": {
                    "description": "Traded notional in USD"
                  },
                  "maker_fills": {
                    "description": "Fills as maker"
                  },
                  "taker_fills": {
                    "description": "Fills as taker"
                  },
                  "realized_pnl": {
                    "description": "Realized PnL in USD"
                  },
                  "maker_notional": {
                    "description": "Maker notional in USD"
                  },
                  "taker_notional": {
                    "description": "Taker notional in USD"
                  }
                },
                "description": "Window totals"
              },
              "address": {
                "description": "Wallet address (0x…)"
              }
            },
            "description": "One wallet over a window"
          },
          "annotations": {
            "title": "Wallet summary",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_wallet_labels",
          "title": "Wallet labels",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "addresses": {
                "type": "string",
                "description": "Comma-separated wallet addresses to look up"
              },
              "smart_top_n": {
                "type": "number",
                "description": "Top N smart-money wallets to include (max 500, default 100)"
              },
              "whale_top_n": {
                "type": "number",
                "description": "Top N whales to include (max 500, default 100)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "note": {
                "description": "What the labels map includes"
              },
              "counts": {
                "description": "Wallets per label kind"
              },
              "labels": {
                "type": "object",
                "description": "Address to its labels",
                "additionalProperties": {
                  "type": "array",
                  "items": {
                    "type": "object",
                    "properties": {
                      "kind": {
                        "description": "whale, smart_money, vault or vault_leader"
                      },
                      "name": {
                        "description": "Display label"
                      },
                      "rank": {
                        "description": "Rank"
                      }
                    },
                    "description": "One label"
                  },
                  "description": "Labels"
                }
              },
              "notice": {
                "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"
              },
              "ttl_seconds": {
                "description": "Cache lifetime"
              },
              "generated_at": {
                "description": "Unix milliseconds"
              }
            },
            "description": "Labels for notable wallets"
          },
          "annotations": {
            "title": "Wallet labels",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_market_leaders",
          "title": "Market leaders",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of traders (1-50, default 20)"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              },
              "window": {
                "enum": [
                  "7d",
                  "30d",
                  "90d"
                ],
                "type": "string",
                "description": "Lookback window. Default 30d"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "market": {
                "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
              },
              "notice": {
                "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": {
                "description": "Lookback window, e.g. \"30d\""
              },
              "traders": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "trades": {
                      "description": "Closed trades in the window"
                    },
                    "address": {
                      "description": "Wallet address (0x…)"
                    },
                    "win_rate": {
                      "description": "Share of closed trades that were profitable, 0 to 1"
                    },
                    "last_trade_ms": {
                      "description": "Last trade, Unix milliseconds"
                    },
                    "profit_factor": {
                      "description": "Gross profit divided by gross loss"
                    },
                    "avg_notional_usd": {
                      "description": "Average trade size in USD"
                    },
                    "realized_pnl_usd": {
                      "description": "Realized PnL in USD"
                    }
                  },
                  "description": "One trader"
                },
                "description": "Traders"
              }
            },
            "description": "Best traders on one market"
          },
          "annotations": {
            "title": "Market leaders",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_early_movers",
          "title": "Early movers",
          "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": {
            "type": "object",
            "required": [
              "market"
            ],
            "properties": {
              "limit": {
                "type": "number",
                "description": "Number of wallets (1-25, default 10)"
              },
              "market": {
                "type": "string",
                "description": "Market: BTC-PERP, xyz:NVDA-PERP, HYPE/USDC, or a Hyperliquid name (BTC, @107, xyz:NVDA)"
              },
              "window": {
                "enum": [
                  "7d",
                  "30d"
                ],
                "type": "string",
                "description": "Lookback window. Default 30d"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "market": {
                "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
              },
              "notice": {
                "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": {
                "description": "Lookback window, e.g. \"30d\""
              },
              "formula": {
                "description": "How the lead score is computed"
              },
              "signals": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "events": {
                      "description": "Scored large orders"
                    },
                    "address": {
                      "description": "Wallet address (0x…)"
                    },
                    "hit_rate": {
                      "description": "Share of orders followed by a move in their direction"
                    },
                    "notional_usd": {
                      "description": "Notional of scored orders in USD"
                    },
                    "last_event_ms": {
                      "description": "Last scored order, Unix milliseconds"
                    },
                    "lead_score_bps": {
                      "description": "Notional-weighted 30-minute forward return, basis points"
                    },
                    "cancel_ratio_30d": {
                      "description": "Share of large orders cancelled without a fill"
                    }
                  },
                  "description": "One wallet"
                },
                "description": "Wallets"
              }
            },
            "description": "Wallets whose large orders preceded moves"
          },
          "annotations": {
            "title": "Early movers",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_trader_profile",
          "title": "Trader profile",
          "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": {
            "type": "object",
            "required": [
              "address"
            ],
            "properties": {
              "window": {
                "enum": [
                  "7d",
                  "30d",
                  "90d"
                ],
                "type": "string",
                "description": "Lookback window. Default 30d"
              },
              "address": {
                "type": "string",
                "description": "0x-prefixed 20-byte hex address"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "notice": {
                "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"
              },
              "trades": {
                "description": "Recent round-trip trades"
              },
              "window": {
                "description": "Lookback window, e.g. \"30d\""
              },
              "address": {
                "description": "Wallet address (0x…)"
              },
              "markets": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "rank": {
                      "description": "Rank among the wallet's markets"
                    },
                    "market": {
                      "description": "Display symbol, e.g. \"BTC-PERP\" or \"xyz:NVDA-PERP\""
                    },
                    "trades": {
                      "description": "Closed trades in the window"
                    },
                    "win_rate": {
                      "description": "Share of closed trades that were profitable, 0 to 1"
                    },
                    "last_trade_ms": {
                      "description": "Last trade, Unix milliseconds"
                    },
                    "profit_factor": {
                      "description": "Gross profit divided by gross loss"
                    },
                    "avg_notional_usd": {
                      "description": "Average trade size in USD"
                    },
                    "realized_pnl_usd": {
                      "description": "Realized PnL in USD"
                    }
                  },
                  "description": "One market"
                },
                "description": "Best markets, ranked"
              },
              "overall": {
                "type": "object",
                "properties": {
                  "trades": {
                    "description": "Closed trades in the window"
                  },
                  "win_rate": {
                    "description": "Share of closed trades that were profitable, 0 to 1"
                  },
                  "profit_factor": {
                    "description": "Gross profit divided by gross loss"
                  },
                  "first_trade_ms": {
                    "description": "First trade, Unix milliseconds"
                  },
                  "max_drawdown_pct": {
                    "description": "Largest peak-to-trough drop of the PnL curve, 0 to 1"
                  },
                  "realized_pnl_usd": {
                    "description": "Realized PnL in USD"
                  }
                },
                "description": "Headline stats"
              },
              "liquidation_count": {
                "description": "Liquidations in the window"
              }
            },
            "description": "One wallet's trading record"
          },
          "annotations": {
            "title": "Trader profile",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "list_cohorts",
          "title": "List cohorts",
          "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": {
            "type": "object",
            "required": [],
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "data": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "name": {
                      "description": "Cohort name"
                    },
                    "description": {
                      "description": "What the cohort contains"
                    }
                  },
                  "description": "One cohort"
                },
                "description": "Cohorts"
              },
              "notice": {
                "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"
              }
            },
            "description": "Wallet cohorts"
          },
          "annotations": {
            "title": "List cohorts",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_cohort_addresses",
          "title": "Cohort addresses",
          "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": {
            "type": "object",
            "required": [
              "name"
            ],
            "properties": {
              "name": {
                "type": "string",
                "description": "Cohort name from list_cohorts: top_pnl_30d, high_volume_30d, whale_fills, net_withdrawers_7d, liquidation_prone, vault_whales, or a custom cohort you created"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "notice": {
                "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"
              },
              "addresses": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "value": {
                      "description": "The metric the cohort ranks by"
                    },
                    "address": {
                      "description": "Wallet address (0x…)"
                    }
                  },
                  "description": "One wallet"
                },
                "description": "Wallets"
              },
              "fetched_at": {
                "description": "Unix milliseconds"
              }
            },
            "description": "Wallets in a cohort"
          },
          "annotations": {
            "title": "Cohort addresses",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_status",
          "title": "API status",
          "description": "Is Ironflow up? Service status right now: overall state, data freshness per venue and component health.",
          "inputSchema": {
            "type": "object",
            "required": [],
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "notice": {
                "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": "operational, degraded or down"
              },
              "uptime": {
                "description": "Time since the last incident"
              },
              "venues": {
                "description": "Freshness per venue"
              },
              "platform": {
                "description": "Event and market counts"
              },
              "timestamp": {
                "description": "Unix milliseconds"
              },
              "components": {
                "description": "data_pipeline, rest_api and streaming health"
              }
            },
            "description": "Service status"
          },
          "annotations": {
            "title": "API status",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_status_metrics",
          "title": "API performance metrics",
          "description": "How fast is Ironflow? Performance over rolling windows: API latency and error rate, ingestion lag and synthetic probe timings.",
          "inputSchema": {
            "type": "object",
            "required": [],
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "api": {
                "description": "Latency and error rate"
              },
              "notice": {
                "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"
              },
              "synthetic": {
                "description": "Synthetic probe latencies"
              },
              "timestamp": {
                "description": "Unix milliseconds"
              }
            },
            "description": "Rolling performance metrics"
          },
          "annotations": {
            "title": "API performance metrics",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "get_status_history",
          "title": "API uptime history",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "period": {
                "enum": [
                  "24h",
                  "7d"
                ],
                "type": "string",
                "description": "Lookback window. '24h' (default) or '7d'."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "notice": {
                "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"
              },
              "points": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "ts": {
                      "description": "Hour start, Unix milliseconds"
                    },
                    "status": {
                      "description": "Worst status in the hour"
                    },
                    "fresh_sec": {
                      "description": "Data age in seconds"
                    }
                  },
                  "description": "One hour"
                },
                "description": "Hourly buckets"
              },
              "uptime_percent": {
                "description": "Share of operational hours"
              }
            },
            "description": "Hourly status timeline"
          },
          "annotations": {
            "title": "API uptime history",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "create_liquidation_alert",
          "title": "Create liquidation alert",
          "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": {
            "type": "object",
            "required": [],
            "properties": {
              "url": {
                "type": "string",
                "description": "Where to post: https://discord.com/api/webhooks/..., https://hooks.slack.com/services/... or a public https URL (or use telegram_chat)"
              },
              "name": {
                "type": "string",
                "description": "Label shown in each message, e.g. BTC whales"
              },
              "side": {
                "enum": [
                  "any",
                  "long",
                  "short"
                ],
                "type": "string",
                "description": "Which positions: long = longs liquidated (default any)"
              },
              "address": {
                "type": "string",
                "description": "Only this wallet's liquidations (0x...)"
              },
              "markets": {
                "type": "string",
                "description": "Comma-separated markets, e.g. BTC,ETH-PERP,xyz:NVDA (Hyperliquid names work); omit for every market"
              },
              "min_usd": {
                "type": "number",
                "description": "Smallest liquidation to report, in USD (default 0; 100000 keeps a channel readable)"
              },
              "telegram_chat": {
                "type": "string",
                "description": "A Telegram chat instead of url: @channel or group name, or a numeric chat id (-100...)"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "description": "Alert id (UUID)"
              },
              "name": {
                "description": "Label shown in each message"
              },
              "side": {
                "description": "any, long (longs liquidated) or short"
              },
              "type": {
                "description": "webhook, discord, slack or telegram"
              },
              "setup": {
                "description": "What to do before the first message arrives (Telegram: the bot to add to the chat)"
              },
              "notice": {
                "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": "active or disabled (after 20 failed deliveries in a row)"
              },
              "address": {
                "description": "Only this wallet, when set"
              },
              "markets": {
                "description": "Markets watched; empty means every market"
              },
              "min_usd": {
                "description": "Smallest liquidation reported, USD"
              },
              "failures": {
                "description": "Failed deliveries in a row"
              },
              "created_at": {
                "description": "Creation time, RFC 3339"
              },
              "last_error": {
                "description": "The destination's last error"
              },
              "sent_count": {
                "description": "Liquidations delivered so far"
              },
              "destination": {
                "description": "Host it posts to, without the secret part of the URL"
              },
              "last_sent_at": {
                "description": "Last delivery, RFC 3339; null before the first"
              },
              "signing_secret": {
                "description": "Webhooks only: HMAC key for the X-Ironflow-Signature header, shown only here"
              }
            },
            "description": "The new alert"
          },
          "annotations": {
            "title": "Create liquidation alert",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "list_liquidation_alerts",
          "title": "List liquidation alerts",
          "description": "Needs an API key (a free key works). The Hyperliquid liquidation alerts on this API key's account: where each posts (host only), its filter, whether it is active, failed deliveries in a row with the last error, liquidations sent so far, and how many alerts the tier allows. An alert is disabled after 20 failed deliveries in a row; test_liquidation_alert re-enables it once the destination works again.",
          "inputSchema": {
            "type": "object",
            "required": [],
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "limit": {
                "description": "Alerts this tier allows"
              },
              "alerts": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "description": "Alert id (UUID)"
                    },
                    "name": {
                      "description": "Label shown in each message"
                    },
                    "side": {
                      "description": "any, long (longs liquidated) or short"
                    },
                    "type": {
                      "description": "webhook, discord, slack or telegram"
                    },
                    "status": {
                      "description": "active or disabled (after 20 failed deliveries in a row)"
                    },
                    "address": {
                      "description": "Only this wallet, when set"
                    },
                    "markets": {
                      "description": "Markets watched; empty means every market"
                    },
                    "min_usd": {
                      "description": "Smallest liquidation reported, USD"
                    },
                    "failures": {
                      "description": "Failed deliveries in a row"
                    },
                    "created_at": {
                      "description": "Creation time, RFC 3339"
                    },
                    "last_error": {
                      "description": "The destination's last error"
                    },
                    "sent_count": {
                      "description": "Liquidations delivered so far"
                    },
                    "destination": {
                      "description": "Host it posts to, without the secret part of the URL"
                    },
                    "last_sent_at": {
                      "description": "Last delivery, RFC 3339; null before the first"
                    }
                  },
                  "description": "One alert"
                },
                "description": "Alerts"
              },
              "notice": {
                "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"
              }
            },
            "description": "The account's liquidation alerts"
          },
          "annotations": {
            "title": "List liquidation alerts",
            "readOnlyHint": true,
            "openWorldHint": true
          }
        },
        {
          "name": "test_liquidation_alert",
          "title": "Test liquidation alert",
          "description": "Needs an API key (a free key works). Send a sample Hyperliquid liquidation, marked as a test, to an alert's destination now and report whether it arrived (delivered true or false, with the destination's answer). A delivered test switches a disabled alert back on. One test per alert every 10 seconds.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Alert id from create_liquidation_alert or list_liquidation_alerts"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "error": {
                "description": "The destination's answer when it was not delivered"
              },
              "notice": {
                "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"
              },
              "delivered": {
                "description": "Whether the destination accepted the test message"
              }
            },
            "description": "Test delivery result"
          },
          "annotations": {
            "title": "Test liquidation alert",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "delete_liquidation_alert",
          "title": "Delete liquidation alert",
          "description": "Needs an API key (a free key works). Stop and remove one Hyperliquid liquidation alert from this API key's account; nothing more is sent to its destination.",
          "inputSchema": {
            "type": "object",
            "required": [
              "id"
            ],
            "properties": {
              "id": {
                "type": "string",
                "description": "Alert id from list_liquidation_alerts"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "properties": {
              "id": {
                "description": "The deleted alert's id"
              },
              "notice": {
                "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"
              },
              "deleted": {
                "description": "true"
              }
            },
            "description": "Deletion"
          },
          "annotations": {
            "title": "Delete liquidation alert",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": [
        {
          "name": "biggest_liquidations",
          "description": "The largest Hyperliquid liquidations of the last 24 hours, across every market or on one",
          "arguments": [
            {
              "name": "market",
              "description": "Optional: one market such as BTC or xyz:NVDA. Leave empty for every market"
            }
          ]
        },
        {
          "name": "liquidation_map",
          "description": "Where open positions on a Hyperliquid perp would be liquidated if the price moved",
          "arguments": [
            {
              "name": "market",
              "description": "A perp such as BTC, ETH or xyz:NVDA. Default BTC"
            }
          ]
        },
        {
          "name": "market_movers",
          "description": "Hyperliquid markets with the biggest price and open interest moves of the last 24 hours",
          "arguments": []
        },
        {
          "name": "wallet_check",
          "description": "Open positions, PnL and trading record of one Hyperliquid wallet",
          "arguments": [
            {
              "name": "address",
              "required": true,
              "description": "The wallet address (0x...)"
            }
          ]
        }
      ]
    },
    "instructions": "Ironflow serves live Hyperliquid data from its own nodes: perps, HIP-3 markets such as xyz:NVDA, HIP-4 outcomes and spot. Use these tools for crypto market questions about prices, funding, liquidations, open interest, top traders or a 0x wallet, also when the user does not name Hyperliquid, and say the numbers are Hyperliquid's. First call by question: biggest liquidations, get_liquidation_summary (rows: get_liquidations); liquidation levels, get_liquidation_map; funding now, get_mark_prices (history: get_funding_rates); a price, get_price (history: get_candles); what is moving, get_markets_snapshot or get_open_interest_changes; top traders, get_top_traders; a wallet, get_user_state, then get_user_pnl_series. list_markets with q finds a market name. For anything else call describe_data, then run_query with ClickHouse SQL over the hl.* tables. A result can start with a notice and an error can end with a step for the user; pass it on. Each call costs credits: 1 for a read, 5 for analytics, 10 for run_query, none for describe_data or status. Keyless use allows 30 requests a minute, 100 credits a day and 24 hours of history; a free key from https://ironflow.sh/key raises that to 60 a minute, 1,000 credits a day (3,000 a month) and 14 days. Limits: https://docs.ironflow.sh/concepts/rate-limits. create_liquidation_alert posts liquidations to the user's Discord, Slack, Telegram or webhook as they happen (needs a key, a free key works). Agents with USDC on Base can pay per call with x402, with no key: https://docs.ironflow.sh/guides/pay-per-call."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}