hvip-mcp-server 0.1.4 → 0.1.6

package/dist/index.js

@@ -21161,7 +21161,27 @@ var publicApi = {
   getHistoryCandles: (instId, bar, after, before, limit) => request("GET", "/api/v5/market/history-candles", { params: { instId, bar, after, before, limit } }),
   getHistoryTrades: (instId, limit) => request("GET", "/api/v5/market/history-trades", { params: { instId, limit } }),
   getSystemStatus: () => request("GET", "/api/v5/system/status"),
-  getPriceLimitBatch: (instType, uly, instId) => request("GET", "/api/v5/public/price-limit", { params: { instType, uly, instId } })
+  getPriceLimitBatch: (instType, uly, instId) => request("GET", "/api/v5/public/price-limit", { params: { instType, uly, instId } }),
+  getOptSummary: (uly, expTime) => request("GET", "/api/v5/public/opt-summary", { params: { uly, expTime } }),
+  getInsuranceFund: (instType, uly) => request("GET", "/api/v5/public/insurance-fund", { params: { instType, uly } }),
+  convertContractCoin: (instId, sz, unit, opType) => request("GET", "/api/v5/public/convert-contract-coin", { params: { instId, sz, unit, opType } }),
+  getSupportCoin: () => request("GET", "/api/v5/rubik/stat/trading-data/support-coin"),
+  getTopTraderLongShortRatio: (instId, begin, end) => request("GET", "/api/v5/rubik/stat/contracts/long-short-account-ratio-contract-top-trader", { params: { instId, begin, end } }),
+  getOptionPutCallRatio: (ccy, begin, end) => request("GET", "/api/v5/rubik/stat/option/open-interest-volume-ratio", { params: { ccy, begin, end } }),
+  getLendingRateSummary: (ccy) => request("GET", "/api/v5/finance/savings/lending-rate-summary", { params: { ccy } }),
+  // ── 网格交易机器人（公共） ────────────────────────────────────────────────────
+  getGridAiParam: (instId, algoOrdType, direction) => request("GET", "/api/v5/tradingBot/grid/ai-param", { params: { instId, algoOrdType, direction } }),
+  // ── 大宗交易行情（公共） ─────────────────────────────────────────────────────
+  getBlockTickers: (instType) => request("GET", "/api/v5/market/block-tickers", { params: { instType } }),
+  // ── 价差交易（公共） ──────────────────────────────────────────────────────────
+  getSpreads: (sprdId, baseCcy, instId, state) => request("GET", "/api/v5/sprd/spreads", { params: { sprdId, baseCcy, instId, state } }),
+  getSpreadTicker: (sprdId) => request("GET", "/api/v5/sprd/ticker", { params: { sprdId } }),
+  getSpreadOrderbook: (sprdId, sz) => request("GET", "/api/v5/sprd/books", { params: { sprdId, sz } }),
+  getSpreadTrades: (sprdId, limit) => request("GET", "/api/v5/sprd/trades", { params: { sprdId, limit } }),
+  getSpreadCandles: (sprdId, bar, limit) => request("GET", "/api/v5/sprd/candles", { params: { sprdId, bar, limit } }),
+  // ── 公告（公共） ──────────────────────────────────────────────────────────────
+  getAnnouncements: (annType, lang) => request("GET", "/api/v5/support/announcements", { params: { annType, lang } }),
+  getAnnouncementTypes: () => request("GET", "/api/v5/support/announcement-types")
 };
 var privateApi = {
   getBalance: (auth, ccy) => request("GET", "/api/v5/account/balance", { params: { ccy }, auth }),
@@ -21185,6 +21205,16 @@ var privateApi = {
   getDepositAddress: (auth, ccy) => request("GET", "/api/v5/asset/deposit-address", { params: { ccy }, auth }),
   getDepositHistory: (auth, ccy, limit) => request("GET", "/api/v5/asset/deposit-history", { params: { ccy, limit }, auth }),
   getWithdrawalHistory: (auth, ccy, limit) => request("GET", "/api/v5/asset/withdrawal-history", { params: { ccy, limit }, auth }),
+  getEthStakingBalance: (auth) => request("GET", "/api/v5/finance/staking-defi/eth/balance", { auth }),
+  getEthStakingHistory: (auth, limit) => request("GET", "/api/v5/finance/staking-defi/eth/purchase-redeem-history", { params: { limit }, auth }),
+  getSolStakingBalance: (auth) => request("GET", "/api/v5/finance/staking-defi/sol/balance", { auth }),
+  // ── 网格交易机器人（私有） ────────────────────────────────────────────────────
+  getGridOrdersPending: (auth, algoOrdType, instId, instType) => request("GET", "/api/v5/tradingBot/grid/orders-algo-pending", { params: { algoOrdType, instId, instType }, auth }),
+  getGridOrdersHistory: (auth, algoOrdType, instId, instType) => request("GET", "/api/v5/tradingBot/grid/orders-algo-history", { params: { algoOrdType, instId, instType }, auth }),
+  getGridSubOrders: (auth, algoId, algoOrdType, type, groupId) => request("GET", "/api/v5/tradingBot/grid/sub-orders", { params: { algoId, algoOrdType, type, groupId }, auth }),
+  // ── 定投机器人（私有） ────────────────────────────────────────────────────────
+  getRecurringOrdersPending: (auth) => request("GET", "/api/v5/tradingBot/recurring/orders-algo-pending", { auth }),
+  getRecurringOrdersHistory: (auth) => request("GET", "/api/v5/tradingBot/recurring/orders-algo-history", { auth }),
   getAlgoOrders: (auth, ordType, instType) => request("GET", "/api/v5/trade/orders-algo-pending", { params: { ordType, instType }, auth }),
   getAlgoOrdersHistory: (auth, ordType, state, instType) => request("GET", "/api/v5/trade/orders-algo-history", { params: { ordType, state, instType }, auth }),
   placeAlgoOrder: (auth, body) => request("POST", "/api/v5/trade/order-algo", { body, auth }),
@@ -21410,6 +21440,21 @@ function registerMarketTools(server) {
       }
     }
   );
+  server.tool(
+    "okx_get_block_tickers",
+    "\u83B7\u53D6\u5927\u5B97\u4EA4\u6613\uFF08Block Trading\uFF09\u5B9E\u65F6\u884C\u60C5\uFF0C\u542B\u6210\u4EA4\u91CF\u7EDF\u8BA1\u3002\u5927\u5B97\u4EA4\u6613\u4E13\u4E3A\u673A\u6784\u5927\u989D\u4EA4\u6613\u8BBE\u8BA1\uFF0C\u6210\u4EA4\u6570\u636E\u53CD\u6620\u673A\u6784\u8D44\u91D1\u52A8\u5411\u3002",
+    {
+      instType: external_exports.enum(["SPOT", "SWAP", "FUTURES", "OPTION"]).describe("\u4EA7\u54C1\u7C7B\u578B")
+    },
+    async ({ instType }) => {
+      try {
+        const data = await publicApi.getBlockTickers(instType);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/public.ts
@@ -21501,6 +21546,85 @@ function registerPublicTools(server) {
       }
     }
   );
+  server.tool(
+    "okx_get_opt_summary",
+    "\u83B7\u53D6\u671F\u6743\u5E02\u573A\u6458\u8981\u6570\u636E\uFF0C\u542B\u5404\u5230\u671F\u65E5\u7684\u9690\u542B\u6CE2\u52A8\u7387\uFF08IV\uFF09\u3001\u672A\u5E73\u4ED3\u91CF\u548C\u6210\u4EA4\u91CF\u5206\u5E03\u3002\u7528\u4E8E\u671F\u6743\u4EA4\u6613\u524D\u7684\u6574\u4F53\u5E02\u573A\u626B\u63CF\u3002",
+    {
+      uly: external_exports.string().describe("\u6807\u7684\u6307\u6570\uFF0C\u5982 BTC-USD\u3001ETH-USD"),
+      expTime: external_exports.string().optional().describe("\u5230\u671F\u65E5\u7B5B\u9009\uFF0C\u683C\u5F0F YYYYMMDD\uFF0C\u5982 20250101")
+    },
+    async ({ uly, expTime }) => {
+      try {
+        const data = await publicApi.getOptSummary(uly, expTime);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_insurance_fund",
+    "\u83B7\u53D6OKX\u4FDD\u9669\u57FA\u91D1\u4F59\u989D\u53D8\u52A8\u5386\u53F2\u3002\u4FDD\u9669\u57FA\u91D1\u89C4\u6A21\u53CD\u6620\u4EA4\u6613\u6240\u62B5\u5FA1\u6781\u7AEF\u884C\u60C5\u7684\u80FD\u529B\uFF0C\u4E5F\u662F\u8861\u91CF\u5E73\u53F0\u98CE\u9669\u7684\u6307\u6807\u3002",
+    {
+      instType: external_exports.enum(["SWAP", "FUTURES", "OPTION", "MARGIN"]).describe("\u4EA7\u54C1\u7C7B\u578B"),
+      uly: external_exports.string().optional().describe("\u6807\u7684\u6307\u6570\uFF0C\u5982 BTC-USD\uFF08SWAP/FUTURES/OPTION\u5FC5\u586B\uFF09")
+    },
+    async ({ instType, uly }) => {
+      try {
+        const data = await publicApi.getInsuranceFund(instType, uly);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_convert_contract_coin",
+    "\u5408\u7EA6\u5F20\u6570\u4E0E\u5E01\u6570\u4E92\u6362\u8BA1\u7B97\u3002\u4E0B\u5408\u7EA6\u5355\u65F6\u5148\u7528\u6B64\u63A5\u53E3\u6362\u7B97\u5F20\u6570\uFF0C\u907F\u514D\u6570\u91CF\u586B\u9519\u3002",
+    {
+      instId: external_exports.string().describe("\u4EA7\u54C1ID\uFF0C\u5982 BTC-USDT-SWAP"),
+      sz: external_exports.string().describe("\u6570\u91CF\uFF08\u5F20\u6570\u6216\u5E01\u6570\uFF0C\u53D6\u51B3\u4E8Eunit\uFF09"),
+      unit: external_exports.enum(["coin", "usds", "contracts"]).describe("sz\u7684\u5355\u4F4D\uFF1Acoin=\u5E01\uFF0Ccontracts=\u5F20"),
+      opType: external_exports.enum(["open", "close"]).describe("\u5F00\u4ED3\u6216\u5E73\u4ED3")
+    },
+    async ({ instId, sz, unit, opType }) => {
+      try {
+        const data = await publicApi.convertContractCoin(instId, sz, unit, opType);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_announcements",
+    "\u83B7\u53D6OKX\u5B98\u65B9\u516C\u544A\u5217\u8868\uFF08\u7EF4\u62A4\u901A\u77E5\u3001\u65B0\u5E01\u4E0A\u7EBF\u3001\u6D3B\u52A8\u7B49\uFF09\u3002\u5B9A\u671F\u67E5\u8BE2\u53EF\u53CA\u65F6\u4E86\u89E3\u5E73\u53F0\u53D8\u5316\uFF0C\u63D0\u524D\u505A\u597D\u98CE\u9669\u51C6\u5907\u3002",
+    {
+      annType: external_exports.string().optional().describe("\u516C\u544A\u7C7B\u578BID\uFF0C\u4E0D\u586B\u8FD4\u56DE\u5168\u90E8\u3002\u53EF\u5148\u8C03\u7528 okx_get_announcement_types \u67E5\u8BE2\u53EF\u7528\u7C7B\u578B"),
+      lang: external_exports.enum(["zh-Hans", "en-US"]).optional().describe("\u8BED\u8A00\uFF0C\u9ED8\u8BA4\u4E2D\u6587")
+    },
+    async ({ annType, lang }) => {
+      try {
+        const data = await publicApi.getAnnouncements(annType, lang);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_announcement_types",
+    "\u83B7\u53D6OKX\u516C\u544A\u5206\u7C7B\u5217\u8868\uFF08\u5982\u7EF4\u62A4\u901A\u77E5\u3001\u4E0A\u65B0\u516C\u544A\u3001\u6D3B\u52A8\u516C\u544A\u7B49\uFF09\u3002\u7528\u4E8E\u7B5B\u9009\u7279\u5B9A\u7C7B\u578B\u516C\u544A\u3002",
+    {},
+    async () => {
+      try {
+        const data = await publicApi.getAnnouncementTypes();
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/account.ts
@@ -21973,6 +22097,66 @@ function registerStatsTools(server) {
       }
     }
   );
+  server.tool(
+    "okx_get_stats_support_coin",
+    "\u83B7\u53D6\u4EA4\u6613\u5927\u6570\u636E\u6A21\u5757\u652F\u6301\u67E5\u8BE2\u7684\u6240\u6709\u5E01\u79CD\u5217\u8868\u3002\u5728\u8C03\u7528\u5176\u4ED6\u4EA4\u6613\u5927\u6570\u636E\u63A5\u53E3\u524D\uFF0C\u53EF\u5148\u67E5\u8BE2\u6B64\u63A5\u53E3\u786E\u8BA4\u5E01\u79CD\u53EF\u7528\u3002",
+    {},
+    async () => {
+      try {
+        const data = await publicApi.getSupportCoin();
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_top_trader_long_short_ratio",
+    "\u83B7\u53D6\u7CBE\u82F1\u4EA4\u6613\u5458\u591A\u7A7A\u6301\u4ED3\u6BD4\u4F8B\uFF08\u4EC5\u7EDF\u8BA1\u524D5%\u5927\u6237\uFF09\u3002\u5927\u6237\u7684\u4ED3\u4F4D\u6BD4\u6563\u6237\u66F4\u5177\u9884\u6D4B\u4EF7\u503C\uFF0C\u80CC\u79BB\u65F6\u5F80\u5F80\u662F\u9006\u52BF\u4FE1\u53F7\u3002",
+    {
+      instId: external_exports.string().describe("\u5408\u7EA6\u4EA7\u54C1ID\uFF0C\u5982 BTC-USDT-SWAP\u3001ETH-USDT-SWAP"),
+      begin: external_exports.string().optional().describe("\u5F00\u59CB\u65F6\u95F4\u6233\uFF08\u6BEB\u79D2\uFF09"),
+      end: external_exports.string().optional().describe("\u7ED3\u675F\u65F6\u95F4\u6233\uFF08\u6BEB\u79D2\uFF09")
+    },
+    async ({ instId, begin, end }) => {
+      try {
+        const data = await publicApi.getTopTraderLongShortRatio(instId, begin, end);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_put_call_ratio",
+    "\u83B7\u53D6\u671F\u6743Put/Call\u6BD4\uFF08\u672A\u5E73\u4ED3\u91CF\u548C\u6210\u4EA4\u91CF\uFF09\u3002Put/Call > 1 \u8868\u793A\u5E02\u573A\u504F\u5411\u770B\u8DCC\uFF0C\u662F\u8861\u91CF\u671F\u6743\u5E02\u573A\u60C5\u7EEA\u7684\u7ECF\u5178\u6307\u6807\u3002",
+    {
+      ccy: external_exports.string().describe("\u5E01\u79CD\uFF0C\u5982 BTC\u3001ETH"),
+      begin: external_exports.string().optional().describe("\u5F00\u59CB\u65F6\u95F4\u6233\uFF08\u6BEB\u79D2\uFF09"),
+      end: external_exports.string().optional().describe("\u7ED3\u675F\u65F6\u95F4\u6233\uFF08\u6BEB\u79D2\uFF09")
+    },
+    async ({ ccy, begin, end }) => {
+      try {
+        const data = await publicApi.getOptionPutCallRatio(ccy, begin, end);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_lending_rate_summary",
+    "\u83B7\u53D6\u6D3B\u671F\u501F\u5E01\u5F53\u524D\u5E02\u573A\u5229\u7387\u6C47\u603B\uFF08\u516C\u5F00\u6570\u636E\uFF0C\u65E0\u9700API Key\uFF09\u3002\u7528\u4E8E\u5224\u65AD\u501F\u8D37\u6210\u672C\uFF0C\u6216\u5BFB\u627E\u95F2\u7F6E\u8D44\u91D1\u7684\u6700\u4F18\u51FA\u501F\u5229\u7387\u3002",
+    { ccy: external_exports.string().optional().describe("\u5E01\u79CD\uFF0C\u5982 BTC\u3001USDT\uFF0C\u4E0D\u586B\u8FD4\u56DE\u5168\u90E8") },
+    async ({ ccy }) => {
+      try {
+        const data = await publicApi.getLendingRateSummary(ccy);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/subaccount.ts
@@ -22085,6 +22269,50 @@ function registerFinanceTools(server, auth) {
       }
     }
   );
+  server.tool(
+    "okx_get_eth_staking_balance",
+    "\u67E5\u8BE2ETH\u8D28\u62BC\uFF08BETH\uFF09\u6301\u4ED3\u4F59\u989D\uFF0C\u542B\u8D28\u62BC\u603B\u91CF\u3001BETH\u6570\u91CF\u548C\u5F53\u524D\u5E74\u5316\u6536\u76CA\u3002\u26A0\uFE0F \u9700\u8981API Key\u9274\u6743\u3002",
+    {},
+    async () => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getEthStakingBalance(auth);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_eth_staking_history",
+    "\u67E5\u8BE2ETH\u8D28\u62BC/\u8D4E\u56DE\u5386\u53F2\u8BB0\u5F55\uFF0C\u542B\u64CD\u4F5C\u65F6\u95F4\u3001\u6570\u91CF\u548C\u72B6\u6001\u3002\u26A0\uFE0F \u9700\u8981API Key\u9274\u6743\u3002",
+    {
+      limit: external_exports.number().int().min(1).max(100).optional().describe("\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4100")
+    },
+    async ({ limit }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getEthStakingHistory(auth, limit);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_sol_staking_balance",
+    "\u67E5\u8BE2SOL\u8D28\u62BC\u6301\u4ED3\u4F59\u989D\uFF0C\u542B\u8D28\u62BC\u603B\u91CF\u548C\u5F53\u524D\u5E74\u5316\u6536\u76CA\u3002\u26A0\uFE0F \u9700\u8981API Key\u9274\u6743\u3002",
+    {},
+    async () => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getSolStakingBalance(auth);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/outcomes.ts
@@ -22201,17 +22429,208 @@ function registerOutcomesTools(server) {
   );
 }
 
+// src/tools/bot.ts
+function registerBotTools(server, auth) {
+  server.tool(
+    "okx_get_grid_ai_param",
+    "\u83B7\u53D6OKX\u667A\u80FD\u7F51\u683C\u63A8\u8350\u53C2\u6570\uFF08\u65E0\u9700API Key\uFF09\u3002\u5305\u542B\u5EFA\u8BAE\u7684\u7F51\u683C\u4E0A\u4E0B\u754C\u3001\u683C\u6570\u3001\u9884\u671F\u5E74\u5316\u6536\u76CA\u3002\u5F00\u7F51\u683C\u524D\u5FEB\u901F\u8BC4\u4F30\u53C2\u6570\u5408\u7406\u6027\u3002",
+    {
+      instId: external_exports.string().describe("\u4EA7\u54C1ID\uFF0C\u5982 BTC-USDT\u3001BTC-USDT-SWAP"),
+      algoOrdType: external_exports.enum(["grid", "contract_grid", "moon_grid"]).describe("\u7F51\u683C\u7C7B\u578B\uFF1Agrid=\u73B0\u8D27\u7F51\u683C\uFF0Ccontract_grid=\u5408\u7EA6\u7F51\u683C\uFF0Cmoon_grid=\u5929\u5730\u7F51\u683C"),
+      direction: external_exports.enum(["long", "short", "neutral"]).optional().describe("\u5408\u7EA6\u7F51\u683C\u65B9\u5411\uFF08\u4EC5contract_grid\u9700\u8981\uFF09")
+    },
+    async ({ instId, algoOrdType, direction }) => {
+      try {
+        const data = await publicApi.getGridAiParam(instId, algoOrdType, direction);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_grid_orders_pending",
+    "\u67E5\u8BE2\u5F53\u524D\u8FD0\u884C\u4E2D\u7684\u7F51\u683C\u7B56\u7565\u5217\u8868\uFF0C\u542B\u6BCF\u4E2A\u7F51\u683C\u7684\u76C8\u4E8F\u3001\u6210\u4EA4\u6B21\u6570\u548C\u8D44\u91D1\u5360\u7528\u3002\u26A0\uFE0F \u9700\u8981API Key\u9274\u6743\u3002",
+    {
+      algoOrdType: external_exports.enum(["grid", "contract_grid", "moon_grid"]).describe("\u7F51\u683C\u7C7B\u578B"),
+      instId: external_exports.string().optional().describe("\u4EA7\u54C1ID\uFF0C\u4E0D\u586B\u8FD4\u56DE\u5168\u90E8"),
+      instType: external_exports.enum(["SPOT", "MARGIN", "FUTURES", "SWAP"]).optional().describe("\u4EA7\u54C1\u7C7B\u578B\u7B5B\u9009")
+    },
+    async ({ algoOrdType, instId, instType }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getGridOrdersPending(auth, algoOrdType, instId, instType);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_grid_orders_history",
+    "\u67E5\u8BE2\u5DF2\u505C\u6B62\u7684\u5386\u53F2\u7F51\u683C\u7B56\u7565\uFF0C\u542B\u6700\u7EC8\u76C8\u4E8F\u548C\u8FD0\u884C\u65F6\u957F\u3002\u7528\u4E8E\u8BC4\u4F30\u5386\u53F2\u7B56\u7565\u6548\u679C\uFF0C\u4F18\u5316\u4E0B\u6B21\u53C2\u6570\u3002\u26A0\uFE0F \u9700\u8981API Key\u9274\u6743\u3002",
+    {
+      algoOrdType: external_exports.enum(["grid", "contract_grid", "moon_grid"]).describe("\u7F51\u683C\u7C7B\u578B"),
+      instId: external_exports.string().optional().describe("\u4EA7\u54C1ID\uFF0C\u4E0D\u586B\u8FD4\u56DE\u5168\u90E8"),
+      instType: external_exports.enum(["SPOT", "MARGIN", "FUTURES", "SWAP"]).optional().describe("\u4EA7\u54C1\u7C7B\u578B\u7B5B\u9009")
+    },
+    async ({ algoOrdType, instId, instType }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getGridOrdersHistory(auth, algoOrdType, instId, instType);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_grid_sub_orders",
+    "\u67E5\u8BE2\u67D0\u4E2A\u7F51\u683C\u7B56\u7565\u7684\u5B50\u8BA2\u5355\u5217\u8868\uFF08\u6BCF\u4E00\u683C\u7684\u4E70\u5356\u8BB0\u5F55\uFF09\u3002\u7528\u4E8E\u5206\u6790\u7F51\u683C\u6210\u4EA4\u60C5\u51B5\uFF0C\u9A8C\u8BC1\u7B56\u7565\u662F\u5426\u6309\u9884\u671F\u8FD0\u884C\u3002\u26A0\uFE0F \u9700\u8981API Key\u9274\u6743\u3002",
+    {
+      algoId: external_exports.string().describe("\u7F51\u683C\u7B56\u7565ID"),
+      algoOrdType: external_exports.enum(["grid", "contract_grid", "moon_grid"]).describe("\u7F51\u683C\u7C7B\u578B"),
+      type: external_exports.enum(["filled", "unfilled"]).describe("filled=\u5DF2\u6210\u4EA4\uFF0Cunfilled=\u672A\u6210\u4EA4")
+    },
+    async ({ algoId, algoOrdType, type }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getGridSubOrders(auth, algoId, algoOrdType, type);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_recurring_orders_pending",
+    "\u67E5\u8BE2\u5F53\u524D\u8FD0\u884C\u4E2D\u7684\u5B9A\u6295\u8BA1\u5212\u5217\u8868\uFF0C\u542B\u6295\u8D44\u5E01\u79CD\u3001\u5468\u671F\u3001\u5DF2\u6295\u603B\u989D\u548C\u5F53\u524D\u76C8\u4E8F\u3002\u26A0\uFE0F \u9700\u8981API Key\u9274\u6743\u3002",
+    {},
+    async () => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getRecurringOrdersPending(auth);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_recurring_orders_history",
+    "\u67E5\u8BE2\u5DF2\u7ED3\u675F\u7684\u5386\u53F2\u5B9A\u6295\u8BA1\u5212\uFF0C\u542B\u603B\u6295\u5165\u3001\u603B\u6536\u76CA\u548C\u5E74\u5316\u6536\u76CA\u7387\u3002\u7528\u4E8E\u8BC4\u4F30\u5B9A\u6295\u7B56\u7565\u957F\u671F\u6548\u679C\u3002\u26A0\uFE0F \u9700\u8981API Key\u9274\u6743\u3002",
+    {},
+    async () => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getRecurringOrdersHistory(auth);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+}
+
+// src/tools/spread.ts
+function registerSpreadTools(server) {
+  server.tool(
+    "okx_get_spreads",
+    "\u83B7\u53D6\u4EF7\u5DEE\u5408\u7EA6\u4EA7\u54C1\u5217\u8868\u3002\u4EF7\u5DEE\u4EA4\u6613\u662F\u540C\u65F6\u4E70\u5165\u4E00\u4E2A\u5408\u7EA6\u3001\u5356\u51FA\u53E6\u4E00\u4E2A\u5408\u7EA6\uFF0C\u6355\u83B7\u4E24\u8005\u4EF7\u683C\u4E4B\u5DEE\uFF0C\u5E38\u7528\u4E8E\u8DE8\u671F\u5957\u5229\u3002",
+    {
+      sprdId: external_exports.string().optional().describe("\u4EF7\u5DEE\u5408\u7EA6ID\uFF0C\u5982 BTC-USDT_BTC-USDT-SWAP"),
+      baseCcy: external_exports.string().optional().describe("\u6807\u7684\u5E01\u79CD\uFF0C\u5982 BTC"),
+      instId: external_exports.string().optional().describe("\u817F\u5408\u7EA6\u4EA7\u54C1ID\uFF0C\u7CBE\u786E\u7B5B\u9009"),
+      state: external_exports.enum(["live", "expired", "suspend"]).optional().describe("\u5408\u7EA6\u72B6\u6001")
+    },
+    async ({ sprdId, baseCcy, instId, state }) => {
+      try {
+        const data = await publicApi.getSpreads(sprdId, baseCcy, instId, state);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_spread_ticker",
+    "\u83B7\u53D6\u5355\u4E2A\u4EF7\u5DEE\u5408\u7EA6\u5B9E\u65F6\u884C\u60C5\uFF0C\u542B\u6700\u65B0\u4EF7\u3001\u4E70\u5356\u4EF7\u5DEE\u3002\u5148\u7528 okx_get_spreads \u67E5\u8BE2\u53EF\u7528\u7684\u4EF7\u5DEE\u5408\u7EA6ID\u3002",
+    {
+      sprdId: external_exports.string().describe("\u4EF7\u5DEE\u5408\u7EA6ID\uFF0C\u5982 BTC-USD-SWAP_BTC-USD-260925")
+    },
+    async ({ sprdId }) => {
+      try {
+        const data = await publicApi.getSpreadTicker(sprdId);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_spread_orderbook",
+    "\u83B7\u53D6\u4EF7\u5DEE\u5408\u7EA6\u8BA2\u5355\u7C3F\u6DF1\u5EA6\u3002\u5206\u6790\u4E70\u5356\u53CC\u65B9\u6302\u5355\u5206\u5E03\uFF0C\u5224\u65AD\u4EF7\u5DEE\u5E02\u573A\u7684\u6D41\u52A8\u6027\u8D28\u91CF\u3002",
+    {
+      sprdId: external_exports.string().describe("\u4EF7\u5DEE\u5408\u7EA6ID"),
+      sz: external_exports.number().int().min(1).max(400).optional().describe("\u6DF1\u5EA6\u6863\u4F4D\uFF0C\u9ED8\u8BA420")
+    },
+    async ({ sprdId, sz }) => {
+      try {
+        const data = await publicApi.getSpreadOrderbook(sprdId, sz);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_spread_trades",
+    "\u83B7\u53D6\u4EF7\u5DEE\u5408\u7EA6\u6700\u65B0\u6210\u4EA4\u8BB0\u5F55\u3002\u7528\u4E8E\u5206\u6790\u5E02\u573A\u53C2\u4E0E\u8005\u5BF9\u5F53\u524D\u4EF7\u5DEE\u6C34\u5E73\u7684\u8BA4\u53EF\u5EA6\u3002",
+    {
+      sprdId: external_exports.string().describe("\u4EF7\u5DEE\u5408\u7EA6ID"),
+      limit: external_exports.number().int().min(1).max(100).optional().describe("\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA420")
+    },
+    async ({ sprdId, limit }) => {
+      try {
+        const data = await publicApi.getSpreadTrades(sprdId, limit);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_spread_candles",
+    "\u83B7\u53D6\u4EF7\u5DEE\u5408\u7EA6K\u7EBF\u6570\u636E\u3002\u7528\u4E8E\u7814\u7A76\u4EF7\u5DEE\u5386\u53F2\u8D70\u52BF\uFF0C\u8BC6\u522B\u5747\u503C\u56DE\u5F52\u673A\u4F1A\u3002",
+    {
+      sprdId: external_exports.string().describe("\u4EF7\u5DEE\u5408\u7EA6ID"),
+      bar: external_exports.enum(["1m", "5m", "15m", "30m", "1H", "4H", "1D"]).optional().describe("K\u7EBF\u5468\u671F\uFF0C\u9ED8\u8BA41H"),
+      limit: external_exports.number().int().min(1).max(300).optional().describe("\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4100")
+    },
+    async ({ sprdId, bar, limit }) => {
+      try {
+        const data = await publicApi.getSpreadCandles(sprdId, bar, limit);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+}
+
 // src/index.ts
 async function main() {
-  const server = new McpServer({ name: "hvip", version: "0.1.0" });
+  const server = new McpServer({ name: "hvip", version: "0.1.5" });
   const auth = getAuth();
   registerMarketTools(server);
   registerPublicTools(server);
   registerStatsTools(server);
+  registerSpreadTools(server);
   registerOutcomesTools(server);
   registerAccountTools(server, auth);
   registerTradingTools(server, auth);
   registerAlgoTools(server, auth);
+  registerBotTools(server, auth);
   registerFundingTools(server, auth);
   registerSubAccountTools(server, auth);
   registerFinanceTools(server, auth);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hvip-mcp-server",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "description": "OKX ecosystem MCP server — full API coverage for AI agents",
   "homepage": "https://hvip.one",
   "license": "MIT",