@aicoin/opendata-mcp 1.0.28 → 2.0.0

package/build/index.js

@@ -44,7 +44,7 @@ Endpoint: ${path}`;
   }
   throw new Error(msg);
 }
-var BIZ_AUTH_CODES = /* @__PURE__ */ new Set([304, 403, 401]);
+var BIZ_AUTH_CODES = /* @__PURE__ */ new Set([403, 401, 304]);
 function checkBizError(data, path) {
   if (!data || typeof data !== "object") return;
   const obj = data;
@@ -329,2410 +329,1225 @@ function err(e) {
 // src/tools/coins.ts
 function registerCoinTools(server2) {
   server2.tool(
-    "get_coin_list",
-    "Get supported coins list (returns top 100 by default, use get_coin_ticker for specific coins)",
-    { ...maxItemsParam },
-    async ({ _max_items }) => {
-      try {
-        return okList(
-          await apiGet("/api/v2/coin"),
-          parseMax(_max_items, 100)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_coin_ticker",
-    "Get real-time ticker data for coins (price, change, volume)",
-    {
-      coin_list: z2.string().describe("Coin keys, comma-separated, e.g. bitcoin,ethereum")
-    },
-    async ({ coin_list }) => {
-      try {
-        return ok(
-          await apiGet("/api/v2/coin/ticker", { coin_list })
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_coin_config",
-    "Get coin profile/description data",
-    {
-      coin_list: z2.string().describe(
-        "Coin keys, comma-separated, max 100, e.g. bitcoin,ethereum"
-      )
-    },
-    async ({ coin_list }) => {
-      try {
-        return ok(
-          await apiGet("/api/v2/coin/config", { coin_list })
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_ai_coin_analysis",
-    "Get AI interpretation and prediction for coins",
-    {
-      coin_keys: z2.string().describe('Coin keys JSON array, e.g. ["bitcoin","ethereum"]'),
-      language: z2.enum(["CN", "EN", "TC"]).optional().describe("Language: CN/EN/TC, default CN")
-    },
-    async ({ coin_keys, language }) => {
-      try {
-        const body = {
-          coinKeys: JSON.parse(coin_keys)
-        };
-        if (language) body.language = language;
-        return ok(
-          await apiPost("/api/v2/content/ai-coins", body)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_funding_rate_history",
-    "Get funding rate history",
-    {
-      symbol: z2.string().describe(
-        "Trading pair, e.g. btcswapusdt:okcoinfutures"
-      ),
-      interval: z2.string().describe(
-        "Interval: 5m,15m,30m,8h (recommended). 1h,4h,1d may return empty data"
-      ),
-      limit: z2.string().optional().describe("Number of records, default 100"),
-      start_time: z2.string().optional().describe("Start time in ms"),
-      end_time: z2.string().optional().describe("End time in ms")
-    },
-    async ({ symbol, interval, limit, start_time, end_time }) => {
-      try {
-        const params = {
-          symbol,
-          interval
-        };
-        params.limit = limit ?? "100";
-        if (start_time) params.start_time = start_time;
-        if (end_time) params.end_time = end_time;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/funding-rate/history",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_liquidation_map",
-    "Get liquidation heatmap data",
+    "coin_info",
+    "Coin data.\n\u2022 list \u2014 all coins, no params needed\n\u2022 ticker \u2014 real-time prices. Requires: coin_list\n\u2022 config \u2014 coin profiles. Requires: coin_list\n\u2022 ai_analysis \u2014 AI predictions. Requires: coin_keys (JSON array string)",
     {
-      dbkey: z2.string().describe(
-        "Trading pair key, e.g. btcswapusdt:binance"
-      ),
-      cycle: z2.string().describe("Cycle: 24h or 7d"),
-      leverage: z2.string().optional().describe(
-        "Leverage filter: 10,25,50,100 (empty=all)"
+      action: z2.enum(["list", "ticker", "config", "ai_analysis"]).describe(
+        "list: top coins; ticker: real-time prices; config: coin profiles; ai_analysis: AI predictions"
       ),
+      coin_list: z2.string().optional().describe('REQUIRED for ticker, config. Comma-separated coin keys, e.g. "bitcoin,ethereum". NOT used by ai_analysis'),
+      coin_keys: z2.string().optional().describe(`REQUIRED for ai_analysis. JSON array string, e.g. '["bitcoin","ethereum"]'. NOT used by ticker/config`),
+      language: z2.enum(["CN", "EN", "TC"]).optional().describe("Optional for ai_analysis: response language, default CN"),
       ...maxItemsParam
     },
-    async ({ dbkey, cycle, leverage, _max_items }) => {
-      try {
-        const params = {
-          dbkey,
-          cycle
-        };
-        if (leverage) params.leverage = leverage;
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/futures/liquidation/map",
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_weighted_funding_rate_history",
-    "Get volume-weighted funding rate history",
-    {
-      symbol: z2.string().describe("Symbol, e.g. btcswapusdt"),
-      interval: z2.string().describe(
-        "Interval: 5m,15m,30m,8h (recommended). 1h,4h,1d may return empty data"
-      ),
-      limit: z2.string().optional().describe("Number of records, default 100"),
-      start_time: z2.string().optional().describe("Start time in ms"),
-      end_time: z2.string().optional().describe("End time in ms")
-    },
-    async ({ symbol, interval, limit, start_time, end_time }) => {
-      try {
-        const params = {
-          symbol,
-          interval
-        };
-        params.limit = limit ?? "100";
-        if (start_time) params.start_time = start_time;
-        if (end_time) params.end_time = end_time;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/funding-rate/vol-weight-history",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_aggregated_stablecoin_oi_history",
-    "Get aggregated stablecoin-margined open interest history",
-    {
-      symbol: z2.string().describe("Coin symbol, e.g. BTC"),
-      interval: z2.string().describe("Interval: 1m,2m,15m,30m"),
-      limit: z2.string().optional().describe("Number of records, default 100"),
-      start_time: z2.string().optional().describe("Start time in ms"),
-      end_time: z2.string().optional().describe("End time in ms")
-    },
-    async ({ symbol, interval, limit, start_time, end_time }) => {
+    async ({ action, coin_list, coin_keys, language, _max_items }) => {
       try {
-        const params = {
-          symbol,
-          interval
-        };
-        params.limit = limit ?? "100";
-        if (start_time) params.start_time = start_time;
-        if (end_time) params.end_time = end_time;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/open-interest/aggregated-stablecoin-history",
-            params
-          )
-        );
+        switch (action) {
+          case "list":
+            return okList(await apiGet("/api/v2/coin"), parseMax(_max_items, 100));
+          case "ticker": {
+            if (!coin_list) return err("coin_list is required for ticker action");
+            return ok(await apiGet("/api/v2/coin/ticker", { coin_list }));
+          }
+          case "config": {
+            if (!coin_list) return err("coin_list is required for config action");
+            return ok(await apiGet("/api/v2/coin/config", { coin_list }));
+          }
+          case "ai_analysis": {
+            if (!coin_keys) return err("coin_keys is required for ai_analysis action");
+            const body = { coinKeys: JSON.parse(coin_keys) };
+            if (language) body.language = language;
+            return ok(await apiPost("/api/v2/content/ai-coins", body));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "get_aggregated_coin_margin_oi_history",
-    "Get aggregated coin-margined open interest history",
+    "coin_funding_rate",
+    "Funding rate history.\n\u2022 Default: per-exchange rate. Requires symbol with exchange suffix, e.g. btcswapusdt:binance\n\u2022 weighted=true: volume-weighted rate across exchanges. Symbol WITHOUT exchange suffix, e.g. btcswapusdt",
     {
-      symbol: z2.string().describe("Coin symbol, e.g. BTC"),
-      interval: z2.string().describe("Interval: 1m,2m,15m,30m"),
+      symbol: z2.string().describe("REQUIRED. Trading pair. With exchange suffix for normal (e.g. btcswapusdt:binance), WITHOUT suffix for weighted (e.g. btcswapusdt)"),
+      interval: z2.string().describe("REQUIRED. Candle interval: 5m, 15m, 30m, 8h (recommended). 1h, 4h, 1d may return empty"),
+      weighted: z2.boolean().optional().default(false).describe("Use volume-weighted funding rate"),
       limit: z2.string().optional().describe("Number of records, default 100"),
       start_time: z2.string().optional().describe("Start time in ms"),
       end_time: z2.string().optional().describe("End time in ms")
     },
-    async ({ symbol, interval, limit, start_time, end_time }) => {
-      try {
-        const params = {
-          symbol,
-          interval
-        };
-        params.limit = limit ?? "100";
-        if (start_time) params.start_time = start_time;
-        if (end_time) params.end_time = end_time;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/open-interest/aggregated-coin-margin-history",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_liquidation_history",
-    "Get liquidation order history",
-    {
-      symbol: z2.string().describe(
-        "Trading pair, e.g. btcswapusdt:binance"
-      ),
-      interval: z2.string().describe("Interval: 1m,2m,15m,30m"),
-      limit: z2.string().optional().describe("Number of records, default 10"),
-      start_time: z2.string().optional().describe("Start time in ms"),
-      end_time: z2.string().optional().describe("End time in ms")
-    },
-    async ({ symbol, interval, limit, start_time, end_time }) => {
+    async ({ symbol, interval, weighted, limit, start_time, end_time }) => {
       try {
-        const params = {
-          symbol,
-          interval
-        };
+        const params = { symbol, interval };
         params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/liquidation/history",
-            params
-          )
-        );
+        const path = weighted ? "/api/upgrade/v2/futures/funding-rate/vol-weight-history" : "/api/upgrade/v2/futures/funding-rate/history";
+        return ok(await apiGet(path, params));
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "get_estimated_liquidation_history",
-    "Get historical estimated liquidation chart data",
+    "coin_liquidation",
+    "Liquidation data.\n\u2022 history \u2014 liquidation orders. Requires: symbol + interval\n\u2022 map \u2014 liquidation heatmap. Requires: dbkey + cycle\n\u2022 estimated \u2014 estimated liquidation chart. Requires: dbkey + cycle",
     {
-      dbkey: z2.string().describe(
-        "Trading pair key, e.g. btcswapusdt:binance"
-      ),
-      cycle: z2.string().describe("Cycle: 24h or 7d"),
-      leverage: z2.string().optional().describe(
-        "Leverage filter: 10,25,50,100 (empty=all)"
+      action: z2.enum(["map", "history", "estimated"]).describe(
+        "map: liquidation heatmap; history: liquidation orders; estimated: estimated liquidation chart"
       ),
-      limit: z2.string().optional().describe("Number of records, default 100"),
+      symbol: z2.string().optional().describe("REQUIRED for history. Trading pair with exchange, e.g. btcswapusdt:binance. NOT used by map/estimated"),
+      dbkey: z2.string().optional().describe("REQUIRED for map, estimated. Trading pair key, e.g. btcswapusdt:binance. NOT used by history"),
+      cycle: z2.string().optional().describe('REQUIRED for map, estimated. Time cycle: "24h" or "7d"'),
+      leverage: z2.string().optional().describe("Optional for map, estimated. Leverage filter: 10, 25, 50, 100"),
+      interval: z2.string().optional().describe("REQUIRED for history. Candle interval: 1m, 2m, 15m, 30m"),
+      limit: z2.string().optional().describe("Number of records"),
       start_time: z2.string().optional().describe("Start time in ms"),
       end_time: z2.string().optional().describe("End time in ms"),
       ...maxItemsParam
     },
-    async ({ dbkey, cycle, leverage, limit, start_time, end_time, _max_items }) => {
-      try {
-        const params = {
-          dbkey,
-          cycle
-        };
-        if (leverage) params.leverage = leverage;
-        params.limit = limit ?? "5";
-        if (start_time) params.start_time = start_time;
-        if (end_time) params.end_time = end_time;
-        return okListDeep(
-          await apiGet(
-            "/api/upgrade/v2/futures/estimated-liquidation/history",
-            params
-          ),
-          parseMax(_max_items, 5),
-          20
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_historical_depth",
-    "Get historical order book depth data",
-    {
-      key: z2.string().describe(
-        "Trading pair key, e.g. btcswapusdt:okcoinfutures"
-      ),
-      limit: z2.string().optional().describe("Number of records, max 1000"),
-      start_time: z2.string().optional().describe("Start time in ms"),
-      end_time: z2.string().optional().describe("End time in ms")
-    },
-    async ({ key, limit, start_time, end_time }) => {
-      try {
-        const params = { key };
-        params.limit = limit ?? "100";
-        if (start_time) params.start_time = start_time;
-        if (end_time) params.end_time = end_time;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/historical-depth",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_super_depth_history",
-    "Get large order depth history",
-    {
-      key: z2.string().describe(
-        "Trading pair key, e.g. btcswapusdt:okcoinfutures"
-      ),
-      amount: z2.string().optional().describe("USD threshold, default 10000"),
-      limit: z2.string().optional().describe("Number of records, max 1000"),
-      start_time: z2.string().optional().describe("Start time in ms"),
-      end_time: z2.string().optional().describe("End time in ms")
-    },
-    async ({ key, amount, limit, start_time, end_time }) => {
-      try {
-        const params = { key };
-        params.amount = amount ?? "10000";
-        params.limit = limit ?? "100";
-        if (start_time) params.start_time = start_time;
-        if (end_time) params.end_time = end_time;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/super-depth/history",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_trade_data",
-    "Get latest trade data for futures",
-    {
-      dbkey: z2.string().describe(
-        "Trading pair key, e.g. btcswapusdt:okcoinfutures"
-      ),
-      limit: z2.string().optional().describe("Number of records, max 1000"),
-      start_time: z2.string().optional().describe("Start time in ms"),
-      end_time: z2.string().optional().describe("End time in ms")
-    },
-    async ({ dbkey, limit, start_time, end_time }) => {
-      try {
-        const params = { dbkey };
-        params.limit = limit ?? "100";
-        if (start_time) params.start_time = start_time;
-        if (end_time) params.end_time = end_time;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/trade-data",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-}
-
-// src/tools/contents.ts
-import { z as z3 } from "zod";
-function registerContentTools(server2) {
-  server2.tool(
-    "get_newsflash",
-    "Get latest crypto flash news by AiCoin only",
-    {
-      language: z3.string().optional().describe("Language: cn, tc, en")
-    },
-    async ({ language }) => {
-      try {
-        const params = {};
-        if (language) params.language = language;
-        return ok(
-          await apiGet("/api/v2/content/newsflash", params)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_news_list",
-    "Get news article list",
-    {
-      page: z3.string().optional().describe("Page number, default 1"),
-      pageSize: z3.string().optional().describe("Page size, max 20")
-    },
-    async ({ page, pageSize }) => {
-      try {
-        const params = {};
-        if (page) params.page = page;
-        params.pageSize = pageSize ?? "20";
-        return ok(
-          await apiGet("/api/v2/content/news-list", params)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_news_detail",
-    "Get full content of a news article",
-    {
-      id: z3.string().describe("News article ID")
-    },
-    async ({ id }) => {
-      try {
-        return ok(
-          await apiGet("/api/v2/content/news-detail", { id })
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_rss_news_list",
-    "Get RSS news list (dedicated RSS feed)",
-    {
-      page: z3.string().optional().describe("Page number"),
-      pageSize: z3.string().optional().describe("Page size, max 20")
-    },
-    async ({ page, pageSize }) => {
-      try {
-        const params = {};
-        if (page) params.page = page;
-        params.pageSize = pageSize ?? "20";
-        return ok(
-          await apiGet(
-            "/api/v2/content/square/market/news-list",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_flash_list",
-    "Get industry flash news (with flash type classification)",
-    {
-      language: z3.string().optional().describe("Language: cn, tc, en"),
-      createtime: z3.string().optional().describe("Filter by create time"),
-      ...maxItemsParam
-    },
-    async ({ language, createtime, _max_items }) => {
-      try {
-        const params = {};
-        if (language) params.language = language;
-        if (createtime) params.createtime = createtime;
-        return okList(
-          await apiGet(
-            "/api/v2/content/flashList",
-            params
-          ),
-          parseMax(_max_items, 30)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_exchange_listing_flash",
-    "Get exchange coin listing/delisting news",
-    {
-      language: z3.string().optional().describe("Language: cn, tc, en"),
-      memberIds: z3.string().optional().describe(
-        "Exchange member IDs, comma-separated. 477=Binance, 1509=Bitget. Default: 477,1509"
-      ),
-      pageSize: z3.string().optional().describe("Page size, default 20")
-    },
-    async ({ language, memberIds, pageSize }) => {
-      try {
-        const params = {};
-        if (language) params.language = language;
-        if (memberIds) params.memberIds = memberIds;
-        if (pageSize) params.pageSize = pageSize;
-        return ok(
-          await apiGet(
-            "/api/v2/content/exchange-listing-flash",
-            params
-          )
-        );
+    async ({ action, symbol, dbkey, cycle, leverage, interval, limit, start_time, end_time, _max_items }) => {
+      try {
+        switch (action) {
+          case "map": {
+            if (!dbkey || !cycle) return err("dbkey and cycle are required for map action");
+            const params = { dbkey, cycle };
+            if (leverage) params.leverage = leverage;
+            return okList(
+              await apiGet("/api/upgrade/v2/futures/liquidation/map", params),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "history": {
+            if (!symbol || !interval) return err("symbol and interval are required for history action");
+            const params = { symbol, interval };
+            params.limit = limit ?? "100";
+            if (start_time) params.start_time = start_time;
+            if (end_time) params.end_time = end_time;
+            return ok(await apiGet("/api/upgrade/v2/futures/liquidation/history", params));
+          }
+          case "estimated": {
+            if (!dbkey || !cycle) return err("dbkey and cycle are required for estimated action");
+            const params = { dbkey, cycle };
+            if (leverage) params.leverage = leverage;
+            params.limit = limit ?? "5";
+            if (start_time) params.start_time = start_time;
+            if (end_time) params.end_time = end_time;
+            return okListDeep(
+              await apiGet("/api/upgrade/v2/futures/estimated-liquidation/history", params),
+              parseMax(_max_items, 5),
+              20
+            );
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
-}
-
-// src/tools/markets.ts
-import { z as z4 } from "zod";
-function registerMarketTools(server2) {
   server2.tool(
-    "get_kline_data",
-    "Get K-line (candlestick) data for a trading pair",
+    "coin_open_interest",
+    "Aggregated open interest history. Requires: symbol + interval.\n\u2022 margin_type=stablecoin: stablecoin-margined OI (default)\n\u2022 margin_type=coin: coin-margined OI",
     {
-      symbol: z4.string().describe(
-        "Symbol, e.g. btcusdt:okex or i:ixic:nasdaq"
-      ),
-      period: z4.string().optional().describe(
-        "Period in seconds: 900=15min, 3600=1h, 14400=4h, 86400=1d"
-      ),
-      size: z4.string().optional().describe("Number of candles, 1-500"),
-      since: z4.string().optional().describe("Start timestamp"),
-      open_time: z4.string().optional().describe("Open time offset: 0 or 8")
-    },
-    async ({ symbol, period, size, since, open_time }) => {
-      try {
-        const params = {
-          symbol
-        };
-        if (period) params.period = period;
-        params.size = size ?? "100";
-        if (since) params.since = since;
-        if (open_time) params.open_time = open_time;
-        return ok(
-          await apiGet(
-            "/api/v2/commonKline/dataRecords",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_market_ticker",
-    "Get ticker data for exchange platforms",
-    {
-      market_list: z4.string().describe(
-        "Comma-separated exchange keys, max 100, e.g. okex,binance"
-      )
-    },
-    async ({ market_list }) => {
-      try {
-        return ok(
-          await apiGet("/api/v2/market/ticker", {
-            market_list
-          })
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_markets",
-    "Get list of all supported exchange platforms",
-    {},
-    async () => {
-      try {
-        return ok(await apiGet("/api/v2/market"));
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_futures_interest",
-    "Get futures open interest data",
-    {
-      lan: z4.string().optional().describe("Language: cn or en"),
-      page: z4.string().optional().describe("Page number"),
-      pageSize: z4.string().optional().describe("Page size, max 20"),
-      currency: z4.string().optional().describe("Currency: cny or usd")
-    },
-    async ({ lan, page, pageSize, currency }) => {
-      try {
-        const params = {};
-        if (lan) params.lan = lan;
-        if (page) params.page = page;
-        if (pageSize) params.pageSize = pageSize;
-        if (currency) params.currency = currency;
-        return ok(
-          await apiGet(
-            "/api/v2/futures/interest",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_crypto_stock_quotes",
-    "Get crypto-related stock quotes (MSTR, COIN, etc.)",
-    {
-      tickers: z4.string().optional().describe(
-        "Stock tickers, e.g. i:mstr:nasdaq,i:coin:nasdaq"
-      )
-    },
-    async ({ tickers }) => {
-      try {
-        const params = {};
-        if (tickers) params.tickers = tickers;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/crypto_stock/quotes",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_crypto_stock_top_gainer",
-    "Get top gaining crypto-related stocks (US and/or HK market)",
-    {
-      us_stock: z4.boolean().optional().describe("Include US stocks (default false)"),
-      hk_stock: z4.boolean().optional().describe("Include HK stocks (default false)"),
-      limit: z4.number().optional().describe("Number of results (default 50)")
-    },
-    async ({ us_stock, hk_stock, limit }) => {
-      try {
-        const params = {};
-        if (us_stock != null)
-          params.us_stock = String(us_stock);
-        if (hk_stock != null)
-          params.hk_stock = String(hk_stock);
-        params.limit = String(limit ?? 30);
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/crypto_stock/top-gainer",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_index_price",
-    "Get index price data",
-    {
-      key: z4.string().describe("Index key, e.g. i:diniw:ice"),
-      currency: z4.string().optional().describe("Currency: cny or usd")
-    },
-    async ({ key, currency }) => {
-      try {
-        const params = { key };
-        if (currency) params.currency = currency;
-        return ok(
-          await apiGet("/api/v2/index/indexPrice", params)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_hot_tab_coins",
-    "Get trending/hot coins list by category",
-    {
-      key: z4.string().describe(
-        "Category key: gamefi,anonymous,market,web,newcoin,stable,defi"
-      ),
-      currency: z4.string().optional().describe("Currency: cny or usd"),
-      ...maxItemsParam
-    },
-    async ({ key, currency, _max_items }) => {
-      try {
-        const params = { key };
-        if (currency) params.currency = currency;
-        return okList(
-          await apiGet(
-            "/api/v2/market/hotTabCoins",
-            params
-          ),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_crypto_company_info",
-    "Get crypto-related company details by stock symbol",
-    {
-      symbol: z4.string().describe(
-        "Symbol in i:ticker:market format, e.g. i:mstr:nasdaq"
-      )
-    },
-    async ({ symbol }) => {
-      try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/crypto_stock/company/${symbol}`
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_index_info",
-    "Get index detail information",
-    {
-      key: z4.string().describe("Index key, e.g. i:diniw:ice"),
-      lan: z4.string().optional().describe("Language: en or cn")
-    },
-    async ({ key, lan }) => {
-      try {
-        const params = { key };
-        if (lan) params.lan = lan;
-        return ok(
-          await apiGet("/api/v2/index/indexInfo", params)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_index_list",
-    "Get list of all available indexes",
-    { ...maxItemsParam },
-    async ({ _max_items }) => {
-      try {
-        return okList(
-          await apiGet("/api/v2/index/getIndex"),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_indicator_kline_trading_pair",
-    "Get trading pairs for indicator K-line",
-    {
-      coinType: z4.string().optional().describe("Coin type, e.g. bitcoin"),
-      indicator_key: z4.string().optional().describe(
-        "Indicator key: fundflow,aiaggtrade,fr,etc."
-      )
-    },
-    async ({ coinType, indicator_key }) => {
-      try {
-        const params = {};
-        if (coinType) params.coinType = coinType;
-        if (indicator_key)
-          params.indicator_key = indicator_key;
-        return ok(
-          await apiGet(
-            "/api/v2/indicatorKline/getTradingPair",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_indicator_kline_data",
-    "Get indicator K-line data records",
-    {
-      symbol: z4.string().describe(
-        "Trading pair, e.g. btcswapusdt:binance"
-      ),
-      indicator_key: z4.string().describe(
-        "Indicator key: fundflow, aiaggtrade, fr, etc."
-      ),
-      period: z4.string().optional().describe(
-        "Period in seconds: 900=15min, 3600=1h, 14400=4h, 86400=1d"
-      ),
-      size: z4.string().optional().describe("Number of records, 1-500"),
-      since: z4.string().optional().describe("Start timestamp"),
-      open_time: z4.string().optional().describe("Open time offset: 0 or 8")
-    },
-    async ({
-      symbol,
-      indicator_key,
-      period,
-      size,
-      since,
-      open_time
-    }) => {
-      try {
-        const params = {
-          symbol,
-          indicator_key
-        };
-        if (period) params.period = period;
-        params.size = size ?? "100";
-        if (since) params.since = since;
-        if (open_time) params.open_time = open_time;
-        return ok(
-          await apiGet(
-            "/api/v2/indicatorKline/dataRecords",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_coin_treasury_entities",
-    "Get coin treasury entity data (e.g. MicroStrategy BTC holdings)",
-    {
-      coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
-      entity_type: z4.string().optional().describe(
-        "Entity type: public-companies, eth-treasuries, etc."
-      ),
-      name: z4.string().optional().describe("Entity name fuzzy search"),
-      ticker: z4.string().optional().describe("Stock ticker filter"),
-      start_date: z4.string().optional().describe("Start date, ISO 8601"),
-      end_date: z4.string().optional().describe("End date, ISO 8601"),
-      page: z4.string().optional().describe("Page number, default 1"),
-      page_size: z4.string().optional().describe("Page size, default 20, max 100"),
-      sort_order: z4.string().optional().describe("Sort: asc or desc, default desc")
-    },
-    async ({
-      coin,
-      entity_type,
-      name,
-      ticker,
-      start_date,
-      end_date,
-      page,
-      page_size,
-      sort_order
-    }) => {
-      try {
-        const body = { coin };
-        if (entity_type) body.entity_type = entity_type;
-        if (name) body.name = name;
-        if (ticker) body.ticker = ticker;
-        if (start_date) body.start_date = start_date;
-        if (end_date) body.end_date = end_date;
-        if (page) body.page = Number(page);
-        if (page_size)
-          body.page_size = Number(page_size);
-        if (sort_order) body.sort_order = sort_order;
-        return ok(
-          await apiPost(
-            "/api/upgrade/v2/coin-treasuries/entities",
-            body
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_coin_treasury_history",
-    "Get coin treasury historical data",
-    {
-      coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
-      name: z4.string().optional().describe("Entity name filter"),
-      type: z4.string().optional().describe("Trade type: Buy or Sell"),
-      start_date: z4.string().optional().describe("Start date, ISO 8601"),
-      end_date: z4.string().optional().describe("End date, ISO 8601"),
-      page: z4.string().optional().describe("Page number, default 1"),
-      page_size: z4.string().optional().describe("Page size, default 20"),
-      sort_by: z4.string().optional().describe("Sort field, default date"),
-      sort_order: z4.string().optional().describe("Sort: asc or desc, default desc")
-    },
-    async ({
-      coin,
-      name,
-      type,
-      start_date,
-      end_date,
-      page,
-      page_size,
-      sort_by,
-      sort_order
-    }) => {
-      try {
-        const body = { coin };
-        if (name) body.name = name;
-        if (type) body.type = type;
-        if (start_date) body.start_date = start_date;
-        if (end_date) body.end_date = end_date;
-        if (page) body.page = Number(page);
-        if (page_size)
-          body.page_size = Number(page_size);
-        if (sort_by) body.sort_by = sort_by;
-        if (sort_order) body.sort_order = sort_order;
-        return ok(
-          await apiPost(
-            "/api/upgrade/v2/coin-treasuries/history",
-            body
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_coin_treasury_accumulated",
-    "Get accumulated coin treasury historical data",
-    {
-      coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
-      entity_type: z4.string().optional().describe("Entity type filter"),
-      start_date: z4.string().optional().describe("Start date, ISO 8601"),
-      end_date: z4.string().optional().describe("End date, ISO 8601"),
-      interval: z4.string().optional().describe(
-        "Interval: daily, weekly, or monthly"
-      )
-    },
-    async ({
-      coin,
-      entity_type,
-      start_date,
-      end_date,
-      interval
-    }) => {
-      try {
-        const body = { coin };
-        if (entity_type)
-          body.entity_type = entity_type;
-        if (start_date)
-          body.start_date = start_date;
-        if (end_date) body.end_date = end_date;
-        if (interval) body.interval = interval;
-        return ok(
-          await apiPost(
-            "/api/upgrade/v2/coin-treasuries/history/accumulated",
-            body
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_latest_coin_treasury_entities",
-    "Get latest coin treasury entity data",
-    {
-      coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
-      ...maxItemsParam
-    },
-    async ({ coin, _max_items }) => {
-      try {
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/coin-treasuries/latest/entities",
-            { coin }
-          ),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_latest_coin_treasury_history",
-    "Get latest coin treasury history data",
-    {
-      coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
-      ...maxItemsParam
-    },
-    async ({ coin, _max_items }) => {
-      try {
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/coin-treasuries/latest/history",
-            { coin }
-          ),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_coin_treasury_summary",
-    "Get coin treasury data summary",
-    {
-      coin: z4.string().describe("Coin ticker, e.g. BTC, ETH")
-    },
-    async ({ coin }) => {
-      try {
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/coin-treasuries/summary",
-            { coin }
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_latest_depth",
-    "Get latest order book depth snapshot from Redis",
-    {
-      dbKey: z4.string().describe(
-        "Trading pair key, e.g. btcusdt:binance, ethusdt:okex"
-      ),
-      size: z4.string().optional().describe(
-        "Number of depth levels, 1-500, default 50"
-      )
-    },
-    async ({ dbKey, size }) => {
-      try {
-        const params = {
-          dbKey
-        };
-        if (size) params.size = size;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/futures/latest-depth",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_full_depth",
-    "Get full order book depth data for futures",
-    {
-      dbKey: z4.string().describe(
-        "Trading pair key, e.g. btcswapusd:hbdm, btcswapusdt:binance"
-      ),
-      ...maxItemsParam
-    },
-    async ({ dbKey, _max_items }) => {
-      try {
-        return okDepth(
-          await apiGet(
-            "/api/upgrade/v2/futures/full-depth",
-            { dbKey }
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_full_depth_grouped",
-    "Get full depth data grouped by price interval",
-    {
-      dbKey: z4.string().describe(
-        "Trading pair key, e.g. btcswapusd:hbdm, btcswapusdt:binance"
-      ),
-      groupSize: z4.string().describe(
-        "Price grouping interval, e.g. 100, 500, 1000"
-      ),
-      ...maxItemsParam
-    },
-    async ({ dbKey, groupSize, _max_items }) => {
-      try {
-        return okDepth(
-          await apiGet(
-            "/api/upgrade/v2/futures/full-depth/grouped",
-            { dbKey, groupSize }
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-}
-
-// src/tools/features.ts
-import { z as z5 } from "zod";
-function registerFeatureTools(server2) {
-  server2.tool(
-    "get_ls_ratio",
-    "Get long/short ratio data",
-    {},
-    async () => {
-      try {
-        return ok(
-          await apiGet("/api/v2/mix/ls-ratio")
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_liquidation_data",
-    "Get liquidation/forced-close data",
-    {
-      currency: z5.string().optional().describe("Currency: cny or usd, default cny"),
-      type: z5.string().optional().describe(
-        "Query type: 1=by coin, 2=by platform"
-      ),
-      coinKey: z5.string().optional().describe("Coin key, used when type=1"),
-      marketKey: z5.string().optional().describe("Market key, used when type=2")
-    },
-    async ({ currency, type, coinKey, marketKey }) => {
-      try {
-        const params = {};
-        if (currency) params.currency = currency;
-        if (type) params.type = type;
-        if (coinKey) params.coinKey = coinKey;
-        if (marketKey) params.marketKey = marketKey;
-        return ok(
-          await apiGet("/api/v2/mix/liq", params)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_big_orders",
-    "Get whale/large order tracking data",
-    {
-      symbol: z5.string().describe(
-        "Trading pair, e.g. btcusdt:okex"
-      ),
-      ...maxItemsParam
-    },
-    async ({ symbol, _max_items }) => {
-      try {
-        return okList(
-          await apiGet("/api/v2/order/bigOrder", {
-            symbol
-          }),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_agg_trades",
-    "Get aggregated large trades data",
-    {
-      symbol: z5.string().describe(
-        "Trading pair, e.g. btcusdt:okex"
-      ),
-      ...maxItemsParam
-    },
-    async ({ symbol, _max_items }) => {
-      try {
-        return okList(
-          await apiGet("/api/v2/order/aggTrade", {
-            symbol
-          }),
-          parseMax(_max_items, 30)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_trading_pair_ticker",
-    "Get ticker data for specific trading pairs",
-    {
-      key_list: z5.string().describe(
-        "Trading pair keys, comma-separated, max 100, e.g. btcusdt:okex,btcusdt:huobipro"
-      )
-    },
-    async ({ key_list }) => {
-      try {
-        return ok(
-          await apiGet("/api/v2/trading-pair/ticker", {
-            key_list
-          })
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_strategy_signal",
-    "Get indicator win-rate signal data",
-    {
-      coin_type: z5.string().optional().describe("Coin type, e.g. bitcoin"),
-      signal_key: z5.string().optional().describe(
-        "Signal key: depth_win_one,depth_win_two,depth_buy_one,order_buy_one,td_buy_one,lsur_one"
-      ),
-      latest_time: z5.string().optional().describe("Latest time in ms timestamp"),
-      ...maxItemsParam
-    },
-    async ({ coin_type, signal_key, latest_time, _max_items }) => {
-      try {
-        const params = {};
-        if (coin_type) params.coin_type = coin_type;
-        if (signal_key) params.signal_key = signal_key;
-        if (latest_time)
-          params.latest_time = latest_time;
-        return okList(
-          await apiGet(
-            "/api/v2/signal/strategySignal",
-            params
-          ),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_nav",
-    "Get navigation bar data (market overview)",
-    {
-      lan: z5.string().optional().describe("Language: cn or en")
-    },
-    async ({ lan }) => {
-      try {
-        const params = {};
-        if (lan) params.lan = lan;
-        return ok(
-          await apiGet("/api/v2/mix/nav", params)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_grayscale_trust",
-    "Get Grayscale trust fund data",
-    {},
-    async () => {
-      try {
-        return ok(
-          await apiGet("/api/v2/mix/grayscale-trust")
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_gray_scale",
-    "Get Grayscale holdings data",
-    {
-      coins: z5.string().describe(
-        "Coin list, comma-separated: btc,ltc,eth,bch,xrp,xlm,zec,zen,etc"
-      )
-    },
-    async ({ coins }) => {
-      try {
-        return ok(
-          await apiGet("/api/v2/mix/gray-scale", {
-            coins
-          })
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_stock_market",
-    "Get stock market data (crypto-related)",
-    { ...maxItemsParam },
-    async ({ _max_items }) => {
-      try {
-        return okList(
-          await apiGet("/api/v2/mix/stock-market"),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_signal_alert",
-    "Get signal alert data",
-    { ...maxItemsParam },
-    async ({ _max_items }) => {
-      try {
-        return okList(
-          await apiGet(
-            "/api/v2/signal/signalAlert"
-          ),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_signal_alert_config",
-    "Get signal alert configuration options",
-    {
-      lan: z5.string().optional().describe("Language: cn or en"),
-      ...maxItemsParam
-    },
-    async ({ lan, _max_items }) => {
-      try {
-        const params = {};
-        if (lan) params.lan = lan;
-        return okList(
-          await apiGet(
-            "/api/v2/signal/signalAlertConf",
-            params
-          ),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "delete_signal_alert",
-    "Delete a signal alert by ID",
-    {
-      id: z5.string().describe("Signal alert ID")
-    },
-    async ({ id }) => {
-      try {
-        return ok(
-          await apiGet(
-            "/api/v2/signal/delSignalAlert",
-            { id }
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "add_signal_alert",
-    "Add a new signal alert",
-    {
-      subType: z5.string().describe("Alert sub type"),
-      symbol: z5.string().describe("Trading pair symbol"),
-      remark: z5.string().optional().describe("Alert remark/note")
-    },
-    async ({ subType, symbol, remark }) => {
-      try {
-        const params = {
-          subType,
-          symbol
-        };
-        if (remark) params.remark = remark;
-        return ok(
-          await apiGet(
-            "/api/v2/signal/addSignalAlert",
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_signal_alert_list",
-    "Get signal alert settings list",
-    {},
-    async () => {
-      try {
-        return ok(
-          await apiGet(
-            "/api/v2/signal/getSignalAlertSetList"
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_change_signal",
-    "Get abnormal movement signal data",
-    {
-      type: z5.string().optional().describe(
-        "Signal type: 1-12, 17, 18, 23, 24"
-      ),
-      currency: z5.string().optional().describe("Currency: usd (default) or cny"),
-      ...maxItemsParam
-    },
-    async ({ type, currency, _max_items }) => {
-      try {
-        const params = {};
-        if (type) params.type = type;
-        if (currency) params.currency = currency;
-        return okList(
-          await apiGet(
-            "/api/v2/signal/changeSignal",
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_trading_pair",
-    "Get trading pair info for a platform",
-    {
-      market: z5.string().describe(
-        "Platform key (from get_markets), e.g. okex, binance"
-      ),
-      ...maxItemsParam
-    },
-    async ({ market, _max_items }) => {
-      try {
-        return okList(
-          await apiGet(
-            "/api/v2/trading-pair/getTradingPair",
-            { market }
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "get_trading_pairs",
-    "Get trading pair list for a platform",
-    {
-      market: z5.string().describe(
-        "Platform key (from /v2/market), e.g. okex, binance"
-      ),
-      currency: z5.string().optional().describe("Quote currency filter"),
-      show: z5.string().optional().describe("Coin symbol filter"),
-      ...maxItemsParam
-    },
-    async ({ market, currency, show, _max_items }) => {
-      try {
-        const params = {
-          market
-        };
-        if (currency) params.currency = currency;
-        if (show) params.show = show;
-        return okList(
-          await apiGet("/api/v2/trading-pair", params),
-          parseMax(_max_items, 100)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-}
-
-// src/tools/hyperliquid.ts
-import { z as z6 } from "zod";
-function registerHyperliquidTools(server2) {
-  server2.tool(
-    "hl_get_tickers",
-    "Get Hyperliquid ticker data (truncated to top 50, use hl_get_ticker_by_coin for specific coin)",
-    { ...maxItemsParam },
-    async ({ _max_items }) => {
-      try {
-        return okList(
-          await apiGet("/api/upgrade/v2/hl/tickers"),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_ticker_by_coin",
-    "Get Hyperliquid ticker for a specific coin",
-    {
-      coin: z6.string().describe("Coin symbol, e.g. BTC, ETH")
-    },
-    async ({ coin }) => {
-      try {
-        return ok(
-          await apiGet(`/api/upgrade/v2/hl/tickers/coin/${coin}`)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_whale_positions",
-    "Get Hyperliquid whale open positions",
-    {
-      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
-      min_usd: z6.string().optional().describe("Min position size in USD"),
-      ...maxItemsParam
-    },
-    async ({ coin, min_usd, _max_items }) => {
-      try {
-        const params = {};
-        if (coin) params.coin = coin;
-        if (min_usd) params.min_usd = min_usd;
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/hl/whales/open-positions",
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_liquidations",
-    "Get Hyperliquid liquidation history",
-    {
-      coin: z6.string().optional().describe("Coin filter"),
-      ...maxItemsParam
-    },
-    async ({ coin, _max_items }) => {
-      try {
-        const params = {};
-        if (coin) params.coin = coin;
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/hl/liquidations/history",
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_trader_stats",
-    "Get Hyperliquid trader statistics by address",
-    {
-      address: z6.string().describe("Wallet address, e.g. 0x..."),
-      period: z6.string().optional().describe("Period in days, e.g. 7, 30")
-    },
-    async ({ address, period }) => {
-      try {
-        const params = {};
-        if (period) params.period = period;
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/addr-stat`,
-            params
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_info",
-    "Generic Hyperliquid Info API (supports all info types)",
-    {
-      type: z6.string().describe(
-        "Info type, e.g. metaAndAssetCtxs, clearinghouseState, spotMeta, allMids, l2Book, openOrders, userFills, candleSnapshot"
-      ),
-      user: z6.string().optional().describe("User wallet address (for user-specific queries)"),
-      extra_params: z6.string().optional().describe('Extra params as JSON string, e.g. {"coin":"BTC"}'),
-      ...maxItemsParam
-    },
-    async ({ type, user, extra_params, _max_items }) => {
-      try {
-        const body = { type };
-        if (user) body.user = user;
-        if (extra_params) {
-          Object.assign(body, JSON.parse(extra_params));
-        }
-        return okList(
-          await apiPost("/api/upgrade/v2/hl/info", body),
-          parseMax(_max_items, 20)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_fills_by_address",
-    "Get Hyperliquid user trade fills by wallet address",
-    {
-      address: z6.string().describe("Wallet address, e.g. 0x..."),
-      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
-      limit: z6.string().optional().describe("Max results"),
-      ...maxItemsParam
-    },
-    async ({ address, coin, limit, _max_items }) => {
-      try {
-        const params = {};
-        if (coin) params.coin = coin;
-        if (limit) params.limit = limit;
-        return okList(
-          await apiGet(
-            `/api/upgrade/v2/hl/fills/${address}`,
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_fills_by_oid",
-    "Get Hyperliquid trade fills by order ID",
-    {
-      oid: z6.string().describe("Order ID")
-    },
-    async ({ oid }) => {
-      try {
-        return ok(
-          await apiGet(`/api/upgrade/v2/hl/fills/oid/${oid}`)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_fills_by_twapid",
-    "Get Hyperliquid trade fills by TWAP ID",
-    {
-      twapid: z6.string().describe("TWAP ID")
-    },
-    async ({ twapid }) => {
-      try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/fills/twapid/${twapid}`
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_top_trades",
-    "Get Hyperliquid top trades",
-    {
-      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
-      interval: z6.string().optional().describe("Interval, e.g. 4h, 1d"),
-      limit: z6.string().optional().describe("Max results"),
-      ...maxItemsParam
-    },
-    async ({ coin, interval, limit, _max_items }) => {
-      try {
-        const params = {};
-        if (coin) params.coin = coin;
-        if (interval) params.interval = interval;
-        if (limit) params.limit = limit;
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/hl/fills/top-trades",
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_filled_orders",
-    "Get filled orders by wallet address",
-    {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
-      limit: z6.string().optional().describe("Max results, default 1000"),
-      ...maxItemsParam
-    },
-    async ({ address, coin, limit, _max_items }) => {
-      try {
-        const params = {};
-        if (coin) params.coin = coin;
-        if (limit) params.limit = limit;
-        return okList(
-          await apiGet(
-            `/api/upgrade/v2/hl/filled-orders/${address}/latest`,
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_filled_order_by_oid",
-    "Get filled order by order ID",
-    {
-      oid: z6.string().describe("Order ID")
-    },
-    async ({ oid }) => {
-      try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/filled-orders/oid/${oid}`
-          )
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_orders",
-    "Get latest orders by wallet address",
-    {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
-      limit: z6.string().optional().describe("Max results, default 2000"),
-      ...maxItemsParam
-    },
-    async ({ address, coin, limit, _max_items }) => {
-      try {
-        const params = {};
-        if (coin) params.coin = coin;
-        if (limit) params.limit = limit;
-        return okList(
-          await apiGet(
-            `/api/upgrade/v2/hl/orders/${address}/latest`,
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_order_by_oid",
-    "Get order by order ID",
-    {
-      oid: z6.string().describe("Order ID")
-    },
-    async ({ oid }) => {
-      try {
-        return ok(
-          await apiGet(`/api/upgrade/v2/hl/orders/oid/${oid}`)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_top_open_orders",
-    "Get top open orders on Hyperliquid",
-    {
-      coin: z6.string().optional().describe("Coin filter"),
-      min_val: z6.string().optional().describe("Min order value filter"),
-      limit: z6.string().optional().describe("Max results"),
-      ...maxItemsParam
+      symbol: z2.string().describe("REQUIRED. Coin symbol in uppercase, e.g. BTC, ETH"),
+      interval: z2.string().describe("REQUIRED. Candle interval: 1m, 2m, 15m, 30m"),
+      margin_type: z2.enum(["stablecoin", "coin"]).default("stablecoin").describe(
+        "stablecoin: stablecoin-margined OI; coin: coin-margined OI"
+      ),
+      limit: z2.string().optional().describe("Number of records, default 100"),
+      start_time: z2.string().optional().describe("Start time in ms"),
+      end_time: z2.string().optional().describe("End time in ms")
     },
-    async ({ coin, min_val, limit, _max_items }) => {
+    async ({ symbol, interval, margin_type, limit, start_time, end_time }) => {
       try {
-        const params = {};
-        if (coin) params.coin = coin;
-        if (min_val) params.min_val = min_val;
-        if (limit) params.limit = limit;
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/hl/orders/top-open-orders",
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
+        const params = { symbol, interval };
+        params.limit = limit ?? "100";
+        if (start_time) params.start_time = start_time;
+        if (end_time) params.end_time = end_time;
+        const path = margin_type === "coin" ? "/api/upgrade/v2/futures/open-interest/aggregated-coin-margin-history" : "/api/upgrade/v2/futures/open-interest/aggregated-stablecoin-history";
+        return ok(await apiGet(path, params));
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_active_stats",
-    "Get active order statistics",
+    "coin_futures_data",
+    "Futures depth & trade data.\n\u2022 historical_depth \u2014 order book history. Requires: key\n\u2022 super_depth \u2014 large orders >$10k. Requires: key\n\u2022 trade_data \u2014 latest trades. Requires: dbkey (NOT key)",
     {
-      coin: z6.string().optional().describe("Coin filter"),
-      whale_threshold: z6.string().optional().describe(
-        "Whale threshold (order value limitPx * sz)"
-      )
+      action: z2.enum(["historical_depth", "super_depth", "trade_data"]).describe(
+        "historical_depth: order book history; super_depth: large order depth; trade_data: latest trade data"
+      ),
+      key: z2.string().optional().describe("REQUIRED for historical_depth, super_depth. Trading pair key, e.g. btcswapusdt:okcoinfutures. NOT used by trade_data"),
+      dbkey: z2.string().optional().describe("REQUIRED for trade_data. Trading pair key, e.g. btcswapusdt:okcoinfutures. NOT used by historical_depth/super_depth"),
+      amount: z2.string().optional().describe("For super_depth: USD threshold, default 10000"),
+      limit: z2.string().optional().describe("Number of records, max 1000"),
+      start_time: z2.string().optional().describe("Start time in ms"),
+      end_time: z2.string().optional().describe("End time in ms")
     },
-    async ({ coin, whale_threshold }) => {
+    async ({ action, key, dbkey, amount, limit, start_time, end_time }) => {
       try {
-        const params = {};
-        if (coin) params.coin = coin;
-        if (whale_threshold)
-          params.whale_threshold = whale_threshold;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/hl/orders/active-stats",
-            params
-          )
-        );
+        switch (action) {
+          case "historical_depth": {
+            if (!key) return err("key is required for historical_depth action");
+            const params = { key };
+            params.limit = limit ?? "100";
+            if (start_time) params.start_time = start_time;
+            if (end_time) params.end_time = end_time;
+            return ok(await apiGet("/api/upgrade/v2/futures/historical-depth", params));
+          }
+          case "super_depth": {
+            if (!key) return err("key is required for super_depth action");
+            const params = { key };
+            params.amount = amount ?? "10000";
+            params.limit = limit ?? "100";
+            if (start_time) params.start_time = start_time;
+            if (end_time) params.end_time = end_time;
+            return ok(await apiGet("/api/upgrade/v2/futures/super-depth/history", params));
+          }
+          case "trade_data": {
+            if (!dbkey) return err("dbkey is required for trade_data action");
+            const params = { dbkey };
+            params.limit = limit ?? "100";
+            if (start_time) params.start_time = start_time;
+            if (end_time) params.end_time = end_time;
+            return ok(await apiGet("/api/upgrade/v2/futures/trade-data", params));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
+}
+
+// src/tools/contents.ts
+import { z as z3 } from "zod";
+function registerContentTools(server2) {
   server2.tool(
-    "hl_get_portfolio",
-    "Get account value and PNL curves",
+    "news",
+    "News articles.\n\u2022 list \u2014 paginated news articles\n\u2022 detail \u2014 full article content. Requires: id\n\u2022 rss \u2014 RSS news feed",
     {
-      address: z6.string().describe("Wallet address"),
-      window: z6.string().describe(
-        "Time window: day, week, month, allTime"
+      action: z3.enum(["list", "detail", "rss"]).describe(
+        "list: paginated news articles; detail: full article content; rss: RSS news feed"
       ),
-      ...maxItemsParam
-    },
-    async ({ address, window: win, _max_items }) => {
-      try {
-        return okList(
-          await apiGet(
-            `/api/upgrade/v2/hl/portfolio/${address}/${win}`
-          ),
-          parseMax(_max_items, 30)
-        );
+      id: z3.string().optional().describe("REQUIRED for detail. News article ID"),
+      page: z3.string().optional().describe("For list/rss: page number, default 1"),
+      pageSize: z3.string().optional().describe("For list/rss: page size, max 20")
+    },
+    async ({ action, id, page, pageSize }) => {
+      try {
+        switch (action) {
+          case "list": {
+            const params = {};
+            if (page) params.page = page;
+            params.pageSize = pageSize ?? "20";
+            return ok(await apiGet("/api/v2/content/news-list", params));
+          }
+          case "detail": {
+            if (!id) return err("id is required for detail action");
+            return ok(await apiGet("/api/v2/content/news-detail", { id }));
+          }
+          case "rss": {
+            const params = {};
+            if (page) params.page = page;
+            params.pageSize = pageSize ?? "20";
+            return ok(await apiGet("/api/v2/content/square/market/news-list", params));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_pnls",
-    "Get PNL curve data by address",
+    "flash",
+    "Flash news.\n\u2022 newsflash \u2014 AiCoin flash news\n\u2022 list \u2014 industry flash with classification\n\u2022 exchange_listing \u2014 coin listing/delisting announcements",
     {
-      address: z6.string().describe("Wallet address"),
-      period: z6.string().optional().describe(
-        "Period in days: 0(allTime), 1, 7, 30"
+      action: z3.enum(["newsflash", "list", "exchange_listing"]).describe(
+        "newsflash: AiCoin flash news; list: industry flash with types; exchange_listing: coin listing/delisting"
+      ),
+      language: z3.string().optional().describe("Language: cn, tc, en"),
+      createtime: z3.string().optional().describe("For list: filter by create time"),
+      memberIds: z3.string().optional().describe(
+        "For exchange_listing: exchange member IDs, comma-separated. 477=Binance, 1509=Bitget. Default: 477,1509"
       ),
+      pageSize: z3.string().optional().describe("For exchange_listing: page size, default 20"),
       ...maxItemsParam
     },
-    async ({ address, period, _max_items }) => {
+    async ({ action, language, createtime, memberIds, pageSize, _max_items }) => {
       try {
-        const params = {};
-        if (period) params.period = period;
-        return okList(
-          await apiGet(
-            `/api/upgrade/v2/hl/pnls/${address}`,
-            params
-          ),
-          parseMax(_max_items, 100)
-        );
+        switch (action) {
+          case "newsflash": {
+            const params = {};
+            if (language) params.language = language;
+            return ok(await apiGet("/api/v2/content/newsflash", params));
+          }
+          case "list": {
+            const params = {};
+            if (language) params.language = language;
+            if (createtime) params.createtime = createtime;
+            return okList(
+              await apiGet("/api/v2/content/flashList", params),
+              parseMax(_max_items, 30)
+            );
+          }
+          case "exchange_listing": {
+            const params = {};
+            if (language) params.language = language;
+            if (memberIds) params.memberIds = memberIds;
+            if (pageSize) params.pageSize = pageSize;
+            return ok(await apiGet("/api/v2/content/exchange-listing-flash", params));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
+}
+
+// src/tools/markets.ts
+import { z as z4 } from "zod";
+function registerMarketTools(server2) {
   server2.tool(
-    "hl_get_best_trades",
-    "Get most profitable trades by address",
+    "market_info",
+    "Exchange/market data.\n\u2022 exchanges \u2014 all platforms, no params needed\n\u2022 ticker \u2014 platform tickers. Requires: market_list (NOT key)\n\u2022 hot_coins \u2014 trending by category. Requires: key (category key, NOT exchange name)\n\u2022 futures_interest \u2014 futures OI rankings, no required params",
     {
-      address: z6.string().describe("Wallet address"),
-      period: z6.string().describe("Period in days, e.g. 7, 30, 90"),
-      limit: z6.string().optional().describe("Max results, default 10")
+      action: z4.enum(["exchanges", "ticker", "hot_coins", "futures_interest"]).describe(
+        "exchanges: all supported platforms; ticker: platform ticker data; hot_coins: trending coins; futures_interest: futures open interest"
+      ),
+      market_list: z4.string().optional().describe('REQUIRED for ticker. Comma-separated exchange keys, e.g. "okex,binance". NOT used by hot_coins'),
+      key: z4.string().optional().describe("REQUIRED for hot_coins. Category key: gamefi, anonymous, market, web, newcoin, stable, defi. This is a category key, NOT an exchange name"),
+      currency: z4.string().optional().describe("Currency: cny or usd"),
+      lan: z4.string().optional().describe("For futures_interest: language cn or en"),
+      page: z4.string().optional().describe("For futures_interest: page number"),
+      pageSize: z4.string().optional().describe("For futures_interest: page size, max 20"),
+      ...maxItemsParam
     },
-    async ({ address, period, limit }) => {
+    async ({ action, market_list, key, currency, lan, page, pageSize, _max_items }) => {
       try {
-        const params = {
-          period
-        };
-        if (limit) params.limit = limit;
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/best-trades`,
-            params
-          )
-        );
+        switch (action) {
+          case "exchanges":
+            return ok(await apiGet("/api/v2/market"));
+          case "ticker": {
+            if (!market_list) return err("market_list is required for ticker action");
+            return ok(await apiGet("/api/v2/market/ticker", { market_list }));
+          }
+          case "hot_coins": {
+            if (!key) return err("key is required for hot_coins action");
+            const params = { key };
+            if (currency) params.currency = currency;
+            return okList(await apiGet("/api/v2/market/hotTabCoins", params), parseMax(_max_items, 20));
+          }
+          case "futures_interest": {
+            const params = {};
+            if (lan) params.lan = lan;
+            if (page) params.page = page;
+            if (pageSize) params.pageSize = pageSize;
+            if (currency) params.currency = currency;
+            return ok(await apiGet("/api/v2/futures/interest", params));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_performance_by_coin",
-    "Get per-coin trading performance stats",
+    "kline",
+    "K-line (candlestick) data.\n\u2022 data \u2014 standard K-line. Requires: symbol\n\u2022 indicator \u2014 indicator K-line. Requires: symbol + indicator_key\n\u2022 trading_pair \u2014 available pairs for indicator. Optional: coinType, indicator_key",
     {
-      address: z6.string().describe("Wallet address"),
-      period: z6.string().describe("Period in days, e.g. 7, 30, 90"),
-      limit: z6.string().optional().describe("Max results, default 10")
+      action: z4.enum(["data", "indicator", "trading_pair"]).describe(
+        "data: standard K-line data; indicator: indicator K-line data; trading_pair: available pairs for indicator K-line"
+      ),
+      symbol: z4.string().optional().describe("REQUIRED for data, indicator. Trading pair with exchange, e.g. btcusdt:okex or btcswapusdt:binance"),
+      indicator_key: z4.string().optional().describe("REQUIRED for indicator. Optional for trading_pair. Indicator key: fundflow, aiaggtrade, fr, etc."),
+      coinType: z4.string().optional().describe("Optional for trading_pair. Coin type, e.g. bitcoin"),
+      period: z4.string().optional().describe("Period in seconds: 900=15min, 3600=1h, 14400=4h, 86400=1d"),
+      size: z4.string().optional().describe("Number of candles, 1-500"),
+      since: z4.string().optional().describe("Start timestamp"),
+      open_time: z4.string().optional().describe("Open time offset: 0 or 8")
     },
-    async ({ address, period, limit }) => {
-      try {
-        const params = {
-          period
-        };
-        if (limit) params.limit = limit;
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/performance-by-coin`,
-            params
-          )
-        );
+    async ({ action, symbol, indicator_key, coinType, period, size, since, open_time }) => {
+      try {
+        switch (action) {
+          case "data": {
+            if (!symbol) return err("symbol is required for data action");
+            const params = { symbol };
+            if (period) params.period = period;
+            params.size = size ?? "100";
+            if (since) params.since = since;
+            if (open_time) params.open_time = open_time;
+            return ok(await apiGet("/api/v2/commonKline/dataRecords", params));
+          }
+          case "indicator": {
+            if (!symbol || !indicator_key) return err("symbol and indicator_key are required for indicator action");
+            const params = { symbol, indicator_key };
+            if (period) params.period = period;
+            params.size = size ?? "100";
+            if (since) params.since = since;
+            if (open_time) params.open_time = open_time;
+            return ok(await apiGet("/api/v2/indicatorKline/dataRecords", params));
+          }
+          case "trading_pair": {
+            const params = {};
+            if (coinType) params.coinType = coinType;
+            if (indicator_key) params.indicator_key = indicator_key;
+            return ok(await apiGet("/api/v2/indicatorKline/getTradingPair", params));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_completed_trades",
-    "Get completed trades list by address",
+    "index_data",
+    "Index data.\n\u2022 price \u2014 index price. Requires: key\n\u2022 info \u2014 index detail. Requires: key\n\u2022 list \u2014 all available indexes, no params needed",
     {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
-      limit: z6.string().optional().describe("Max results, default 100"),
+      action: z4.enum(["price", "info", "list"]).describe(
+        "price: index price data; info: index detail; list: all available indexes"
+      ),
+      key: z4.string().optional().describe('REQUIRED for price, info. Index key in "i:symbol:exchange" format, e.g. "i:diniw:ice". Use list action to discover available keys'),
+      currency: z4.string().optional().describe("For price: currency cny or usd"),
+      lan: z4.string().optional().describe("For info: language en or cn"),
       ...maxItemsParam
     },
-    async ({ address, coin, limit, _max_items }) => {
+    async ({ action, key, currency, lan, _max_items }) => {
       try {
-        const params = {};
-        if (coin) params.coin = coin;
-        if (limit) params.limit = limit;
-        return okList(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/completed-trades`,
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
+        switch (action) {
+          case "price": {
+            if (!key) return err("key is required for price action");
+            const params = { key };
+            if (currency) params.currency = currency;
+            return ok(await apiGet("/api/v2/index/indexPrice", params));
+          }
+          case "info": {
+            if (!key) return err("key is required for info action");
+            const params = { key };
+            if (lan) params.lan = lan;
+            return ok(await apiGet("/api/v2/index/indexInfo", params));
+          }
+          case "list":
+            return okList(await apiGet("/api/v2/index/getIndex"), parseMax(_max_items, 20));
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_current_position_history",
-    "Get current position history for a coin",
+    "crypto_stock",
+    'Crypto-related stocks.\n\u2022 quotes \u2014 stock prices. Optional: tickers\n\u2022 top_gainer \u2014 top gainers. Optional: us_stock, hk_stock\n\u2022 company \u2014 company details. Requires: symbol (in "i:ticker:market" format)',
     {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().describe("Coin, e.g. BTC")
-    },
-    async ({ address, coin }) => {
-      try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/current-position-history/${coin}`
-          )
-        );
+      action: z4.enum(["quotes", "top_gainer", "company"]).describe(
+        "quotes: stock quotes (MSTR,COIN); top_gainer: top gaining stocks; company: company details"
+      ),
+      tickers: z4.string().optional().describe('Optional for quotes. Comma-separated stock tickers in "i:ticker:market" format, e.g. "i:mstr:nasdaq,i:coin:nasdaq"'),
+      symbol: z4.string().optional().describe('REQUIRED for company. Stock symbol in "i:ticker:market" format, e.g. "i:mstr:nasdaq"'),
+      us_stock: z4.boolean().optional().describe("For top_gainer: include US stocks"),
+      hk_stock: z4.boolean().optional().describe("For top_gainer: include HK stocks"),
+      limit: z4.number().optional().describe("For top_gainer: number of results, default 30")
+    },
+    async ({ action, tickers, symbol, us_stock, hk_stock, limit }) => {
+      try {
+        switch (action) {
+          case "quotes": {
+            const params = {};
+            if (tickers) params.tickers = tickers;
+            return ok(await apiGet("/api/upgrade/v2/crypto_stock/quotes", params));
+          }
+          case "top_gainer": {
+            const params = {};
+            if (us_stock != null) params.us_stock = String(us_stock);
+            if (hk_stock != null) params.hk_stock = String(hk_stock);
+            params.limit = String(limit ?? 30);
+            return ok(await apiGet("/api/upgrade/v2/crypto_stock/top-gainer", params));
+          }
+          case "company": {
+            if (!symbol) return err("symbol is required for company action");
+            return ok(await apiGet(`/api/upgrade/v2/crypto_stock/company/${symbol}`));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_completed_position_history",
-    "Get completed position history for a coin",
+    "coin_treasury",
+    "Coin treasury data (corporate holdings). Requires: coin for all actions.\n\u2022 entities \u2014 treasury entities\n\u2022 history \u2014 trade history\n\u2022 accumulated \u2014 accumulated holdings over time\n\u2022 latest_entities / latest_history \u2014 latest data\n\u2022 summary \u2014 overview stats",
     {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().describe("Coin, e.g. BTC"),
-      startTime: z6.string().optional().describe(
-        "Start time in ms, at least one of startTime/endTime required"
+      action: z4.enum(["entities", "history", "accumulated", "latest_entities", "latest_history", "summary"]).describe(
+        "entities: treasury entity data; history: trade history; accumulated: accumulated data; latest_entities/latest_history: latest data; summary: overview"
       ),
-      endTime: z6.string().optional().describe(
-        "End time in ms, at least one of startTime/endTime required"
-      )
+      coin: z4.string().describe("REQUIRED for all actions. Coin ticker in uppercase, e.g. BTC, ETH"),
+      entity_type: z4.string().optional().describe("Entity type filter"),
+      name: z4.string().optional().describe("Entity name filter"),
+      ticker: z4.string().optional().describe("For entities: stock ticker filter"),
+      type: z4.string().optional().describe("For history: trade type Buy or Sell"),
+      start_date: z4.string().optional().describe("Start date, ISO 8601"),
+      end_date: z4.string().optional().describe("End date, ISO 8601"),
+      interval: z4.string().optional().describe("For accumulated: daily, weekly, or monthly"),
+      page: z4.string().optional().describe("Page number, default 1"),
+      page_size: z4.string().optional().describe("Page size, default 20"),
+      sort_by: z4.string().optional().describe("For history: sort field, default date"),
+      sort_order: z4.string().optional().describe("Sort: asc or desc, default desc"),
+      ...maxItemsParam
     },
-    async ({ address, coin, startTime, endTime }) => {
-      try {
-        const params = {};
-        if (startTime) params.startTime = startTime;
-        if (endTime) params.endTime = endTime;
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/completed-position-history/${coin}`,
-            params
-          )
-        );
+    async ({ action, coin, entity_type, name, ticker, type, start_date, end_date, interval, page, page_size, sort_by, sort_order, _max_items }) => {
+      try {
+        switch (action) {
+          case "entities": {
+            const body = { coin };
+            if (entity_type) body.entity_type = entity_type;
+            if (name) body.name = name;
+            if (ticker) body.ticker = ticker;
+            if (start_date) body.start_date = start_date;
+            if (end_date) body.end_date = end_date;
+            if (page) body.page = Number(page);
+            if (page_size) body.page_size = Number(page_size);
+            if (sort_order) body.sort_order = sort_order;
+            return ok(await apiPost("/api/upgrade/v2/coin-treasuries/entities", body));
+          }
+          case "history": {
+            const body = { coin };
+            if (name) body.name = name;
+            if (type) body.type = type;
+            if (start_date) body.start_date = start_date;
+            if (end_date) body.end_date = end_date;
+            if (page) body.page = Number(page);
+            if (page_size) body.page_size = Number(page_size);
+            if (sort_by) body.sort_by = sort_by;
+            if (sort_order) body.sort_order = sort_order;
+            return ok(await apiPost("/api/upgrade/v2/coin-treasuries/history", body));
+          }
+          case "accumulated": {
+            const body = { coin };
+            if (entity_type) body.entity_type = entity_type;
+            if (start_date) body.start_date = start_date;
+            if (end_date) body.end_date = end_date;
+            if (interval) body.interval = interval;
+            return ok(await apiPost("/api/upgrade/v2/coin-treasuries/history/accumulated", body));
+          }
+          case "latest_entities":
+            return okList(
+              await apiGet("/api/upgrade/v2/coin-treasuries/latest/entities", { coin }),
+              parseMax(_max_items, 20)
+            );
+          case "latest_history":
+            return okList(
+              await apiGet("/api/upgrade/v2/coin-treasuries/latest/history", { coin }),
+              parseMax(_max_items, 20)
+            );
+          case "summary":
+            return ok(await apiGet("/api/upgrade/v2/coin-treasuries/summary", { coin }));
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_current_position_pnl",
-    "Get current position PnL for a coin",
+    "depth",
+    "Order book depth. Requires: dbKey for all actions.\n\u2022 latest \u2014 real-time snapshot\n\u2022 full \u2014 complete order book\n\u2022 grouped \u2014 grouped by price interval. Requires: groupSize",
     {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().describe("Coin, e.g. BTC"),
-      interval: z6.string().describe("Interval, e.g. 1h, 4h, 1d")
+      action: z4.enum(["latest", "full", "grouped"]).describe(
+        "latest: real-time snapshot; full: complete order book; grouped: grouped by price interval"
+      ),
+      dbKey: z4.string().describe("REQUIRED for all actions. Trading pair key, e.g. btcswapusdt:binance"),
+      size: z4.string().optional().describe("Optional for latest. Depth levels 1-500, default 50"),
+      groupSize: z4.string().optional().describe('REQUIRED for grouped. Price grouping interval, e.g. "100", "500", "1000"'),
+      ...maxItemsParam
     },
-    async ({ address, coin, interval }) => {
+    async ({ action, dbKey, size, groupSize, _max_items }) => {
       try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/current-position-pnl/${coin}`,
-            { interval }
-          )
-        );
+        switch (action) {
+          case "latest": {
+            const params = { dbKey };
+            if (size) params.size = size;
+            return ok(await apiGet("/api/upgrade/v2/futures/latest-depth", params));
+          }
+          case "full":
+            return okDepth(
+              await apiGet("/api/upgrade/v2/futures/full-depth", { dbKey }),
+              parseMax(_max_items, 50)
+            );
+          case "grouped": {
+            if (!groupSize) return err("groupSize is required for grouped action");
+            return okDepth(
+              await apiGet("/api/upgrade/v2/futures/full-depth/grouped", { dbKey, groupSize }),
+              parseMax(_max_items, 50)
+            );
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
+}
+
+// src/tools/features.ts
+import { z as z5 } from "zod";
+function registerFeatureTools(server2) {
   server2.tool(
-    "hl_get_completed_position_pnl",
-    "Get completed position PnL for a coin",
+    "market_overview",
+    "Market overview data.\n\u2022 nav \u2014 market overview/navigation\n\u2022 ls_ratio \u2014 long/short ratio, no params needed\n\u2022 liquidation \u2014 forced-close data\n\u2022 grayscale_trust \u2014 trust fund, no params needed\n\u2022 gray_scale \u2014 grayscale holdings. Requires: coins\n\u2022 stock_market \u2014 crypto stocks, no params needed",
     {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().describe("Coin, e.g. BTC"),
-      interval: z6.string().describe("Interval, e.g. 1h, 4h, 1d"),
-      startTime: z6.string().optional().describe(
-        "Start time in ms, at least one of startTime/endTime required"
+      action: z5.enum(["nav", "ls_ratio", "liquidation", "grayscale_trust", "gray_scale", "stock_market"]).describe(
+        "nav: market overview; ls_ratio: long/short ratio; liquidation: forced-close data; grayscale_trust: trust fund; gray_scale: holdings; stock_market: crypto stocks"
       ),
-      endTime: z6.string().optional().describe(
-        "End time in ms, at least one of startTime/endTime required"
-      )
+      lan: z5.string().optional().describe('Optional for nav. Language: "cn" or "en"'),
+      currency: z5.string().optional().describe('Optional for liquidation. Currency: "cny" or "usd"'),
+      type: z5.string().optional().describe('Optional for liquidation. Group by: "1"=by coin, "2"=by platform'),
+      coinKey: z5.string().optional().describe('Optional for liquidation. Coin key filter (when type="1")'),
+      marketKey: z5.string().optional().describe('Optional for liquidation. Market key filter (when type="2")'),
+      coins: z5.string().optional().describe('REQUIRED for gray_scale. Comma-separated coin symbols in lowercase, e.g. "btc,eth"'),
+      ...maxItemsParam
     },
-    async ({ address, coin, interval, startTime, endTime }) => {
+    async ({ action, lan, currency, type, coinKey, marketKey, coins, _max_items }) => {
       try {
-        const params = { interval };
-        if (startTime) params.startTime = startTime;
-        if (endTime) params.endTime = endTime;
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/completed-position-pnl/${coin}`,
-            params
-          )
-        );
+        switch (action) {
+          case "nav": {
+            const params = {};
+            if (lan) params.lan = lan;
+            return ok(await apiGet("/api/v2/mix/nav", params));
+          }
+          case "ls_ratio":
+            return ok(await apiGet("/api/v2/mix/ls-ratio"));
+          case "liquidation": {
+            const params = {};
+            if (currency) params.currency = currency;
+            if (type) params.type = type;
+            if (coinKey) params.coinKey = coinKey;
+            if (marketKey) params.marketKey = marketKey;
+            return ok(await apiGet("/api/v2/mix/liq", params));
+          }
+          case "grayscale_trust":
+            return ok(await apiGet("/api/v2/mix/grayscale-trust"));
+          case "gray_scale": {
+            if (!coins) return err("coins is required for gray_scale action");
+            return ok(await apiGet("/api/v2/mix/gray-scale", { coins }));
+          }
+          case "stock_market":
+            return okList(await apiGet("/api/v2/mix/stock-market"), parseMax(_max_items, 50));
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_current_position_executions",
-    "Get current position execution trace",
+    "order_flow",
+    "Order flow data. Requires: symbol for all actions.\n\u2022 big_orders \u2014 whale/large order tracking\n\u2022 agg_trades \u2014 aggregated large trades",
     {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().describe("Coin, e.g. BTC"),
-      interval: z6.string().describe("Interval, e.g. 1h, 4h, 1d")
+      action: z5.enum(["big_orders", "agg_trades"]).describe(
+        "big_orders: whale/large order tracking; agg_trades: aggregated large trades"
+      ),
+      symbol: z5.string().describe("REQUIRED. Trading pair with exchange, e.g. btcswapusdt:binance"),
+      ...maxItemsParam
     },
-    async ({ address, coin, interval }) => {
+    async ({ action, symbol, _max_items }) => {
       try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/current-position-executions/${coin}`,
-            { interval }
-          )
-        );
+        switch (action) {
+          case "big_orders":
+            return okList(await apiGet("/api/v2/order/bigOrder", { symbol }), parseMax(_max_items, 20));
+          case "agg_trades":
+            return okList(await apiGet("/api/v2/order/aggTrade", { symbol }), parseMax(_max_items, 30));
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_completed_position_executions",
-    "Get completed position execution trace",
+    "trading_pair",
+    "Trading pair data.\n\u2022 ticker \u2014 specific pair tickers. Requires: key_list\n\u2022 by_market \u2014 all pairs for a platform. Requires: market\n\u2022 list \u2014 pairs with filters. Requires: market",
     {
-      address: z6.string().describe("Wallet address"),
-      coin: z6.string().describe("Coin, e.g. BTC"),
-      interval: z6.string().describe("Interval, e.g. 1h, 4h, 1d"),
-      startTime: z6.string().optional().describe(
-        "Start time in ms, at least one of startTime/endTime required"
+      action: z5.enum(["ticker", "by_market", "list"]).describe(
+        "ticker: specific pair tickers; by_market: pairs for a platform; list: pairs with filters"
       ),
-      endTime: z6.string().optional().describe(
-        "End time in ms, at least one of startTime/endTime required"
-      )
+      key_list: z5.string().optional().describe('REQUIRED for ticker. Comma-separated pair keys, e.g. "btcusdt:okex,btcusdt:huobipro"'),
+      market: z5.string().optional().describe("REQUIRED for by_market, list. Platform/exchange key, e.g. okex, binance"),
+      currency: z5.string().optional().describe("For list: quote currency filter"),
+      show: z5.string().optional().describe("For list: coin symbol filter"),
+      ...maxItemsParam
     },
-    async ({ address, coin, interval, startTime, endTime }) => {
+    async ({ action, key_list, market, currency, show, _max_items }) => {
       try {
-        const params = { interval };
-        if (startTime) params.startTime = startTime;
-        if (endTime) params.endTime = endTime;
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/completed-position-executions/${coin}`,
-            params
-          )
-        );
+        switch (action) {
+          case "ticker": {
+            if (!key_list) return err("key_list is required for ticker action");
+            return ok(await apiGet("/api/v2/trading-pair/ticker", { key_list }));
+          }
+          case "by_market": {
+            if (!market) return err("market is required for by_market action");
+            return okList(
+              await apiGet("/api/v2/trading-pair/getTradingPair", { market }),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "list": {
+            if (!market) return err("market is required for list action");
+            const params = { market };
+            if (currency) params.currency = currency;
+            if (show) params.show = show;
+            return okList(await apiGet("/api/v2/trading-pair", params), parseMax(_max_items, 100));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_traders_accounts",
-    "Batch query trader account info",
+    "signal_data",
+    "Signal data.\n\u2022 strategy \u2014 indicator win-rate signals\n\u2022 alert \u2014 current signal alerts\n\u2022 config \u2014 alert configurations\n\u2022 alert_list \u2014 user alert settings\n\u2022 change \u2014 abnormal price movements",
     {
-      addresses: z6.string().describe("Addresses as JSON array string")
+      action: z5.enum(["strategy", "alert", "config", "alert_list", "change"]).describe(
+        "strategy: indicator win-rate signals; alert: signal alert data; config: alert configurations; alert_list: alert settings; change: abnormal movement"
+      ),
+      coin_type: z5.string().optional().describe("Optional for strategy. Coin type, e.g. bitcoin"),
+      signal_key: z5.string().optional().describe("Optional for strategy. Signal key: depth_win_one, td_buy_one, etc."),
+      latest_time: z5.string().optional().describe("Optional for strategy. Latest time filter in ms"),
+      lan: z5.string().optional().describe('Optional for config. Language: "cn" or "en"'),
+      type: z5.string().optional().describe("Optional for change. Signal type: 1-12, 17, 18, 23, 24"),
+      currency: z5.string().optional().describe('Optional for change. Currency: "usd" or "cny"'),
+      ...maxItemsParam
     },
-    async ({ addresses }) => {
+    async ({ action, coin_type, signal_key, latest_time, lan, type, currency, _max_items }) => {
       try {
-        return ok(
-          await apiPost("/api/upgrade/v2/hl/traders/accounts", {
-            addresses: JSON.parse(addresses)
-          })
-        );
+        switch (action) {
+          case "strategy": {
+            const params = {};
+            if (coin_type) params.coin_type = coin_type;
+            if (signal_key) params.signal_key = signal_key;
+            if (latest_time) params.latest_time = latest_time;
+            return okList(await apiGet("/api/v2/signal/strategySignal", params), parseMax(_max_items, 20));
+          }
+          case "alert":
+            return okList(await apiGet("/api/v2/signal/signalAlert"), parseMax(_max_items, 20));
+          case "config": {
+            const params = {};
+            if (lan) params.lan = lan;
+            return okList(await apiGet("/api/v2/signal/signalAlertConf", params), parseMax(_max_items, 20));
+          }
+          case "alert_list":
+            return ok(await apiGet("/api/v2/signal/getSignalAlertSetList"));
+          case "change": {
+            const params = {};
+            if (type) params.type = type;
+            if (currency) params.currency = currency;
+            return okList(await apiGet("/api/v2/signal/changeSignal", params), parseMax(_max_items, 50));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_traders_statistics",
-    "Batch query trader statistics",
+    "signal_manage",
+    "Delete a signal alert. Requires: id",
     {
-      addresses: z6.string().describe("Addresses as JSON array string")
+      id: z5.string().describe("REQUIRED. Signal alert ID to delete")
     },
-    async ({ addresses }) => {
+    async ({ id }) => {
       try {
-        return ok(
-          await apiPost(
-            "/api/upgrade/v2/hl/traders/statistics",
-            { addresses: JSON.parse(addresses) }
-          )
-        );
+        return ok(await apiGet("/api/v2/signal/delSignalAlert", { id }));
       } catch (e) {
         return err(e);
       }
     }
   );
+}
+
+// src/tools/hyperliquid.ts
+import { z as z6 } from "zod";
+function registerHyperliquidTools(server2) {
   server2.tool(
-    "hl_get_whale_events",
-    "Get latest whale position events",
+    "hl_ticker",
+    "Hyperliquid tickers. If coin provided, returns single ticker; otherwise returns all tickers.",
     {
-      coin: z6.string().optional().describe("Coin filter"),
+      coin: z6.string().optional().describe("Optional. Coin symbol in uppercase, e.g. BTC, ETH. Omit to get all tickers"),
       ...maxItemsParam
     },
     async ({ coin, _max_items }) => {
       try {
-        const params = {};
-        if (coin) params.coin = coin;
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/hl/whales/latest-events",
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
+        if (coin) {
+          return ok(await apiGet(`/api/upgrade/v2/hl/tickers/coin/${coin}`));
+        }
+        return okList(await apiGet("/api/upgrade/v2/hl/tickers"), parseMax(_max_items, 50));
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_whale_directions",
-    "Get whale position long/short counts",
+    "hl_whale",
+    "Hyperliquid whale data. All actions support optional coin filter.\n\u2022 positions \u2014 whale open positions\n\u2022 events \u2014 latest whale events\n\u2022 directions \u2014 long/short counts\n\u2022 history_ratio \u2014 historical long ratio",
     {
-      coin: z6.string().optional().describe("Coin filter")
+      action: z6.enum(["positions", "events", "directions", "history_ratio"]).describe(
+        "positions: whale open positions; events: latest whale events; directions: long/short counts; history_ratio: historical long ratio"
+      ),
+      coin: z6.string().optional().describe("Optional. Coin filter in uppercase, e.g. BTC"),
+      min_usd: z6.string().optional().describe("Optional for positions. Min position size in USD"),
+      ...maxItemsParam
     },
-    async ({ coin }) => {
+    async ({ action, coin, min_usd, _max_items }) => {
       try {
         const params = {};
         if (coin) params.coin = coin;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/hl/whales/directions",
-            params
-          )
-        );
+        switch (action) {
+          case "positions": {
+            if (min_usd) params.min_usd = min_usd;
+            return okList(
+              await apiGet("/api/upgrade/v2/hl/whales/open-positions", params),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "events":
+            return okList(
+              await apiGet("/api/upgrade/v2/hl/whales/latest-events", params),
+              parseMax(_max_items, 50)
+            );
+          case "directions":
+            return ok(await apiGet("/api/upgrade/v2/hl/whales/directions", params));
+          case "history_ratio":
+            return okList(
+              await apiGet("/api/upgrade/v2/hl/whales/history-long-ratio", params),
+              parseMax(_max_items, 30)
+            );
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_whale_history_long_ratio",
-    "Get historical whale long/short ratio",
+    "hl_liquidation",
+    "Hyperliquid liquidation data. All actions support optional coin filter.\n\u2022 history \u2014 liquidation history\n\u2022 stats \u2014 aggregate stats\n\u2022 stats_by_coin \u2014 per-coin stats\n\u2022 top_positions \u2014 top liquidated positions",
     {
-      coin: z6.string().optional().describe("Coin filter"),
+      action: z6.enum(["history", "stats", "stats_by_coin", "top_positions"]).describe(
+        "history: liquidation history; stats: aggregate stats; stats_by_coin: per-coin stats; top_positions: top liquidated"
+      ),
+      coin: z6.string().optional().describe("Optional. Coin filter in uppercase, e.g. BTC"),
       ...maxItemsParam
     },
-    async ({ coin, _max_items }) => {
+    async ({ action, coin, _max_items }) => {
       try {
         const params = {};
         if (coin) params.coin = coin;
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/hl/whales/history-long-ratio",
-            params
-          ),
-          parseMax(_max_items, 30)
-        );
-      } catch (e) {
-        return err(e);
-      }
-    }
-  );
-  server2.tool(
-    "hl_get_liquidation_stats",
-    "Get Hyperliquid liquidation statistics",
-    {},
-    async () => {
-      try {
-        return ok(
-          await apiGet("/api/upgrade/v2/hl/liquidations/stat")
-        );
+        switch (action) {
+          case "history":
+            return okList(
+              await apiGet("/api/upgrade/v2/hl/liquidations/history", params),
+              parseMax(_max_items, 50)
+            );
+          case "stats":
+            return ok(await apiGet("/api/upgrade/v2/hl/liquidations/stat"));
+          case "stats_by_coin":
+            return ok(await apiGet("/api/upgrade/v2/hl/liquidations/stat-by-coin", params));
+          case "top_positions":
+            return okList(
+              await apiGet("/api/upgrade/v2/hl/liquidations/top-positions", params),
+              parseMax(_max_items, 50)
+            );
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_liquidation_stats_by_coin",
-    "Get liquidation statistics by coin",
+    "hl_open_interest",
+    "Hyperliquid open interest.\n\u2022 summary \u2014 overall OI summary, no params needed\n\u2022 top_coins \u2014 top coins ranked by OI\n\u2022 history \u2014 per-coin OI history. Requires: coin",
     {
-      coin: z6.string().optional().describe("Coin filter")
+      action: z6.enum(["summary", "top_coins", "history"]).describe(
+        "summary: overall OI summary; top_coins: top coins by OI; history: per-coin OI history"
+      ),
+      coin: z6.string().optional().describe("REQUIRED for history. Coin in uppercase, e.g. BTC"),
+      interval: z6.string().optional().describe("Optional for history. Time window: 4h, 1d, etc."),
+      limit: z6.string().optional().describe("Optional for top_coins. Number of coins to return"),
+      ...maxItemsParam
     },
-    async ({ coin }) => {
-      try {
-        const params = {};
-        if (coin) params.coin = coin;
-        return ok(
-          await apiGet(
-            "/api/upgrade/v2/hl/liquidations/stat-by-coin",
-            params
-          )
-        );
+    async ({ action, coin, interval, limit, _max_items }) => {
+      try {
+        switch (action) {
+          case "summary":
+            return ok(await apiGet("/api/upgrade/v2/hl/open-interest/summary"));
+          case "top_coins": {
+            const params = {};
+            if (limit) params.limit = limit;
+            return okList(
+              await apiGet("/api/upgrade/v2/hl/open-interest/top-coins", params),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "history": {
+            if (!coin) return err("coin is required for history action");
+            const params = {};
+            if (interval) params.interval = interval;
+            return okList(
+              await apiGet(`/api/upgrade/v2/hl/open-interest/history/${coin}`, params),
+              parseMax(_max_items, 50)
+            );
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_liquidation_top_positions",
-    "Get top liquidated positions",
+    "hl_taker",
+    "Hyperliquid taker data. Requires: coin for all actions.\n\u2022 delta \u2014 accumulated taker buy/sell delta\n\u2022 klines \u2014 K-lines with taker volume",
     {
-      coin: z6.string().optional().describe("Coin filter"),
+      action: z6.enum(["delta", "klines"]).describe(
+        "delta: accumulated taker buy/sell delta; klines: K-lines with taker volume"
+      ),
+      coin: z6.string().describe("REQUIRED. Coin in uppercase, e.g. BTC, ETH"),
+      interval: z6.string().optional().describe("Optional. Time window: 15m, 4h, 1d. Default 4h for klines"),
       ...maxItemsParam
     },
-    async ({ coin, _max_items }) => {
+    async ({ action, coin, interval, _max_items }) => {
       try {
         const params = {};
-        if (coin) params.coin = coin;
-        return okList(
-          await apiGet(
-            "/api/upgrade/v2/hl/liquidations/top-positions",
-            params
-          ),
-          parseMax(_max_items, 50)
-        );
+        if (interval) params.interval = interval;
+        switch (action) {
+          case "delta":
+            return ok(await apiGet(`/api/upgrade/v2/hl/accumulated-taker-delta/${coin}`, params));
+          case "klines":
+            return okList(
+              await apiGet(`/api/upgrade/v2/hl/klines-with-taker-vol/${coin}/${interval || "4h"}`),
+              parseMax(_max_items, 30)
+            );
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_smart_find",
-    "Discover smart money addresses on Hyperliquid",
+    "hl_trader",
+    "Hyperliquid trader analytics.\n\u2022 stats \u2014 trader stats. Requires: address\n\u2022 best_trades \u2014 most profitable trades. Requires: address + period\n\u2022 performance \u2014 per-coin performance. Requires: address + period\n\u2022 completed_trades \u2014 completed trade list. Requires: address\n\u2022 accounts \u2014 batch account info. Requires: addresses (JSON array string)\n\u2022 statistics \u2014 batch stats. Requires: addresses (JSON array string)",
     {
-      params_json: z6.string().describe("Search params as JSON string"),
+      action: z6.enum(["stats", "best_trades", "performance", "completed_trades", "accounts", "statistics"]).describe(
+        "stats: trader stats; best_trades: most profitable; performance: per-coin performance; completed_trades: completed list; accounts: batch account info; statistics: batch stats"
+      ),
+      address: z6.string().optional().describe("REQUIRED for stats, best_trades, performance, completed_trades. Single wallet address (0x...)"),
+      addresses: z6.string().optional().describe(`REQUIRED for accounts, statistics. Must be a JSON array string, e.g. '["0xabc...","0xdef..."]'. NOT comma-separated`),
+      period: z6.string().optional().describe("REQUIRED for best_trades, performance. Optional for stats. Period in days: 7, 30, 90"),
+      coin: z6.string().optional().describe("Optional for completed_trades. Coin filter in uppercase, e.g. BTC"),
+      limit: z6.string().optional().describe("Max results"),
       ...maxItemsParam
     },
-    async ({ params_json, _max_items }) => {
+    async ({ action, address, addresses, period, coin, limit, _max_items }) => {
       try {
-        return okList(
-          await apiPost(
-            "/api/upgrade/v2/hl/smart/find",
-            JSON.parse(params_json)
-          ),
-          parseMax(_max_items, 20)
-        );
+        switch (action) {
+          case "stats": {
+            if (!address) return err("address is required for stats action");
+            const params = {};
+            if (period) params.period = period;
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/addr-stat`, params));
+          }
+          case "best_trades": {
+            if (!address || !period) return err("address and period are required for best_trades action");
+            const params = { period };
+            if (limit) params.limit = limit;
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/best-trades`, params));
+          }
+          case "performance": {
+            if (!address || !period) return err("address and period are required for performance action");
+            const params = { period };
+            if (limit) params.limit = limit;
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/performance-by-coin`, params));
+          }
+          case "completed_trades": {
+            if (!address) return err("address is required for completed_trades action");
+            const params = {};
+            if (coin) params.coin = coin;
+            if (limit) params.limit = limit;
+            return okList(
+              await apiGet(`/api/upgrade/v2/hl/traders/${address}/completed-trades`, params),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "accounts": {
+            if (!addresses) return err("addresses is required for accounts action");
+            return ok(await apiPost("/api/upgrade/v2/hl/traders/accounts", {
+              addresses: JSON.parse(addresses)
+            }));
+          }
+          case "statistics": {
+            if (!addresses) return err("addresses is required for statistics action");
+            return ok(await apiPost("/api/upgrade/v2/hl/traders/statistics", {
+              addresses: JSON.parse(addresses)
+            }));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_discover_traders",
-    "Discover traders by criteria",
+    "hl_fills",
+    "Hyperliquid trade fills.\n\u2022 by_address \u2014 fills by wallet. Requires: address\n\u2022 by_oid \u2014 fills by order ID. Requires: oid\n\u2022 by_twapid \u2014 fills by TWAP ID. Requires: twapid\n\u2022 top_trades \u2014 top trades, no required params",
     {
-      params_json: z6.string().describe("Discovery params as JSON string"),
+      action: z6.enum(["by_address", "by_oid", "by_twapid", "top_trades"]).describe(
+        "by_address: fills by wallet; by_oid: fills by order ID; by_twapid: fills by TWAP ID; top_trades: top trades"
+      ),
+      address: z6.string().optional().describe("REQUIRED for by_address. Wallet address (0x...)"),
+      oid: z6.string().optional().describe("REQUIRED for by_oid. Order ID"),
+      twapid: z6.string().optional().describe("REQUIRED for by_twapid. TWAP ID"),
+      coin: z6.string().optional().describe("Optional. Coin filter in uppercase, e.g. BTC"),
+      interval: z6.string().optional().describe("Optional for top_trades. Interval: 4h, 1d"),
+      limit: z6.string().optional().describe("Max results"),
       ...maxItemsParam
     },
-    async ({ params_json, _max_items }) => {
-      try {
-        return okList(
-          await apiPost(
-            "/api/upgrade/v2/hl/traders/discover",
-            JSON.parse(params_json)
-          ),
-          parseMax(_max_items, 20)
-        );
+    async ({ action, address, oid, twapid, coin, interval, limit, _max_items }) => {
+      try {
+        switch (action) {
+          case "by_address": {
+            if (!address) return err("address is required for by_address action");
+            const params = {};
+            if (coin) params.coin = coin;
+            if (limit) params.limit = limit;
+            return okList(
+              await apiGet(`/api/upgrade/v2/hl/fills/${address}`, params),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "by_oid": {
+            if (!oid) return err("oid is required for by_oid action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/fills/oid/${oid}`));
+          }
+          case "by_twapid": {
+            if (!twapid) return err("twapid is required for by_twapid action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/fills/twapid/${twapid}`));
+          }
+          case "top_trades": {
+            const params = {};
+            if (coin) params.coin = coin;
+            if (interval) params.interval = interval;
+            if (limit) params.limit = limit;
+            return okList(
+              await apiGet("/api/upgrade/v2/hl/fills/top-trades", params),
+              parseMax(_max_items, 50)
+            );
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_twap_states",
-    "Get TWAP order states by address",
+    "hl_orders",
+    "Hyperliquid orders.\n\u2022 latest \u2014 latest orders. Requires: address\n\u2022 by_oid \u2014 single order. Requires: oid\n\u2022 filled \u2014 filled orders. Requires: address\n\u2022 filled_by_oid \u2014 filled order. Requires: oid\n\u2022 top_open \u2014 top open orders\n\u2022 active_stats \u2014 active order stats\n\u2022 twap_states \u2014 TWAP states. Requires: address",
     {
-      address: z6.string().describe("Wallet address")
+      action: z6.enum(["latest", "by_oid", "filled", "filled_by_oid", "top_open", "active_stats", "twap_states"]).describe(
+        "latest: latest orders by address; by_oid: order by ID; filled: filled orders; filled_by_oid: filled order by ID; top_open: top open orders; active_stats: active order stats; twap_states: TWAP states"
+      ),
+      address: z6.string().optional().describe("REQUIRED for latest, filled, twap_states. Wallet address (0x...)"),
+      oid: z6.string().optional().describe("REQUIRED for by_oid, filled_by_oid. Order ID"),
+      coin: z6.string().optional().describe("Optional. Coin filter in uppercase"),
+      min_val: z6.string().optional().describe("Optional for top_open. Min order value in USD"),
+      whale_threshold: z6.string().optional().describe("Optional for active_stats. Whale threshold in USD"),
+      limit: z6.string().optional().describe("Max results"),
+      ...maxItemsParam
     },
-    async ({ address }) => {
-      try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/twap-states/${address}/latest`
-          )
-        );
+    async ({ action, address, oid, coin, min_val, whale_threshold, limit, _max_items }) => {
+      try {
+        switch (action) {
+          case "latest": {
+            if (!address) return err("address is required for latest action");
+            const params = {};
+            if (coin) params.coin = coin;
+            if (limit) params.limit = limit;
+            return okList(
+              await apiGet(`/api/upgrade/v2/hl/orders/${address}/latest`, params),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "by_oid": {
+            if (!oid) return err("oid is required for by_oid action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/orders/oid/${oid}`));
+          }
+          case "filled": {
+            if (!address) return err("address is required for filled action");
+            const params = {};
+            if (coin) params.coin = coin;
+            if (limit) params.limit = limit;
+            return okList(
+              await apiGet(`/api/upgrade/v2/hl/filled-orders/${address}/latest`, params),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "filled_by_oid": {
+            if (!oid) return err("oid is required for filled_by_oid action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/filled-orders/oid/${oid}`));
+          }
+          case "top_open": {
+            const params = {};
+            if (coin) params.coin = coin;
+            if (min_val) params.min_val = min_val;
+            if (limit) params.limit = limit;
+            return okList(
+              await apiGet("/api/upgrade/v2/hl/orders/top-open-orders", params),
+              parseMax(_max_items, 50)
+            );
+          }
+          case "active_stats": {
+            const params = {};
+            if (coin) params.coin = coin;
+            if (whale_threshold) params.whale_threshold = whale_threshold;
+            return ok(await apiGet("/api/upgrade/v2/hl/orders/active-stats", params));
+          }
+          case "twap_states": {
+            if (!address) return err("address is required for twap_states action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/twap-states/${address}/latest`));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_max_drawdown",
-    "Get max drawdown data by address",
+    "hl_position",
+    "Hyperliquid position data. Requires: address + coin for all actions.\n\u2022 current_history \u2014 current position history\n\u2022 completed_history \u2014 closed position history. Optional: startTime, endTime\n\u2022 current_pnl \u2014 current PnL. Requires: interval\n\u2022 completed_pnl \u2014 closed PnL. Requires: interval. Optional: startTime, endTime\n\u2022 current_executions \u2014 current execution trace. Requires: interval\n\u2022 completed_executions \u2014 closed execution trace. Requires: interval. Optional: startTime, endTime",
     {
-      address: z6.string().describe("Wallet address"),
-      days: z6.string().describe("Number of days, e.g. 7, 30, 90")
-    },
-    async ({ address, days }) => {
-      try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/max-drawdown/${address}`,
-            { days }
-          )
-        );
+      action: z6.enum(["current_history", "completed_history", "current_pnl", "completed_pnl", "current_executions", "completed_executions"]).describe(
+        "current_history: current position history; completed_history: closed position history; current_pnl/completed_pnl: PnL data; current_executions/completed_executions: execution trace"
+      ),
+      address: z6.string().describe("REQUIRED. Wallet address (0x...)"),
+      coin: z6.string().describe("REQUIRED. Coin in uppercase, e.g. BTC"),
+      interval: z6.string().optional().describe("REQUIRED for current_pnl, completed_pnl, current_executions, completed_executions. Interval: 1h, 4h, 1d"),
+      startTime: z6.string().optional().describe("Optional for completed_* actions. Start time in ms"),
+      endTime: z6.string().optional().describe("Optional for completed_* actions. End time in ms")
+    },
+    async ({ action, address, coin, interval, startTime, endTime }) => {
+      try {
+        switch (action) {
+          case "current_history":
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/current-position-history/${coin}`));
+          case "completed_history": {
+            const params = {};
+            if (startTime) params.startTime = startTime;
+            if (endTime) params.endTime = endTime;
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/completed-position-history/${coin}`, params));
+          }
+          case "current_pnl": {
+            if (!interval) return err("interval is required for current_pnl action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/current-position-pnl/${coin}`, { interval }));
+          }
+          case "completed_pnl": {
+            if (!interval) return err("interval is required for completed_pnl action");
+            const params = { interval };
+            if (startTime) params.startTime = startTime;
+            if (endTime) params.endTime = endTime;
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/completed-position-pnl/${coin}`, params));
+          }
+          case "current_executions": {
+            if (!interval) return err("interval is required for current_executions action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/current-position-executions/${coin}`, { interval }));
+          }
+          case "completed_executions": {
+            if (!interval) return err("interval is required for completed_executions action");
+            const params = { interval };
+            if (startTime) params.startTime = startTime;
+            if (endTime) params.endTime = endTime;
+            return ok(await apiGet(`/api/upgrade/v2/hl/traders/${address}/completed-position-executions/${coin}`, params));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_net_flow",
-    "Get ledger net flow by address",
+    "hl_portfolio",
+    "Hyperliquid portfolio data. Requires: address for all actions.\n\u2022 portfolio \u2014 account value curve. Requires: window (NOT days)\n\u2022 pnls \u2014 PNL curve. Optional: period\n\u2022 max_drawdown \u2014 max drawdown. Requires: days (NOT window)\n\u2022 net_flow \u2014 ledger net flow. Requires: days (NOT window)",
     {
-      address: z6.string().describe("Wallet address"),
-      days: z6.string().describe("Number of days, e.g. 7, 30, 90")
+      action: z6.enum(["portfolio", "pnls", "max_drawdown", "net_flow"]).describe(
+        "portfolio: account value curve; pnls: PNL curve; max_drawdown: max drawdown; net_flow: ledger net flow"
+      ),
+      address: z6.string().describe("REQUIRED. Wallet address (0x...)"),
+      window: z6.string().optional().describe('REQUIRED for portfolio ONLY. Time window: "day", "week", "month", "allTime". NOT used by max_drawdown/net_flow'),
+      period: z6.string().optional().describe("Optional for pnls. Period in days: 0=allTime, 1, 7, 30"),
+      days: z6.string().optional().describe("REQUIRED for max_drawdown, net_flow. Number of days: 7, 30, 90. NOT used by portfolio"),
+      ...maxItemsParam
     },
-    async ({ address, days }) => {
+    async ({ action, address, window: win, period, days, _max_items }) => {
       try {
-        return ok(
-          await apiGet(
-            `/api/upgrade/v2/hl/ledger-updates/net-flow/${address}`,
-            { days }
-          )
-        );
+        switch (action) {
+          case "portfolio": {
+            if (!win) return err("window is required for portfolio action");
+            return okList(
+              await apiGet(`/api/upgrade/v2/hl/portfolio/${address}/${win}`),
+              parseMax(_max_items, 30)
+            );
+          }
+          case "pnls": {
+            const params = {};
+            if (period) params.period = period;
+            return okList(
+              await apiGet(`/api/upgrade/v2/hl/pnls/${address}`, params),
+              parseMax(_max_items, 100)
+            );
+          }
+          case "max_drawdown": {
+            if (!days) return err("days is required for max_drawdown action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/max-drawdown/${address}`, { days }));
+          }
+          case "net_flow": {
+            if (!days) return err("days is required for net_flow action");
+            return ok(await apiGet(`/api/upgrade/v2/hl/ledger-updates/net-flow/${address}`, { days }));
+          }
+        }
       } catch (e) {
         return err(e);
       }
     }
   );
   server2.tool(
-    "hl_get_klines_with_taker_vol",
-    "Get K-line data with taker volume",
+    "hl_advanced",
+    "Hyperliquid advanced.\n\u2022 info \u2014 generic Hyperliquid Info API. Requires: type\n\u2022 smart_find \u2014 smart money discovery. Optional: params_json\n\u2022 discover \u2014 trader discovery. Optional: params_json",
     {
-      coin: z6.string().describe("Coin, e.g. BTC"),
-      interval: z6.string().describe("Interval, e.g. 1h, 4h, 1d"),
+      action: z6.enum(["info", "smart_find", "discover"]).describe(
+        "info: generic Hyperliquid Info API; smart_find: smart money addresses; discover: trader discovery"
+      ),
+      type: z6.string().optional().describe("REQUIRED for info. Info type: metaAndAssetCtxs, clearinghouseState, allMids, etc."),
+      user: z6.string().optional().describe("Optional for info. User wallet address (0x...)"),
+      extra_params: z6.string().optional().describe("Optional for info. Extra params as JSON string"),
+      params_json: z6.string().optional().describe("Optional for smart_find, discover. Search params as JSON string"),
       ...maxItemsParam
     },
-    async ({ coin, interval, _max_items }) => {
+    async ({ action, type, user, extra_params, params_json, _max_items }) => {
       try {
-        return okList(
-          await apiGet(
-            `/api/upgrade/v2/hl/klines-with-taker-vol/${coin}/${interval}`
-          ),
-          parseMax(_max_items, 30)
-        );
+        switch (action) {
+          case "info": {
+            if (!type) return err("type is required for info action");
+            const body = { type };
+            if (user) body.user = user;
+            if (extra_params) Object.assign(body, JSON.parse(extra_params));
+            return okList(await apiPost("/api/upgrade/v2/hl/info", body), parseMax(_max_items, 20));
+          }
+          case "smart_find":
+            return okList(
+              await apiPost("/api/upgrade/v2/hl/smart/find", JSON.parse(params_json || "{}")),
+              parseMax(_max_items, 20)
+            );
+          case "discover":
+            return okList(
+              await apiPost("/api/upgrade/v2/hl/traders/discover", JSON.parse(params_json || "{}")),
+              parseMax(_max_items, 20)
+            );
+        }
       } catch (e) {
         return err(e);
       }
@@ -2744,11 +1559,27 @@ function registerHyperliquidTools(server2) {
 import { z as z7 } from "zod";
 function registerGuideTools(server2) {
   server2.tool(
-    "guide_get_api_key",
-    "Guide user to register AiCoin account and generate OpenAPI key. Call this when API returns 401/403 or credentials are missing.",
-    {},
-    async () => {
-      const guide = `# AiCoin OpenAPI Key Setup Guide
+    "guide",
+    "Setup guides. Actions: api_key (get AiCoin API key), upgrade (tier comparison)",
+    {
+      action: z7.enum(["api_key", "upgrade"]).describe(
+        "api_key: register & get API key; upgrade: tier comparison & upgrade"
+      ),
+      current_error: z7.string().optional().describe("For upgrade: the error message received"),
+      endpoint: z7.string().optional().describe("For upgrade: the endpoint that returned 403")
+    },
+    async ({ action, current_error, endpoint }) => {
+      switch (action) {
+        case "api_key":
+          return { content: [{ type: "text", text: getApiKeyGuide() }] };
+        case "upgrade":
+          return { content: [{ type: "text", text: getUpgradeGuide(current_error, endpoint) }] };
+      }
+    }
+  );
+}
+function getApiKeyGuide() {
+  return `# AiCoin OpenAPI Key Setup Guide
 
 ## Step 1: Register / Login
 Visit https://www.aicoin.com and create an account (or log in).
@@ -2788,24 +1619,19 @@ Add them to your MCP client config:
 }
 \`\`\`
 
-After updating the config, restart your MCP client to apply.`;
-      return {
-        content: [{ type: "text", text: guide }]
-      };
-    }
-  );
-  server2.tool(
-    "guide_upgrade_tier",
-    "Guide user to upgrade API tier when current tier lacks permission for certain endpoints. Call this when API returns 403 or feature is tier-restricted.",
-    {
-      current_error: z7.string().optional().describe("The error message received"),
-      endpoint: z7.string().optional().describe("The endpoint that returned 403")
-    },
-    async ({ current_error, endpoint }) => {
-      const guide = `# AiCoin API Tier Upgrade Guide
+After updating the config, restart your MCP client to apply.
+
+## Want Trading Features?
+For exchange trading (place orders, check balances), use the full AiCoin MCP:
+\`\`\`
+npx -y @aicoin/aicoin-mcp
+\`\`\``;
+}
+function getUpgradeGuide(currentError, endpoint) {
+  return `# AiCoin API Tier Upgrade Guide
 
 ## Current Issue
-${current_error ? `Error: ${current_error}` : "Your current API tier does not have permission for this endpoint."}
+${currentError ? `Error: ${currentError}` : "Your current API tier does not have permission for this endpoint."}
 ${endpoint ? `Endpoint: ${endpoint}` : ""}
 
 ## API Tier Comparison
@@ -2831,103 +1657,6 @@ ${endpoint ? `Endpoint: ${endpoint}` : ""}
 5. Complete payment
 
 After upgrading, your existing key will be automatically upgraded. No config changes needed.`;
-      return {
-        content: [{ type: "text", text: guide }]
-      };
-    }
-  );
-  server2.tool(
-    "guide_setup_ccxt_trade",
-    "Guide user to set up the AiCoin Trade MCP server (CCXT-based) for executing trades. Includes exchange API key setup and local proxy configuration.",
-    {
-      exchange: z7.string().optional().describe(
-        "Target exchange: binance, okx, bybit, bitget, gate, huobi, pionex, hyperliquid"
-      )
-    },
-    async ({ exchange }) => {
-      const ex = exchange?.toLowerCase() || "binance";
-      const needsPass = ex === "okx" || ex === "bitget";
-      const EX = ex.toUpperCase();
-      let keyBlock = `${EX}_API_KEY=your_api_key
-${EX}_SECRET=your_secret`;
-      if (needsPass) keyBlock += `
-${EX}_PASSPHRASE=your_passphrase`;
-      let envJson = `        "${EX}_API_KEY": "<your_api_key>",
-        "${EX}_SECRET": "<your_secret>"`;
-      if (needsPass) {
-        envJson += `,
-        "${EX}_PASSPHRASE": "<your_passphrase>"`;
-      }
-      const guide = getTradeGuide(ex, EX, keyBlock, envJson);
-      return {
-        content: [{ type: "text", text: guide }]
-      };
-    }
-  );
-}
-function getExchangeGuide(ex) {
-  const guides = {
-    binance: '1. Log in to https://www.binance.com\n2. Go to Account \u2192 API Management\n3. Create API key, enable "Spot Trading" permission\n4. Recommended: set IP whitelist',
-    okx: '1. Log in to https://www.okx.com\n2. Go to Account \u2192 API \u2192 Create API Key\n3. Set passphrase, enable "Trade" permission\n4. Note: OKX requires a passphrase in addition to key/secret',
-    bybit: '1. Log in to https://www.bybit.com\n2. Go to Account \u2192 API Management\n3. Create API key with "Trade" permission',
-    bitget: '1. Log in to https://www.bitget.com\n2. Go to Account \u2192 API Management\n3. Create API key with passphrase, enable "Trade"\n4. Note: Bitget requires a passphrase',
-    gate: '1. Log in to https://www.gate.io\n2. Go to Account \u2192 API Management\n3. Create API key with "Spot Trade" permission',
-    huobi: '1. Log in to https://www.huobi.com\n2. Go to Account \u2192 API Management\n3. Create API key with "Trade" permission',
-    pionex: "1. Log in to https://www.pionex.com\n2. Go to Account \u2192 API Management\n3. Create API key",
-    hyperliquid: "1. Visit https://app.hyperliquid.xyz\n2. Connect your wallet\n3. Go to API \u2192 Generate API Key"
-  };
-  return guides[ex] || guides.binance;
-}
-function getTradeGuide(ex, EX, keyBlock, envJson) {
-  return `# AiCoin Trade MCP Setup Guide (CCXT)
-
-> All API keys are stored locally only. They are never sent to AiCoin servers.
-
-## Step 1: Get Exchange API Key
-
-${getExchangeGuide(ex)}
-
-\`\`\`
-${keyBlock}
-\`\`\`
-
-## Step 2: Proxy Configuration
-
-Many exchanges require proxy access in certain regions.
-If you are in mainland China or behind a firewall, you likely need a local proxy.
-
-- If YES: set \`USE_PROXY=true\` and \`PROXY_URL\` (default: \`http://127.0.0.1:7890\`)
-- If NO: set \`USE_PROXY=false\` or leave it unset
-
-Common proxy ports:
-- Clash: 7890
-- V2Ray: 10808
-- Shadowsocks: 1080
-
-## Step 3: Configure MCP Client
-
-\`\`\`json
-{
-  "mcpServers": {
-    "aicoin-trade": {
-      "command": "npx",
-      "args": ["-y", "@aicoin/trade-mcp"],
-      "env": {
-        "DEFAULT_EXCHANGE": "${ex}",
-${envJson},
-        "USE_PROXY": "true",
-        "PROXY_URL": "http://127.0.0.1:7890"
-      }
-    }
-  }
-}
-\`\`\`
-
-## Security Notes
-- API keys are stored in your local MCP config only
-- Never share your secret key with anyone
-- Enable IP whitelist on the exchange if possible
-- For trading, enable "Trade" permission; disable "Withdraw"`;
 }
 
 // src/tools/index.ts