hvip-mcp-server 0.2.1 → 0.2.3

package/dist/index.js

@@ -21218,6 +21218,7 @@ var privateApi = {
   massCancel: (auth, instType, instFamily) => request("POST", "/api/v5/trade/mass-cancel", { body: { instType, instFamily }, auth }),
   getMaxLoan: (auth, instId, mgnMode) => request("GET", "/api/v5/account/max-loan", { params: { instId, mgnMode }, auth }),
   getInterestAccrued: (auth, instId, ccy, limit) => request("GET", "/api/v5/account/interest-accrued", { params: { instId, ccy, limit }, auth }),
+  getMarginBalance: (auth, instId, mgnMode) => request("GET", "/api/v5/account/margin-balance", { params: { instId, mgnMode }, auth }),
   getOrdersPending: (auth, instType, instId, ordType) => request("GET", "/api/v5/trade/orders-pending", { params: { instType, instId, ordType }, auth }),
   getFills: (auth, instType, instId, limit) => request("GET", "/api/v5/trade/fills", { params: { instType, instId, limit }, auth }),
   getOrdersHistoryArchive: (auth, instType, limit) => request("GET", "/api/v5/trade/orders-history-archive", { params: { instType, limit }, auth }),
@@ -21390,7 +21391,7 @@ function registerMarketTools(server) {
   );
   server.tool(
     "okx_get_tickers",
-    "\u83B7\u53D6\u67D0\u7C7B\u4EA7\u54C1\u7684\u5168\u91CF\u884C\u60C5\u5217\u8868\u3002\u7528\u4E8E\u6279\u91CF\u626B\u63CF\u5E02\u573A\u3001\u5BFB\u627E\u5F02\u5E38\u4EF7\u683C\u6216\u9AD8\u6210\u4EA4\u91CF\u54C1\u79CD\u3002",
+    "\u83B7\u53D6\u67D0\u7C7B\u4EA7\u54C1\u7684\u5168\u91CF\u884C\u60C5\u5217\u8868\u3002\u7528\u4E8E\u6279\u91CF\u626B\u63CF\u5E02\u573A\u3001\u5BFB\u627E\u5F02\u5E38\u4EF7\u683C\u6216\u9AD8\u6210\u4EA4\u91CF\u54C1\u79CD\u3002\u8FD4\u56DE\u5168\u91CF\u6570\u636E(~77KB)\uFF0C\u5DF2\u81EA\u52A8\u622A\u65ADtop20\u3002",
     { instType: external_exports.enum(["SPOT", "SWAP", "FUTURES", "OPTION"]).describe("\u4EA7\u54C1\u7C7B\u578B") },
     async ({ instType }) => {
       try {
@@ -21543,7 +21544,7 @@ function registerMarketTools(server) {
 function registerPublicTools(server) {
   server.tool(
     "okx_get_instruments",
-    "\u83B7\u53D6OKX\u53EF\u4EA4\u6613\u4EA7\u54C1\u5217\u8868\uFF0C\u542B\u4EA7\u54C1\u89C4\u683C\u3001\u6700\u5C0F\u4E0B\u5355\u91CF\u3001\u624B\u7EED\u8D39\u7B49\u7EA7\u7B49\u4FE1\u606F\u3002\u7528\u4E8E\u786E\u8BA4\u67D0\u4EA7\u54C1\u662F\u5426\u53EF\u4EA4\u6613\u3001\u83B7\u53D6\u7CBE\u5EA6\u53C2\u6570\u3002",
+    "\u83B7\u53D6OKX\u53EF\u4EA4\u6613\u4EA7\u54C1\u5217\u8868\uFF0C\u542B\u4EA7\u54C1\u89C4\u683C\u3001\u6700\u5C0F\u4E0B\u5355\u91CF\u3001\u624B\u7EED\u8D39\u7B49\u7EA7\u7B49\u4FE1\u606F\u3002\u7528\u4E8E\u786E\u8BA4\u67D0\u4EA7\u54C1\u662F\u5426\u53EF\u4EA4\u6613\u3001\u83B7\u53D6\u7CBE\u5EA6\u53C2\u6570\u3002\u4E0D\u4F20instType\u5C06\u8FD4\u56DE\u5168\u91CF\u6570\u636E(~200KB)\uFF0C\u5EFA\u8BAE\u6307\u5B9A\u4EA7\u54C1\u7C7B\u578B\u8FC7\u6EE4\u3002",
     {
       instType: external_exports.enum(["SPOT", "MARGIN", "SWAP", "FUTURES", "OPTION"]).describe("\u4EA7\u54C1\u7C7B\u578B"),
       instId: external_exports.string().optional().describe("\u6307\u5B9A\u4EA7\u54C1ID\uFF0C\u4E0D\u586B\u5219\u8FD4\u56DE\u5168\u91CF")
@@ -21572,7 +21573,7 @@ function registerPublicTools(server) {
   );
   server.tool(
     "okx_get_mark_price",
-    "\u83B7\u53D6\u6807\u8BB0\u4EF7\u683C\u3002\u6807\u8BB0\u4EF7\u683C\u7528\u4E8E\u8BA1\u7B97\u6D6E\u52A8\u76C8\u4E8F\u548C\u5F3A\u5E73\u4EF7\u683C\uFF0C\u4E0E\u6307\u6570\u4EF7\u683C\u504F\u5DEE\u8FC7\u5927\u65F6\u5B58\u5728\u5957\u5229\u7A7A\u95F4\u3002",
+    "\u83B7\u53D6\u6807\u8BB0\u4EF7\u683C\u3002\u6807\u8BB0\u4EF7\u683C\u7528\u4E8E\u8BA1\u7B97\u6D6E\u52A8\u76C8\u4E8F\u548C\u5F3A\u5E73\u4EF7\u683C\uFF0C\u4E0E\u6307\u6570\u4EF7\u683C\u504F\u5DEE\u8FC7\u5927\u65F6\u5B58\u5728\u5957\u5229\u7A7A\u95F4\u3002\u4E0D\u4F20instId\u8FD4\u56DE\u5168\u91CF(~30KB)\uFF0C\u5EFA\u8BAE\u6307\u5B9A\u4EA7\u54C1\u8FC7\u6EE4\u3002",
     {
       instType: external_exports.enum(["MARGIN", "SWAP", "FUTURES", "OPTION"]).describe("\u4EA7\u54C1\u7C7B\u578B"),
       instId: external_exports.string().optional().describe("\u4EA7\u54C1ID\uFF0C\u4E0D\u586B\u5219\u8FD4\u56DE\u8BE5\u7C7B\u578B\u5168\u91CF")
@@ -21601,7 +21602,7 @@ function registerPublicTools(server) {
   );
   server.tool(
     "okx_get_open_interest",
-    "\u83B7\u53D6\u5408\u7EA6\u6301\u4ED3\u91CF\u3002\u6301\u4ED3\u91CF\u5FEB\u901F\u589E\u52A0\u901A\u5E38\u610F\u5473\u7740\u65B0\u8D44\u91D1\u5165\u573A\uFF0C\u7ED3\u5408\u4EF7\u683C\u65B9\u5411\u53EF\u5224\u65AD\u8D8B\u52BF\u5F3A\u5EA6\u3002",
+    "\u83B7\u53D6\u5408\u7EA6\u6301\u4ED3\u91CF\u3002\u6301\u4ED3\u91CF\u5FEB\u901F\u589E\u52A0\u901A\u5E38\u610F\u5473\u7740\u65B0\u8D44\u91D1\u5165\u573A\uFF0C\u7ED3\u5408\u4EF7\u683C\u65B9\u5411\u53EF\u5224\u65AD\u8D8B\u52BF\u5F3A\u5EA6\u3002\u4E0D\u4F20instId\u8FD4\u56DE\u5168\u91CF(~77KB)\uFF0C\u5EFA\u8BAE\u6307\u5B9A\u4EA7\u54C1\u8FC7\u6EE4\u3002",
     {
       instType: external_exports.enum(["SWAP", "FUTURES", "OPTION"]).describe("\u4EA7\u54C1\u7C7B\u578B"),
       instId: external_exports.string().optional().describe("\u4EA7\u54C1ID\uFF0C\u4E0D\u586B\u5219\u8FD4\u56DE\u5168\u91CF")
@@ -22132,6 +22133,32 @@ function registerAccountTools(server, auth) {
       }
     }
   );
+  server.tool(
+    "okx_get_margin_balance",
+    `## \u529F\u80FD\uFF1A\u67E5\u8BE2\u67D0\u4EA7\u54C1\u7684\u4FDD\u8BC1\u91D1\u4F59\u989D\u8BE6\u60C5
+## \u573A\u666F\uFF1A\u7528\u4E8E\u6760\u6746/\u5408\u7EA6\u4EA4\u6613\u524D\u67E5\u770B\u53EF\u7528\u4FDD\u8BC1\u91D1\u3001\u5360\u7528\u4FDD\u8BC1\u91D1\u3001\u4FDD\u8BC1\u91D1\u7387
+## \u5173\u952E\u8BCD\uFF1A\u4FDD\u8BC1\u91D1\u4F59\u989D, \u4FDD\u8BC1\u91D1\u7387, margin balance, \u53EF\u7528\u4FDD\u8BC1\u91D1, \u5360\u7528\u4FDD\u8BC1\u91D1
+## \u53C2\u6570\uFF1A
+##   - instId: \u4EA7\u54C1ID\uFF0C\u5982 BTC-USDT\u3002\u5FC5\u586B
+##   - mgnMode: \u4FDD\u8BC1\u91D1\u6A21\u5F0F\u3002cross=\u5168\u4ED3, isolated=\u9010\u4ED3\u3002\u5FC5\u586B
+## \u9274\u6743\uFF1A\u26A0\uFE0F \u9700\u8981 API Key\uFF08\u53EA\u8BFB\uFF09
+## \u98CE\u9669\uFF1AREAD \u2014 \u53EA\u8BFB\u67E5\u8BE2\uFF0CAgent \u53EF\u81EA\u52A8\u8C03\u7528
+## \u8FD4\u56DE\u91CF\uFF1A\u5FAE\u5C0F ~500B
+## \u5173\u8054\uFF1Aokx_get_balance \u67E5\u603B\u4F59\u989D \u2192 \u672C\u5DE5\u5177\u67E5\u4FDD\u8BC1\u91D1 \u2192 okx_get_positions \u67E5\u6301\u4ED3`,
+    {
+      instId: external_exports.string().describe("\u4EA7\u54C1ID\uFF0C\u5982 BTC-USDT\u3002\u5FC5\u586B"),
+      mgnMode: external_exports.enum(["cross", "isolated"]).describe("\u4FDD\u8BC1\u91D1\u6A21\u5F0F\u3002cross=\u5168\u4ED3, isolated=\u9010\u4ED3")
+    },
+    async ({ instId, mgnMode }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const data = await privateApi.getMarginBalance(auth, instId, mgnMode);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/trading.ts
@@ -22583,6 +22610,44 @@ function registerFundingTools(server, auth) {
       }
     }
   );
+  server.tool(
+    "okx_withdrawal",
+    `## \u529F\u80FD\uFF1A\u63D0\u5E01\u5230\u5916\u90E8\u5730\u5740
+## \u573A\u666F\uFF1A\u5C06\u8D44\u4EA7\u4ECEOKX\u63D0\u73B0\u5230\u5916\u90E8\u94B1\u5305\u6216\u4EA4\u6613\u6240
+## \u5173\u952E\u8BCD\uFF1A\u63D0\u5E01, \u63D0\u73B0, withdrawal, \u51FA\u91D1, \u8F6C\u51FA
+## \u53C2\u6570\uFF1A
+##   - ccy: \u5E01\u79CD\uFF0C\u5982 USDT\u3002\u5FC5\u586B
+##   - amt: \u63D0\u5E01\u6570\u91CF\u3002\u5FC5\u586B
+##   - dest: \u63D0\u5E01\u65B9\u5F0F\u30023=\u5185\u90E8\u8F6C\u8D26, 4=\u94FE\u4E0A\u63D0\u5E01\u3002\u5FC5\u586B
+##   - toAddr: \u76EE\u6807\u5730\u5740\u3002\u94FE\u4E0A\u63D0\u5E01\u5FC5\u586B
+##   - chain: \u94FE\u540D\u79F0\uFF0C\u5982 USDT-TRC20\u3002\u94FE\u4E0A\u63D0\u5E01\u5FC5\u586B
+##   - fee: \u624B\u7EED\u8D39\u3002\u53EF\u9009
+## \u9274\u6743\uFF1A\u{1F534} \u9700\u8981 API Key\uFF08\u63D0\u73B0\uFF09- \u8C03\u7528\u524D\u5FC5\u987B\u4E8C\u6B21\u786E\u8BA4
+## \u98CE\u9669\uFF1AFUND_TRANSFER \u2014 \u63D0\u5E01\u64CD\u4F5C\u76F4\u63A5\u8F6C\u51FA\u8D44\u91D1\uFF0C\u8C03\u7528\u524D\u5FC5\u987B\u5411\u7528\u6237\u4E8C\u6B21\u786E\u8BA4
+## \u8FD4\u56DE\u91CF\uFF1A\u5FAE\u5C0F ~500B
+## \u5173\u8054\uFF1Aokx_get_currencies \u67E5\u652F\u6301\u5E01\u79CD \u2192 okx_get_funding_balance \u786E\u8BA4\u4F59\u989D \u2192 \u672C\u5DE5\u5177\u63D0\u5E01`,
+    {
+      ccy: external_exports.string().describe("\u5E01\u79CD\uFF0C\u5982 USDT\u3002\u5FC5\u586B"),
+      amt: external_exports.string().describe("\u63D0\u5E01\u6570\u91CF\u3002\u5FC5\u586B"),
+      dest: external_exports.enum(["3", "4"]).describe("\u63D0\u5E01\u65B9\u5F0F\uFF1A3=\u5185\u90E8\u8F6C\u8D26, 4=\u94FE\u4E0A\u63D0\u5E01"),
+      toAddr: external_exports.string().optional().describe("\u76EE\u6807\u5730\u5740\uFF08\u94FE\u4E0A\u63D0\u5E01\u5FC5\u586B\uFF09"),
+      chain: external_exports.string().optional().describe("\u94FE\u540D\u79F0\uFF0C\u5982 USDT-TRC20"),
+      fee: external_exports.string().optional().describe("\u624B\u7EED\u8D39\uFF0C\u4E0D\u586B\u7528\u9ED8\u8BA4")
+    },
+    async ({ ccy, amt, dest, toAddr, chain, fee }) => {
+      if (!auth) return toError(AUTH_REQUIRED);
+      try {
+        const body = { ccy, amt, dest };
+        if (toAddr) body.toAddr = toAddr;
+        if (chain) body.chain = chain;
+        if (fee) body.fee = fee;
+        const data = await privateApi.withdrawal(auth, body);
+        return toResult(data);
+      } catch (e) {
+        return toError(e);
+      }
+    }
+  );
 }
 
 // src/tools/stats.ts

package/package.json

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