hvip-mcp-server 0.2.24 → 0.2.25

package/dist/index.js

@@ -21201,7 +21201,13 @@ var publicApi = {
   getCallAuctionDetails: (instId) => request("GET", "/api/v5/market/call-auction-details", { params: { instId } }),
   getOptionInstrumentFamilyTrades: (instFamily, limit) => request("GET", "/api/v5/market/option/instrument-family-trades", { params: { instFamily, limit } }),
   getOptionTrades: (instFamily, instId, limit) => request("GET", "/api/v5/public/option-trades", { params: { instFamily, instId, limit } }),
-  getExchangeRate: () => request("GET", "/api/v5/market/exchange-rate")
+  getExchangeRate: () => request("GET", "/api/v5/market/exchange-rate"),
+  getIndexComponents: (index) => request("GET", "/api/v5/market/index-components", { params: { index } }),
+  getEstimatedPrice: (instId) => request("GET", "/api/v5/public/estimated-price", { params: { instId } }),
+  getDiscountRateInterestFreeQuota: () => request("GET", "/api/v5/public/discount-rate-interest-free-quota"),
+  getOptionOiExpiry: (ccy) => request("GET", "/api/v5/rubik/stat/option/open-interest-volume-expiry", { params: { ccy } }),
+  getOptionOiStrike: (ccy, expTime) => request("GET", "/api/v5/rubik/stat/option/open-interest-volume-strike", { params: { ccy, expTime } }),
+  getOptionOpenInterestVolume: (ccy) => request("GET", "/api/v5/rubik/stat/option/open-interest-volume", { params: { ccy } })
 };
 var privateApi = {
   getBalance: (auth, ccy) => request("GET", "/api/v5/account/balance", { params: { ccy }, auth }),
@@ -21342,7 +21348,14 @@ var privateApi = {
   // ── 资金收尾（第十七批新增） ──────────────────────────────────────────
   getDepositLightning: (auth, ccy) => request("GET", "/api/v5/asset/deposit-lightning", { params: { ccy }, auth }),
   withdrawalLightning: (auth, body) => request("POST", "/api/v5/asset/withdrawal-lightning", { body, auth }),
-  getTransferState: (auth, transferId) => request("GET", "/api/v5/asset/transfer-state", { params: { transferId }, auth })
+  getTransferState: (auth, transferId) => request("GET", "/api/v5/asset/transfer-state", { params: { transferId }, auth }),
+  // ── 第二批价差操作 ────────────────────────────────────────────────────────
+  amendSpreadOrder: (auth, body) => request("POST", "/api/v5/sprd/amend-order", { body, auth }),
+  getSpreadOrdersHistory: (auth, sprdId, limit) => request("GET", "/api/v5/sprd/orders-history", { params: { sprdId, limit }, auth }),
+  getSpreadFills: (auth, sprdId, limit) => request("GET", "/api/v5/sprd/fills", { params: { sprdId, limit }, auth }),
+  // ── 第三批交易收尾 ─────────────────────────────────────────────────────────
+  resetMmp: (auth, body) => request("POST", "/api/v5/account/mmp-reset", { body, auth }),
+  getOrderByClientId: (auth, instId, clOrdId) => request("GET", "/api/v5/trade/order", { params: { instId, clOrdId }, auth })
 };
 
 // src/adapters/hrails.ts
@@ -22194,6 +22207,76 @@ function registerPublicTools(server, auth) {
       }
     }
   );
+  server.tool(
+    "okx_get_index_components",
+    "## \u529F\u80FD\uFF1A\u83B7\u53D6\u6307\u6570\u7684\u6210\u5206\u5E01\u79CD\u53CA\u5176\u6743\u91CD\n## \u573A\u666F\uFF1A\u7528\u4E8E\u4E86\u89E3\u6307\u6570\u6784\u6210\u3001\u5206\u6790\u5404\u4EA4\u6613\u6240\u5BF9\u6307\u6570\u4EF7\u683C\u7684\u5F71\u54CD\u6743\u91CD\n## \u5173\u952E\u8BCD\uFF1A\u6307\u6570\u6210\u5206, index components, \u6307\u6570\u6743\u91CD, \u6210\u5206\u5E01\u79CD, \u6210\u5206\u4EA4\u6613\u6240\n## \u53C2\u6570\uFF1A\n##   - index: \u6307\u6570\u540D\u79F0\uFF0C\u5982 BTC-USD\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u770B\u6307\u6570\u6210\u5206 \u2192 okx_get_index_tickers \u770B\u6307\u6570\u4EF7\u683C \u2192 \u5206\u6790\u504F\u5DEE",
+    {
+      index: external_exports.string().describe("\u6307\u6570\u540D\u79F0\uFF0C\u5982 BTC-USD\u3002\u5FC5\u586B")
+    },
+    async ({ index }) => {
+      try {
+        const data = await publicApi.getIndexComponents(index);
+        const enriched = typeof data === "object" && !Array.isArray(data) ? {
+          ...data,
+          tsIso: data.ts ? new Date(parseInt(data.ts)).toISOString() : void 0
+        } : data;
+        return toResult(enriched);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_index_components_market",
+    "## \u529F\u80FD\uFF1A\u83B7\u53D6\u5E02\u573A\u4EF7\u683C\u6307\u6570\u7684\u6210\u5206\u6570\u636E\n## \u573A\u666F\uFF1A\u7528\u4E8E\u83B7\u53D6\u6307\u6570\u6210\u5206\u7684\u6700\u9AD8/\u6700\u4F4E\u4EF7\u3001\u5404\u4EA4\u6613\u6240\u62A5\u4EF7\n## \u5173\u952E\u8BCD\uFF1A\u5E02\u573A\u6307\u6570\u6210\u5206, market index components, \u5E02\u573A\u4EF7\u683C\u6307\u6570\n## \u53C2\u6570\uFF1A\n##   - index: \u6307\u6570\u540D\u79F0\uFF0C\u5982 BTC-USD\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u67E5\u770B\u5E02\u573A\u6307\u6570\u6210\u5206 \u2192 \u5BF9\u6BD4\u5404\u4EA4\u6613\u6240\u4EF7\u5DEE \u2192 \u53D1\u73B0\u5957\u5229\u673A\u4F1A",
+    {
+      index: external_exports.string().describe("\u6307\u6570\u540D\u79F0\uFF0C\u5982 BTC-USD\u3002\u5FC5\u586B")
+    },
+    async ({ index }) => {
+      try {
+        const data = await publicApi.getIndexComponents(index);
+        const enriched = typeof data === "object" && !Array.isArray(data) ? {
+          ...data,
+          tsIso: data.ts ? new Date(parseInt(data.ts)).toISOString() : void 0
+        } : data;
+        return toResult(enriched);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_discount_info",
+    "## \u529F\u80FD\uFF1A\u83B7\u53D6\u5404\u5E01\u79CD\u7684\u62B5\u62BC\u54C1\u6298\u6263\u7387\u548C\u514D\u606F\u989D\u5EA6\n## \u573A\u666F\uFF1A\u7528\u4E8E\u4E86\u89E3\u5404\u5E01\u79CD\u4F5C\u4E3A\u62B5\u62BC\u54C1\u7684\u4EF7\u503C\u6298\u6263\u3001\u8BA1\u7B97\u53EF\u7528\u62B5\u62BC\u989D\u5EA6\n## \u5173\u952E\u8BCD\uFF1A\u62B5\u62BC\u6298\u6263, discount info, \u62B5\u62BC\u54C1\u6298\u6263\u7387, \u514D\u606F\u989D\u5EA6, \u62C5\u4FDD\u54C1\n## \u53C2\u6570\uFF1A\u65E0\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u770B\u6298\u6263\u7387 \u2192 \u8BA1\u7B97\u5B9E\u9645\u62B5\u62BC\u4EF7\u503C \u2192 okx_get_max_loan \u67E5\u53EF\u501F",
+    {},
+    async () => {
+      try {
+        const data = await publicApi.getDiscountRateInterestFreeQuota();
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_estimated_price",
+    "## \u529F\u80FD\uFF1A\u83B7\u53D6\u671F\u6743\u9884\u4F30\u884C\u6743\u7ED3\u7B97\u4EF7\n## \u573A\u666F\uFF1A\u7528\u4E8E\u671F\u6743\u5230\u671F\u524D\u9884\u4F30\u7ED3\u7B97\u4EF7\u3001\u8BC4\u4F30\u671F\u6743\u5230\u671F\u4EF7\u503C\n## \u5173\u952E\u8BCD\uFF1A\u9884\u4F30\u7ED3\u7B97, estimated price, \u671F\u6743\u7ED3\u7B97, \u884C\u6743\u9884\u4F30, \u4EA4\u5272\u9884\u4F30\u4EF7\n## \u53C2\u6570\uFF1A\n##   - instId: \u671F\u6743\u4EA7\u54C1ID\uFF0C\u5982 BTC-USD-260612-64000-C\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u5FAE\u5C0F ~500B\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u770B\u9884\u4F30\u7ED3\u7B97\u4EF7 \u2192 okx_get_opt_summary \u770B\u6CE2\u52A8\u7387 \u2192 \u8BC4\u4F30\u671F\u6743\u4EF7\u503C",
+    {
+      instId: external_exports.string().describe("\u671F\u6743\u4EA7\u54C1ID\uFF0C\u5982 BTC-USD-260612-64000-C\u3002\u5FC5\u586B")
+    },
+    async ({ instId }) => {
+      try {
+        const data = await publicApi.getEstimatedPrice(instId);
+        const enriched = data.map((item) => ({
+          ...item,
+          tsIso: item.ts ? new Date(parseInt(item.ts)).toISOString() : void 0
+        }));
+        return toResult(enriched);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/account.ts
@@ -23021,6 +23104,56 @@ function registerTradingTools(server, auth) {
       }
     }
   );
+  server.tool(
+    "okx_reset_mmp",
+    "## \u529F\u80FD\uFF1A\u91CD\u7F6EMMP\uFF08\u505A\u5E02\u5546\u4FDD\u62A4\uFF09\u72B6\u6001\n## \u573A\u666F\uFF1A\u7528\u4E8E\u5728\u89E6\u53D1MMP\u4FDD\u62A4\u540E\u624B\u52A8\u91CD\u7F6E\u3001\u6062\u590D\u505A\u5E02\u4EA4\u6613\n## \u5173\u952E\u8BCD\uFF1A\u91CD\u7F6EMMP, reset mmp, \u505A\u5E02\u5546\u91CD\u7F6E, MMP\u590D\u4F4D\n## \u53C2\u6570\uFF1A\n##   - instFamily: \u4EA7\u54C1\u65CF\uFF0C\u5982 BTC-USD\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1A\u{1F534} \u9700\u8981 API Key\uFF08\u4EA4\u6613\uFF09- \u5C06\u91CD\u7F6EMMP\u4FDD\u62A4\u72B6\u6001\uFF0C\u8C03\u7528\u524D\u5FC5\u987B\u786E\u8BA4\n## \u98CE\u9669\uFF1AWRITE \u2014 \u91CD\u7F6EMMP\u540E\u505A\u5E02\u5546\u53EF\u6062\u590D\u4EA4\u6613\uFF0C\u8C03\u7528\u524D\u5FC5\u987B\u786E\u8BA4\n## \u8FD4\u56DE\u91CF\uFF1A\u5FAE\u5C0F ~300B\n## \u5173\u8054\uFF1Aokx_get_mmp_config \u67E5\u770BMMP\u72B6\u6001 \u2192 \u672C\u5DE5\u5177\u91CD\u7F6E \u2192 \u6062\u590D\u6B63\u5E38\u505A\u5E02",
+    {
+      instFamily: external_exports.string().describe("\u4EA7\u54C1\u65CF\uFF0C\u5982 BTC-USD\u3002\u5FC5\u586B")
+    },
+    async ({ instFamily }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.resetMmp(auth, { instFamily });
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_orders_archive",
+    "## \u529F\u80FD\uFF1A\u67E5\u8BE23\u4E2A\u6708\u4EE5\u524D\u7684\u5B8C\u6574\u5386\u53F2\u8BA2\u5355\uFF08\u5F52\u6863\u6570\u636E\uFF09\n## \u573A\u666F\uFF1A\u7528\u4E8E\u957F\u671F\u4EA4\u6613\u8BB0\u5F55\u5206\u6790\u3001\u5E74\u5EA6\u590D\u76D8\n## \u5173\u952E\u8BCD\uFF1A\u5F52\u6863\u8BA2\u5355, orders archive, \u5386\u53F2\u5F52\u6863, \u8BA2\u5355\u5B58\u6863\n## \u53C2\u6570\uFF1A\n##   - instType: \u4EA7\u54C1\u7C7B\u578B\u3002SPOT=\u73B0\u8D27, MARGIN=\u6760\u6746, SWAP=\u6C38\u7EED, FUTURES=\u4EA4\u5272, OPTION=\u671F\u6743\n##   - limit: \u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA450\uFF0C\u6700\u5927100\n## \u9274\u6743\uFF1A\u26A0\uFE0F \u9700\u8981 API Key\uFF08\u53EA\u8BFB\uFF09\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~10KB\n## \u5173\u8054\uFF1Aokx_get_orders_history \u67E5\u8FD1\u671F\u8BA2\u5355 \u2192 \u672C\u5DE5\u5177\u67E5\u5F52\u6863 \u2192 \u5B8C\u6574\u590D\u76D8",
+    {
+      instType: external_exports.enum(INST_TYPE_TRADE).describe("\u4EA7\u54C1\u7C7B\u578B"),
+      limit: external_exports.number().int().min(1).max(100).optional().describe("\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA450")
+    },
+    async ({ instType, limit }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getOrdersHistoryArchive(auth, instType, limit);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_order_by_clOrdId",
+    "## \u529F\u80FD\uFF1A\u901A\u8FC7\u5BA2\u6237\u7AEF\u81EA\u5B9A\u4E49ID\u67E5\u8BE2\u8BA2\u5355\u8BE6\u60C5\n## \u573A\u666F\uFF1A\u7528\u4E8E\u8FFD\u8E2A\u4F7F\u7528\u81EA\u5B9A\u4E49\u8BA2\u5355ID\u4E0B\u5355\u540E\u7684\u6267\u884C\u72B6\u6001\u3001\u5728\u81EA\u6709\u7CFB\u7EDF\u4E2D\u5173\u8054\u8BA2\u5355\n## \u5173\u952E\u8BCD\uFF1A\u8BA2\u5355ID, clOrdId, \u81EA\u5B9A\u4E49\u8BA2\u5355, \u5BA2\u6237\u7AEFID, \u8BA2\u5355\u67E5\u8BE2\n## \u53C2\u6570\uFF1A\n##   - instId: \u4EA7\u54C1ID\u3002\u5FC5\u586B\n##   - clOrdId: \u5BA2\u6237\u7AEF\u81EA\u5B9A\u4E49\u8BA2\u5355ID\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1A\u26A0\uFE0F \u9700\u8981 API Key\uFF08\u53EA\u8BFB\uFF09\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u5FAE\u5C0F ~500B\n## \u5173\u8054\uFF1Aokx_place_order \u4E0B\u5355\u65F6\u8BBE\u7F6EclOrdId \u2192 \u672C\u5DE5\u5177\u67E5\u8BE2 \u2192 \u786E\u8BA4\u8BA2\u5355\u72B6\u6001",
+    {
+      instId: external_exports.string().describe("\u4EA7\u54C1ID\u3002\u5FC5\u586B"),
+      clOrdId: external_exports.string().describe("\u5BA2\u6237\u7AEF\u81EA\u5B9A\u4E49\u8BA2\u5355ID\u3002\u5FC5\u586B")
+    },
+    async ({ instId, clOrdId }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getOrderByClientId(auth, instId, clOrdId);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/algo.ts
@@ -23598,6 +23731,83 @@ function registerStatsTools(server) {
       }
     }
   );
+  server.tool(
+    "okx_get_margin_lending_ratio_history",
+    "## \u529F\u80FD\uFF1A\u83B7\u53D6\u6760\u6746\u501F\u5E01\u5229\u7387\u5386\u53F2\u8D70\u52BF\n## \u573A\u666F\uFF1A\u7528\u4E8E\u5206\u6790\u501F\u5E01\u5229\u7387\u53D8\u5316\u8D8B\u52BF\u3001\u5224\u65AD\u6760\u6746\u8D44\u91D1\u6210\u672C\u53D8\u5316\n## \u5173\u952E\u8BCD\uFF1A\u501F\u5E01\u5229\u7387\u5386\u53F2, margin lending history, \u5229\u7387\u8D70\u52BF, \u6760\u6746\u6210\u672C\n## \u53C2\u6570\uFF1A\n##   - ccy: \u5E01\u79CD\uFF0C\u5982 BTC\u3001USDT\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u770B\u5229\u7387\u5386\u53F2 \u2192 okx_get_margin_lending_ratio \u770B\u5F53\u524D \u2192 \u5224\u65AD\u6760\u6746\u53D8\u5316",
+    { ccy: external_exports.string().describe("\u5E01\u79CD\uFF0C\u5982 BTC\u3001USDT") },
+    async ({ ccy }) => {
+      try {
+        const data = await publicApi.getLendingRateHistory(ccy);
+        const enriched = data.map((item) => ({
+          ...item,
+          tsIso: item.ts ? new Date(parseInt(item.ts)).toISOString() : void 0
+        }));
+        return toResult(enriched);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_option_open_interest",
+    "## \u529F\u80FD\uFF1A\u83B7\u53D6\u671F\u6743\u672A\u5E73\u4ED3\u91CF\u548C\u6210\u4EA4\u91CF\n## \u573A\u666F\uFF1A\u7528\u4E8E\u5206\u6790\u671F\u6743\u5E02\u573A\u6D3B\u8DC3\u5EA6\u3001\u5224\u65AD\u8D44\u91D1\u6D41\u5165\u6D41\u51FA\u8D8B\u52BF\n## \u5173\u952E\u8BCD\uFF1A\u671F\u6743\u6301\u4ED3, option oi, \u671F\u6743\u672A\u5E73\u4ED3, \u671F\u6743\u6210\u4EA4\u91CF, \u671F\u6743\u6301\u4ED3\u91CF\n## \u53C2\u6570\uFF1A\n##   - ccy: \u5E01\u79CD\uFF0C\u5982 BTC\u3001ETH\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u770B\u671F\u6743\u6301\u4ED3 \u2192 okx_get_put_call_ratio \u5206\u6790\u60C5\u7EEA \u2192 okx_get_opt_summary \u770B\u6CE2\u52A8\u7387",
+    { ccy: external_exports.string().describe("\u5E01\u79CD\uFF0C\u5982 BTC\u3001ETH\u3002\u5FC5\u586B") },
+    async ({ ccy }) => {
+      try {
+        const data = await publicApi.getOptionOpenInterestVolume(ccy);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_option_oi_expiry",
+    "## \u529F\u80FD\uFF1A\u6309\u5230\u671F\u65E5\u83B7\u53D6\u671F\u6743\u672A\u5E73\u4ED3\u91CF\u548C\u6210\u4EA4\u91CF\u5206\u5E03\n## \u573A\u666F\uFF1A\u7528\u4E8E\u5206\u6790\u4E0D\u540C\u5230\u671F\u65E5\u7684\u671F\u6743\u6301\u4ED3\u5206\u5E03\u3001\u5224\u65AD\u5E02\u573A\u7126\u70B9\u5230\u671F\u65E5\n## \u5173\u952E\u8BCD\uFF1A\u671F\u6743\u5230\u671F\u6301\u4ED3, option oi expiry, \u5230\u671F\u65E5\u5206\u5E03, \u5404\u671F\u9650\u6301\u4ED3\n## \u53C2\u6570\uFF1A\n##   - ccy: \u5E01\u79CD\uFF0C\u5982 BTC\u3001ETH\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u6309\u5230\u671F\u65E5\u770B\u6301\u4ED3 \u2192 okx_get_option_open_interest \u770B\u603B\u91CF \u2192 \u5206\u6790\u5230\u671F\u65E5\u96C6\u4E2D\u5EA6",
+    { ccy: external_exports.string().describe("\u5E01\u79CD\uFF0C\u5982 BTC\u3001ETH\u3002\u5FC5\u586B") },
+    async ({ ccy }) => {
+      try {
+        const data = await publicApi.getOptionOiExpiry(ccy);
+        const enriched = data.map((row) => ({
+          ts: row[0],
+          tsIso: row[0] ? new Date(parseInt(row[0])).toISOString() : void 0,
+          expTime: row[1],
+          oi: row[2],
+          oiUsd: row[3],
+          vol: row[4],
+          volUsd: row[5]
+        }));
+        return toResult(enriched);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_option_oi_strike",
+    "## \u529F\u80FD\uFF1A\u6309\u884C\u6743\u4EF7\u83B7\u53D6\u671F\u6743\u672A\u5E73\u4ED3\u91CF\u548C\u6210\u4EA4\u91CF\u5206\u5E03\n## \u573A\u666F\uFF1A\u7528\u4E8E\u5206\u6790\u4E0D\u540C\u884C\u6743\u4EF7\u7684\u671F\u6743\u6301\u4ED3\u96C6\u4E2D\u5EA6\u3001\u53D1\u73B0\u6700\u5927\u75DB\u70B9\u3001\u5224\u65AD\u5E02\u573A\u9884\u671F\u4EF7\u683C\u533A\u95F4\n## \u5173\u952E\u8BCD\uFF1A\u671F\u6743\u884C\u6743\u6301\u4ED3, option oi strike, \u884C\u6743\u4EF7\u5206\u5E03, \u6700\u5927\u75DB\u70B9, max pain\n## \u53C2\u6570\uFF1A\n##   - ccy: \u5E01\u79CD\uFF0C\u5982 BTC\u3001ETH\u3002\u5FC5\u586B\n##   - expTime: \u5230\u671F\u65E5\uFF0C\u683C\u5F0F YYYYMMDD\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u770B\u884C\u6743\u4EF7\u5206\u5E03 \u2192 \u8BA1\u7B97\u6700\u5927\u75DB\u70B9 \u2192 \u9884\u5224\u5230\u671F\u65E5\u4EF7\u683C\u8D70\u52BF",
+    {
+      ccy: external_exports.string().describe("\u5E01\u79CD\uFF0C\u5982 BTC\u3001ETH\u3002\u5FC5\u586B"),
+      expTime: external_exports.string().describe("\u5230\u671F\u65E5\uFF0C\u683C\u5F0F YYYYMMDD\u3002\u5FC5\u586B")
+    },
+    async ({ ccy, expTime }) => {
+      try {
+        const data = await publicApi.getOptionOiStrike(ccy, expTime);
+        const enriched = data.map((row) => ({
+          ts: row[0],
+          tsIso: row[0] ? new Date(parseInt(row[0])).toISOString() : void 0,
+          strike: row[1],
+          putOi: row[2],
+          callOi: row[3],
+          putVol: row[4],
+          callVol: row[5]
+        }));
+        return toResult(enriched);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/subaccount.ts
@@ -24518,6 +24728,84 @@ function registerSpreadTools(server, auth) {
       }
     }
   );
+  server.tool(
+    "okx_amend_spread_order",
+    "## \u529F\u80FD\uFF1A\u4FEE\u6539\u4EF7\u5DEE\u5408\u7EA6\u672A\u6210\u4EA4\u8BA2\u5355\n## \u573A\u666F\uFF1A\u7528\u4E8E\u8C03\u6574\u4EF7\u5DEE\u6302\u5355\u7684\u4EF7\u683C\u6216\u6570\u91CF\n## \u5173\u952E\u8BCD\uFF1A\u4FEE\u6539\u4EF7\u5DEE, amend spread, \u4EF7\u5DEE\u6539\u5355, \u4EF7\u5DEE\u6539\u4EF7\n## \u53C2\u6570\uFF1A\n##   - sprdId: \u4EF7\u5DEE\u5408\u7EA6ID\u3002\u5FC5\u586B\n##   - ordId: \u8BA2\u5355ID\u3002\u5FC5\u586B\n##   - newSz: \u65B0\u6570\u91CF\u3002\u53EF\u9009\n##   - newPx: \u65B0\u4EF7\u683C\u3002\u53EF\u9009\n## \u9274\u6743\uFF1A\u{1F534} \u9700\u8981 API Key\uFF08\u4EA4\u6613\uFF09- \u5C06\u4FEE\u6539\u4EF7\u5DEE\u8BA2\u5355\uFF0C\u8C03\u7528\u524D\u5FC5\u987B\u786E\u8BA4\n## \u98CE\u9669\uFF1AWRITE \u2014 \u4FEE\u6539\u8BA2\u5355\uFF0C\u8C03\u7528\u524D\u5FC5\u987B\u786E\u8BA4\n## \u8FD4\u56DE\u91CF\uFF1A\u5FAE\u5C0F ~500B\n## \u5173\u8054\uFF1Aokx_get_spread_orders \u67E5\u770B\u6302\u5355 \u2192 \u672C\u5DE5\u5177\u4FEE\u6539 \u2192 \u786E\u8BA4\u4FEE\u6539\u7ED3\u679C",
+    {
+      sprdId: external_exports.string().describe("\u4EF7\u5DEE\u5408\u7EA6ID\u3002\u5FC5\u586B"),
+      ordId: external_exports.string().describe("\u8BA2\u5355ID\u3002\u5FC5\u586B"),
+      newSz: external_exports.string().optional().describe("\u65B0\u6570\u91CF"),
+      newPx: external_exports.string().optional().describe("\u65B0\u4EF7\u683C")
+    },
+    async ({ sprdId, ordId, newSz, newPx }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const body = { sprdId, ordId };
+        if (newSz) body.newSz = newSz;
+        if (newPx) body.newPx = newPx;
+        const data = await privateApi.amendSpreadOrder(auth, body);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_spread_orders_history",
+    "## \u529F\u80FD\uFF1A\u67E5\u8BE2\u4EF7\u5DEE\u5408\u7EA6\u5386\u53F2\u8BA2\u5355\n## \u573A\u666F\uFF1A\u7528\u4E8E\u67E5\u770B\u5DF2\u5B8C\u6210\u7684\u5386\u53F2\u4EF7\u5DEE\u8BA2\u5355\u3001\u590D\u76D8\u4EF7\u5DEE\u4EA4\u6613\n## \u5173\u952E\u8BCD\uFF1A\u4EF7\u5DEE\u5386\u53F2\u8BA2\u5355, spread orders history, \u4EF7\u5DEE\u6210\u4EA4\u5386\u53F2\n## \u53C2\u6570\uFF1A\n##   - sprdId: \u4EF7\u5DEE\u5408\u7EA6ID\u3002\u53EF\u9009\n##   - limit: \u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4100\n## \u9274\u6743\uFF1A\u26A0\uFE0F \u9700\u8981 API Key\uFF08\u53EA\u8BFB\uFF09\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1Aokx_get_spread_orders \u67E5\u5F53\u524D\u6302\u5355 \u2192 \u672C\u5DE5\u5177\u67E5\u5386\u53F2 \u2192 \u590D\u76D8\u4EA4\u6613",
+    {
+      sprdId: external_exports.string().optional().describe("\u4EF7\u5DEE\u5408\u7EA6ID"),
+      limit: external_exports.number().int().min(1).max(100).optional().describe("\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4100")
+    },
+    async ({ sprdId, limit }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getSpreadOrdersHistory(auth, sprdId, limit);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_spread_fills",
+    "## \u529F\u80FD\uFF1A\u67E5\u8BE2\u4EF7\u5DEE\u5408\u7EA6\u6210\u4EA4\u660E\u7EC6\n## \u573A\u666F\uFF1A\u7528\u4E8E\u67E5\u770B\u4EF7\u5DEE\u8BA2\u5355\u7684\u9010\u7B14\u6210\u4EA4\u8BB0\u5F55\u3001\u6838\u5BF9\u6210\u4EA4\u4EF7\u683C\u548C\u6570\u91CF\n## \u5173\u952E\u8BCD\uFF1A\u4EF7\u5DEE\u6210\u4EA4, spread fills, \u4EF7\u5DEE\u6210\u4EA4\u660E\u7EC6, \u4EF7\u5DEE\u9010\u7B14\n## \u53C2\u6570\uFF1A\n##   - sprdId: \u4EF7\u5DEE\u5408\u7EA6ID\u3002\u53EF\u9009\n##   - limit: \u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4100\n## \u9274\u6743\uFF1A\u26A0\uFE0F \u9700\u8981 API Key\uFF08\u53EA\u8BFB\uFF09\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~5KB\n## \u5173\u8054\uFF1Aokx_get_spread_orders \u67E5\u8BA2\u5355 \u2192 \u672C\u5DE5\u5177\u67E5\u6210\u4EA4 \u2192 \u6838\u7B97\u6210\u672C",
+    {
+      sprdId: external_exports.string().optional().describe("\u4EF7\u5DEE\u5408\u7EA6ID"),
+      limit: external_exports.number().int().min(1).max(100).optional().describe("\u8FD4\u56DE\u6761\u6570\uFF0C\u9ED8\u8BA4100")
+    },
+    async ({ sprdId, limit }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getSpreadFills(auth, sprdId, limit);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
+  server.tool(
+    "okx_get_spread_books",
+    "## \u529F\u80FD\uFF1A\u83B7\u53D6\u4EF7\u5DEE\u5408\u7EA6\u5168\u6DF1\u5EA6\u8BA2\u5355\u7C3F\n## \u573A\u666F\uFF1A\u7528\u4E8E\u5206\u6790\u4EF7\u5DEE\u5E02\u573A\u6D41\u52A8\u6027\u5168\u8C8C\u3001\u53D1\u73B0\u9690\u85CF\u7684\u5927\u989D\u6302\u5355\n## \u5173\u952E\u8BCD\uFF1A\u4EF7\u5DEE\u5168\u6DF1\u5EA6, spread books, \u4EF7\u5DEE\u5B8C\u6574\u6DF1\u5EA6, \u4EF7\u5DEE\u6240\u6709\u6863\u4F4D\n## \u53C2\u6570\uFF1A\n##   - sprdId: \u4EF7\u5DEE\u5408\u7EA6ID\u3002\u5FC5\u586B\n## \u9274\u6743\uFF1APUBLIC \u2014 \u516C\u5F00\u63A5\u53E3\uFF0C\u4E0D\u9700\u8981 API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u4E2D\u7B49 ~10KB\n## \u5173\u8054\uFF1Aokx_get_spread_orderbook \u770B\u6709\u9650\u6DF1\u5EA6 \u2192 \u672C\u5DE5\u5177\u770B\u5168\u6DF1\u5EA6 \u2192 \u5206\u6790\u6D41\u52A8\u6027",
+    {
+      sprdId: external_exports.string().describe("\u4EF7\u5DEE\u5408\u7EA6ID\u3002\u5FC5\u586B")
+    },
+    async ({ sprdId }) => {
+      try {
+        const data = await publicApi.getSpreadOrderbook(sprdId);
+        const enriched = data.data || data;
+        if (enriched && typeof enriched === "object" && !Array.isArray(enriched)) {
+          return toResult({
+            ...enriched,
+            tsIso: enriched.ts ? new Date(parseInt(enriched.ts)).toISOString() : void 0
+          });
+        }
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/copy.ts

package/package.json

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