hvip-mcp-server 0.2.8 → 0.2.10

package/dist/index.js

@@ -21378,12 +21378,21 @@ function toError(e) {
 function registerMarketTools(server) {
   server.tool(
     "okx_get_ticker",
-    "\u83B7\u53D6\u5355\u4E2AOKX\u4EA7\u54C1\u7684\u5B9E\u65F6\u884C\u60C5Ticker\uFF0C\u5305\u542B\u6700\u65B0\u4EF7\u3001\u4E70\u4E00\u4EF7\u3001\u5356\u4E00\u4EF7\u300124h\u6210\u4EA4\u91CF\u7B49\u3002\u9002\u7528\u4E8E\u67E5\u8BE2\u4EFB\u610F\u73B0\u8D27/\u5408\u7EA6\u7684\u5F53\u524D\u4EF7\u683C\u3002",
-    { instId: external_exports.string().describe("\u4EA7\u54C1ID\uFF0C\u5982 BTC-USDT\u3001ETH-USDT-SWAP") },
+    "\u83B7\u53D6\u5355\u4E2A\u6216\u591A\u4E2A\u4EA7\u54C1\u7684\u5B9E\u65F6\u884C\u60C5Ticker\uFF0C\u5305\u542B\u6700\u65B0\u4EF7\u3001\u4E70\u4E00\u4EF7\u3001\u5356\u4E00\u4EF7\u300124h\u6210\u4EA4\u91CF\u7B49\u3002\u652F\u6301\u9017\u53F7\u5206\u9694\u591A\u4EA7\u54C1\u6279\u91CF\u67E5\u8BE2\uFF08\u5982 BTC-USDT,ETH-USDT,SOL-USDT\uFF09\u3002",
+    { instId: external_exports.string().describe("\u4EA7\u54C1ID\uFF0C\u5982 BTC-USDT\u3001ETH-USDT-SWAP\u3002\u652F\u6301\u9017\u53F7\u5206\u9694\u6279\u91CF\u67E5\u8BE2\uFF0C\u5982 BTC-USDT,ETH-USDT,SOL-USDT") },
     async ({ instId }) => {
       try {
-        const data = await publicApi.getTicker(instId);
-        return toResult(data);
+        const ids = instId.split(",").map((s) => s.trim()).filter(Boolean);
+        const allData = [];
+        for (const id of ids) {
+          const data = await publicApi.getTicker(id);
+          const enriched = data.map((item) => ({
+            ...item,
+            tsIso: item.ts ? new Date(parseInt(item.ts)).toISOString() : void 0
+          }));
+          allData.push(...enriched);
+        }
+        return toResult(allData);
       } catch (e) {
         return toError(e);
       }
@@ -21396,7 +21405,10 @@ function registerMarketTools(server) {
     async ({ instType }) => {
       try {
         const data = await publicApi.getTickers(instType);
-        const arr = data;
+        const arr = data.map((item) => ({
+          ...item,
+          tsIso: item.ts ? new Date(parseInt(item.ts)).toISOString() : void 0
+        }));
         const top = arr.length > 20 ? arr.slice(0, 20) : arr;
         return toResult({ total: arr.length, returned: top.length, data: top });
       } catch (e) {
@@ -21457,7 +21469,11 @@ function registerMarketTools(server) {
     async ({ instId, limit }) => {
       try {
         const data = await publicApi.getTrades(instId, limit);
-        return toResult(data);
+        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);
       }
@@ -21502,7 +21518,11 @@ function registerMarketTools(server) {
     async ({ instId, limit }) => {
       try {
         const data = await publicApi.getHistoryTrades(instId, limit);
-        return toResult(data);
+        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);
       }
@@ -21530,7 +21550,10 @@ function registerMarketTools(server) {
     async ({ instType }) => {
       try {
         const data = await publicApi.getBlockTickers(instType);
-        const arr = data;
+        const arr = data.map((item) => ({
+          ...item,
+          tsIso: item.ts ? new Date(parseInt(item.ts)).toISOString() : void 0
+        }));
         const top = arr.length > 20 ? arr.slice(0, 20) : arr;
         return toResult({ total: arr.length, returned: top.length, data: top });
       } catch (e) {
@@ -21567,7 +21590,13 @@ function registerPublicTools(server) {
     async ({ instId }) => {
       try {
         const data = await publicApi.getFundingRate(instId);
-        return toResult(data);
+        const enriched = data.map((item) => ({
+          ...item,
+          fundingTimeIso: item.fundingTime ? new Date(parseInt(item.fundingTime)).toISOString() : void 0,
+          nextFundingTimeIso: item.nextFundingTime ? new Date(parseInt(item.nextFundingTime)).toISOString() : void 0,
+          tsIso: item.ts ? new Date(parseInt(item.ts)).toISOString() : void 0
+        }));
+        return toResult(enriched);
       } catch (e) {
         return toError(e);
       }
@@ -21808,6 +21837,32 @@ function registerPublicTools(server) {
       }
     }
   );
+  server.tool(
+    "okx_search_instruments",
+    "## \u529F\u80FD\uFF1A\u6309\u5173\u952E\u8BCD\u641C\u7D22\u53EF\u4EA4\u6613\u4EA7\u54C1\uFF08\u73B0\u8D27/\u5408\u7EA6/\u671F\u6743\uFF09\n## \u573A\u666F\uFF1A\u7528\u4E8E\u7528\u6237\u8F93\u5165\u4EA7\u54C1\u540D\u79F0\u6A21\u7CCA\u67E5\u627E instId\u3001\u53D1\u73B0\u65B0\u4EA7\u54C1\u3001\u786E\u8BA4\u67D0\u5E01\u79CD\u6709\u54EA\u4E9B\u53EF\u4EA4\u6613\u4EA7\u54C1\n## \u5173\u952E\u8BCD\uFF1A\u641C\u7D22, \u67E5\u627E\u4EA7\u54C1, search instruments, \u4EA7\u54C1\u641C\u7D22, \u6A21\u7CCA\u67E5\u8BE2, \u5E01\u79CD\u641C\u7D22, find instrument\n## \u53C2\u6570\uFF1A\n##   - keyword: \u641C\u7D22\u5173\u952E\u8BCD\uFF0C\u5982 BTC\u3001ETH\u3001SOL\u3002\u5FC5\u586B\uFF0C\u6700\u5C112\u5B57\u7B26\n##   - instType: \u4EA7\u54C1\u7C7B\u578B\u7B5B\u9009\u3002\u4E0D\u586B\u5219\u641C\u7D22\u5168\u90E8\u7C7B\u578B\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 ~2KB \u2014 \u6700\u591A\u8FD4\u56DE top 20 \u5339\u914D\u7ED3\u679C\n## \u5173\u8054\uFF1A\u672C\u5DE5\u5177\u641C\u7D22\u4EA7\u54C1 \u2192 okx_get_ticker \u67E5\u884C\u60C5 \u2192 okx_place_order \u4E0B\u5355",
+    {
+      keyword: external_exports.string().min(2).describe("\u641C\u7D22\u5173\u952E\u8BCD\uFF0C\u5982 BTC\u3001ETH\u3001SOL\u3002\u6700\u5C112\u4E2A\u5B57\u7B26"),
+      instType: external_exports.enum(["SPOT", "MARGIN", "SWAP", "FUTURES", "OPTION"]).optional().describe("\u4EA7\u54C1\u7C7B\u578B\u7B5B\u9009\uFF0C\u4E0D\u586B\u641C\u7D22\u5168\u90E8")
+    },
+    async ({ keyword, instType }) => {
+      try {
+        const types = instType ? [instType] : ["SPOT", "SWAP", "FUTURES", "OPTION"];
+        const allResults = [];
+        for (const t of types) {
+          const data = await publicApi.getInstruments(t);
+          const kw = keyword.toUpperCase();
+          const matches = data.filter(
+            (item) => item.instId?.toUpperCase().includes(kw) || item.baseCcy?.toUpperCase().includes(kw) || item.uly?.toUpperCase().includes(kw) || item.quoteCcy?.toUpperCase().includes(kw)
+          );
+          allResults.push(...matches);
+        }
+        const top = allResults.slice(0, 20);
+        return toResult({ keyword, total: allResults.length, returned: top.length, data: top });
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/account.ts
@@ -22905,7 +22960,7 @@ function registerOutcomesTools(server) {
     },
     async ({ pageSize, search, includeMarkets }) => {
       const client = getHRailsClient();
-      if (!client) return toError("\u672A\u914D\u7F6E HRAILS_API_KEY", "hrails");
+      if (!client) return toError(new Error("\u672A\u914D\u7F6E HRAILS_API_KEY"));
       try {
         const params = {};
         if (pageSize !== void 0) params.pageSize = pageSize;
@@ -22924,7 +22979,7 @@ function registerOutcomesTools(server) {
     { eventId: external_exports.string().describe("\u4E8B\u4EF6ID") },
     async ({ eventId }) => {
       const client = getHRailsClient();
-      if (!client) return toError("\u672A\u914D\u7F6E HRAILS_API_KEY", "hrails");
+      if (!client) return toError(new Error("\u672A\u914D\u7F6E HRAILS_API_KEY"));
       try {
         const data = await client.getEvent(eventId);
         return toResult(data);
@@ -22939,7 +22994,7 @@ function registerOutcomesTools(server) {
     { marketId: external_exports.string().describe("\u5E02\u573AID") },
     async ({ marketId }) => {
       const client = getHRailsClient();
-      if (!client) return toError("\u672A\u914D\u7F6E HRAILS_API_KEY", "hrails");
+      if (!client) return toError(new Error("\u672A\u914D\u7F6E HRAILS_API_KEY"));
       try {
         const data = await client.getMarket(marketId);
         return toResult(data);
@@ -22957,7 +23012,7 @@ function registerOutcomesTools(server) {
     },
     async ({ marketId, outcome }) => {
       const client = getHRailsClient();
-      if (!client) return toError("\u672A\u914D\u7F6E HRAILS_API_KEY", "hrails");
+      if (!client) return toError(new Error("\u672A\u914D\u7F6E HRAILS_API_KEY"));
       try {
         const data = await client.getTicker(marketId, outcome);
         return toResult(data);
@@ -22976,7 +23031,7 @@ function registerOutcomesTools(server) {
     },
     async ({ marketId, outcome, size }) => {
       const client = getHRailsClient();
-      if (!client) return toError("\u672A\u914D\u7F6E HRAILS_API_KEY", "hrails");
+      if (!client) return toError(new Error("\u672A\u914D\u7F6E HRAILS_API_KEY"));
       try {
         const data = await client.getOrderbook(marketId, outcome, size);
         return toResult(data);
@@ -22996,7 +23051,7 @@ function registerOutcomesTools(server) {
     },
     async ({ marketId, outcome, bar, limit }) => {
       const client = getHRailsClient();
-      if (!client) return toError("\u672A\u914D\u7F6E HRAILS_API_KEY", "hrails");
+      if (!client) return toError(new Error("\u672A\u914D\u7F6E HRAILS_API_KEY"));
       try {
         const data = await client.getCandles(marketId, outcome, bar, limit);
         return toResult(data);
@@ -23005,6 +23060,45 @@ function registerOutcomesTools(server) {
       }
     }
   );
+  server.tool(
+    "outcomes_check_arbitrage",
+    "## \u529F\u80FD\uFF1A\u68C0\u6D4B\u9884\u6D4B\u5E02\u573A\u65E0\u98CE\u9669\u5957\u5229\u673A\u4F1A\uFF08YES+NO\u4E70\u4EF7\u4E4B\u548C < 1.0\uFF09\n## \u573A\u666F\uFF1A\u7528\u4E8E\u81EA\u52A8\u626B\u63CF\u5957\u5229\u7A97\u53E3\u3001\u4F4E\u98CE\u9669\u5957\u5229\u51B3\u7B56\u53C2\u8003\n## \u5173\u952E\u8BCD\uFF1A\u5957\u5229, \u9884\u6D4B\u5E02\u573A\u5957\u5229, arbitrage, \u65E0\u98CE\u9669\u5957\u5229, YES+NO, \u53CC\u8FB9\u5957\u5229\n## \u53C2\u6570\uFF1A\n##   - marketId: \u5E02\u573AID\uFF0C\u5FC5\u586B\n## \u9274\u6743\uFF1A\u26A0\uFE0F \u9700\u8981 HRAILS API Key\n## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u68C0\u6D4B\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528\n## \u8FD4\u56DE\u91CF\uFF1A\u5FAE\u5C0F ~300B\n## \u5173\u8054\uFF1A\u5148\u8C03 outcomes_get_market \u83B7\u53D6\u5E02\u573A \u2192 \u672C\u5DE5\u5177\u68C0\u6D4B\u5957\u5229 \u2192 \u624B\u52A8\u4E0B\u5355",
+    {
+      marketId: external_exports.string().describe("\u5E02\u573AID\uFF0C\u5FC5\u586B")
+    },
+    async ({ marketId }) => {
+      const client = getHRailsClient();
+      if (!client) return toError(new Error("\u672A\u914D\u7F6E HRAILS_API_KEY"));
+      try {
+        const [yesData, noData] = await Promise.all([
+          client.getTicker(marketId, "YES"),
+          client.getTicker(marketId, "NO")
+        ]);
+        const yd = yesData;
+        const nd = noData;
+        const yesAsk = parseFloat(yd?.bestAsk ?? yd?.ask ?? "0");
+        const noAsk = parseFloat(nd?.bestAsk ?? nd?.ask ?? "0");
+        const yesBid = parseFloat(yd?.bestBid ?? yd?.bid ?? "0");
+        const noBid = parseFloat(nd?.bestBid ?? nd?.bid ?? "0");
+        const askSum = yesAsk + noAsk;
+        const bidSum = yesBid + noBid;
+        const hasArbitrage = askSum > 0 && askSum < 1;
+        return toResult({
+          marketId,
+          yesAsk,
+          noAsk,
+          askSum: askSum.toFixed(6),
+          hasArbitrage,
+          arbitrageReturn: hasArbitrage ? ((1 - askSum) / askSum * 100).toFixed(4) + "%" : "\u65E0",
+          tip: hasArbitrage ? `\u540C\u65F6\u4E70\u5165 YES@${yesAsk} + NO@${noAsk}\uFF0C\u6210\u672C=${askSum.toFixed(6)}\uFF0C\u5230\u671F\u4EF7\u503C=1.0\uFF0C\u65E0\u98CE\u9669\u6536\u76CA=${(1 - askSum).toFixed(6)} (${((1 - askSum) / askSum * 100).toFixed(2)}%)` : "\u5F53\u524D\u65E0\u5957\u5229\u673A\u4F1A\uFF08YES\u4E70\u4EF7+NO\u4E70\u4EF7 \u2265 1.0\uFF09",
+          bidSum: bidSum.toFixed(6),
+          spread: (askSum - bidSum).toFixed(6)
+        });
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/bot.ts

package/package.json

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