@aicoin/opendata-mcp 1.0.9 → 1.0.10

package/build/index.js

@@ -99,6 +99,13 @@ async function apiPost(path, body = {}) {
 }
 
 // src/tools/utils.ts
+var LIST_KEYS = [
+  "data",
+  "list",
+  "items",
+  "result",
+  "results"
+];
 function ok(data) {
   return {
     content: [
@@ -109,12 +116,47 @@ function ok(data) {
     ]
   };
 }
+function okList(data, max = 50) {
+  if (Array.isArray(data)) {
+    return ok(truncArr(data, max));
+  }
+  if (data && typeof data === "object") {
+    const obj = data;
+    for (const k of LIST_KEYS) {
+      if (Array.isArray(obj[k])) {
+        const arr = obj[k];
+        if (arr.length > max) {
+          return ok({
+            ...obj,
+            [k]: arr.slice(0, max),
+            _truncated: {
+              field: k,
+              total: arr.length,
+              showing: max
+            }
+          });
+        }
+      }
+    }
+  }
+  return ok(data);
+}
+function truncArr(arr, max) {
+  if (arr.length <= max) return arr;
+  return {
+    total: arr.length,
+    showing: max,
+    truncated: true,
+    data: arr.slice(0, max)
+  };
+}
 function err(e) {
+  const msg = e instanceof Error ? e.message : String(e);
   return {
     content: [
       {
         type: "text",
-        text: `Error: ${e.message}`
+        text: `Error: ${msg}`
       }
     ],
     isError: true
@@ -125,11 +167,14 @@ function err(e) {
 function registerCoinTools(server2) {
   server2.tool(
     "get_coin_list",
-    "Get list of all supported coins with basic info",
+    "Get supported coins list (returns top 100 by default, use get_coin_ticker for specific coins)",
     {},
     async () => {
       try {
-        return ok(await apiGet("/api/v2/coin"));
+        return okList(
+          await apiGet("/api/v2/coin"),
+          100
+        );
       } catch (e) {
         return err(e);
       }
@@ -208,7 +253,7 @@ function registerCoinTools(server2) {
           symbol,
           interval
         };
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -268,7 +313,7 @@ function registerCoinTools(server2) {
           symbol,
           interval
         };
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -298,7 +343,7 @@ function registerCoinTools(server2) {
           symbol,
           interval
         };
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -328,7 +373,7 @@ function registerCoinTools(server2) {
           symbol,
           interval
         };
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -360,7 +405,7 @@ function registerCoinTools(server2) {
           symbol,
           interval
         };
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -396,7 +441,7 @@ function registerCoinTools(server2) {
           cycle
         };
         if (leverage) params.leverage = leverage;
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -424,7 +469,7 @@ function registerCoinTools(server2) {
     async ({ key, limit, start_time, end_time }) => {
       try {
         const params = { key };
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -454,7 +499,7 @@ function registerCoinTools(server2) {
       try {
         const params = { key };
         if (amount) params.amount = amount;
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -482,7 +527,7 @@ function registerCoinTools(server2) {
     async ({ dbkey, limit, start_time, end_time }) => {
       try {
         const params = { dbkey };
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "100";
         if (start_time) params.start_time = start_time;
         if (end_time) params.end_time = end_time;
         return ok(
@@ -512,7 +557,7 @@ function registerContentTools(server2) {
       try {
         const params = {};
         if (page) params.page = page;
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "20";
         return ok(
           await apiGet("/api/v2/content/newsflash", params)
         );
@@ -532,7 +577,7 @@ function registerContentTools(server2) {
       try {
         const params = {};
         if (page) params.page = page;
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "20";
         return ok(
           await apiGet("/api/v2/content/news-list", params)
         );
@@ -568,7 +613,7 @@ function registerContentTools(server2) {
       try {
         const params = {};
         if (page) params.page = page;
-        if (pageSize) params.pageSize = pageSize;
+        params.pageSize = pageSize ?? "20";
         return ok(
           await apiGet(
             "/api/v2/content/square/market/news-list",
@@ -592,11 +637,12 @@ function registerContentTools(server2) {
         const params = {};
         if (language) params.language = language;
         if (createtime) params.createtime = createtime;
-        return ok(
+        return okList(
           await apiGet(
             "/api/v2/content/flashList",
             params
-          )
+          ),
+          30
         );
       } catch (e) {
         return err(e);
@@ -614,7 +660,7 @@ function registerContentTools(server2) {
       try {
         const params = {};
         if (page) params.page = page;
-        if (limit) params.limit = limit;
+        params.limit = limit ?? "20";
         return ok(
           await apiGet(
             "/api/v2/content/exchange-listing-flash",
@@ -651,7 +697,7 @@ function registerMarketTools(server2) {
           symbol
         };
         if (period) params.period = period;
-        if (size) params.size = size;
+        params.size = size ?? "100";
         if (since) params.since = since;
         if (open_time) params.open_time = open_time;
         return ok(
@@ -751,7 +797,7 @@ function registerMarketTools(server2) {
           params.us_stock = String(us_stock);
         if (hk_stock != null)
           params.hk_stock = String(hk_stock);
-        if (limit != null) params.limit = String(limit);
+        params.limit = String(limit ?? 30);
         return ok(
           await apiGet(
             "/api/upgrade/v2/crypto_stock/top-gainer",
@@ -795,11 +841,12 @@ function registerMarketTools(server2) {
       try {
         const params = { key };
         if (currency) params.currency = currency;
-        return ok(
+        return okList(
           await apiGet(
             "/api/v2/market/hotTabCoins",
             params
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -851,8 +898,9 @@ function registerMarketTools(server2) {
     {},
     async () => {
       try {
-        return ok(
-          await apiGet("/api/v2/index/getIndex")
+        return okList(
+          await apiGet("/api/v2/index/getIndex"),
+          50
         );
       } catch (e) {
         return err(e);
@@ -916,7 +964,7 @@ function registerMarketTools(server2) {
           indicator_key
         };
         if (period) params.period = period;
-        if (size) params.size = size;
+        params.size = size ?? "100";
         if (since) params.since = since;
         if (open_time) params.open_time = open_time;
         return ok(
@@ -965,11 +1013,12 @@ function registerMarketTools(server2) {
       try {
         const body = { coin };
         if (entity_id) body.entity_id = entity_id;
-        return ok(
+        return okList(
           await apiPost(
             "/api/upgrade/v2/coin-treasuries/history",
             body
-          )
+          ),
+          100
         );
       } catch (e) {
         return err(e);
@@ -987,11 +1036,12 @@ function registerMarketTools(server2) {
       try {
         const body = { coin };
         if (entity_id) body.entity_id = entity_id;
-        return ok(
+        return okList(
           await apiPost(
             "/api/upgrade/v2/coin-treasuries/history/accumulated",
             body
-          )
+          ),
+          100
         );
       } catch (e) {
         return err(e);
@@ -1082,11 +1132,12 @@ function registerMarketTools(server2) {
     },
     async ({ coin }) => {
       try {
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/futures/full-depth",
             { coin }
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1101,11 +1152,12 @@ function registerMarketTools(server2) {
     },
     async ({ coin }) => {
       try {
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/futures/full-depth/grouped",
             { coin }
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1148,8 +1200,9 @@ function registerFeatureTools(server2) {
         const params = {};
         if (coin) params.coin = coin;
         if (period) params.period = period;
-        return ok(
-          await apiGet("/api/v2/mix/liq", params)
+        return okList(
+          await apiGet("/api/v2/mix/liq", params),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1290,8 +1343,9 @@ function registerFeatureTools(server2) {
     {},
     async () => {
       try {
-        return ok(
-          await apiGet("/api/v2/mix/stock-market")
+        return okList(
+          await apiGet("/api/v2/mix/stock-market"),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1402,11 +1456,12 @@ function registerFeatureTools(server2) {
         const params = {};
         if (type) params.type = type;
         if (currency) params.currency = currency;
-        return ok(
+        return okList(
           await apiGet(
             "/api/v2/signal/changeSignal",
             params
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1445,8 +1500,9 @@ function registerFeatureTools(server2) {
           platform
         };
         if (type) params.type = type;
-        return ok(
-          await apiGet("/api/v2/trading-pair", params)
+        return okList(
+          await apiGet("/api/v2/trading-pair", params),
+          100
         );
       } catch (e) {
         return err(e);
@@ -1460,11 +1516,14 @@ import { z as z5 } from "zod";
 function registerHyperliquidTools(server2) {
   server2.tool(
     "hl_get_tickers",
-    "Get all Hyperliquid ticker data",
+    "Get Hyperliquid ticker data (truncated to top 50, use hl_get_ticker_by_coin for specific coin)",
     {},
     async () => {
       try {
-        return ok(await apiGet("/api/upgrade/v2/hl/tickers"));
+        return okList(
+          await apiGet("/api/upgrade/v2/hl/tickers"),
+          50
+        );
       } catch (e) {
         return err(e);
       }
@@ -1498,11 +1557,12 @@ function registerHyperliquidTools(server2) {
         const params = {};
         if (coin) params.coin = coin;
         if (min_usd) params.min_usd = min_usd;
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/hl/whales/open-positions",
             params
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1519,11 +1579,12 @@ function registerHyperliquidTools(server2) {
       try {
         const params = {};
         if (coin) params.coin = coin;
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/hl/liquidations/history",
             params
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1565,8 +1626,9 @@ function registerHyperliquidTools(server2) {
         if (extra_params) {
           Object.assign(body, JSON.parse(extra_params));
         }
-        return ok(
-          await apiPost("/api/upgrade/v2/hl/info", body)
+        return okList(
+          await apiPost("/api/upgrade/v2/hl/info", body),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1581,8 +1643,9 @@ function registerHyperliquidTools(server2) {
     },
     async ({ address }) => {
       try {
-        return ok(
-          await apiGet(`/api/upgrade/v2/hl/fills/${address}`)
+        return okList(
+          await apiGet(`/api/upgrade/v2/hl/fills/${address}`),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1633,11 +1696,12 @@ function registerHyperliquidTools(server2) {
       try {
         const params = {};
         if (coin) params.coin = coin;
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/hl/fills/top-trades",
             params
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1652,10 +1716,11 @@ function registerHyperliquidTools(server2) {
     },
     async ({ address }) => {
       try {
-        return ok(
+        return okList(
           await apiGet(
             `/api/upgrade/v2/hl/filled-orders/${address}/latest`
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1688,10 +1753,11 @@ function registerHyperliquidTools(server2) {
     },
     async ({ address }) => {
       try {
-        return ok(
+        return okList(
           await apiGet(
             `/api/upgrade/v2/hl/orders/${address}/latest`
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1724,11 +1790,12 @@ function registerHyperliquidTools(server2) {
       try {
         const params = {};
         if (coin) params.coin = coin;
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/hl/orders/top-open-orders",
             params
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -1785,8 +1852,9 @@ function registerHyperliquidTools(server2) {
     },
     async ({ address }) => {
       try {
-        return ok(
-          await apiGet(`/api/upgrade/v2/hl/pnls/${address}`)
+        return okList(
+          await apiGet(`/api/upgrade/v2/hl/pnls/${address}`),
+          100
         );
       } catch (e) {
         return err(e);
@@ -1851,10 +1919,11 @@ function registerHyperliquidTools(server2) {
     },
     async ({ address }) => {
       try {
-        return ok(
+        return okList(
           await apiGet(
             `/api/upgrade/v2/hl/traders/${address}/completed-trades`
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -2022,11 +2091,12 @@ function registerHyperliquidTools(server2) {
       try {
         const params = {};
         if (coin) params.coin = coin;
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/hl/whales/latest-events",
             params
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -2064,11 +2134,12 @@ function registerHyperliquidTools(server2) {
       try {
         const params = {};
         if (coin) params.coin = coin;
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/hl/whales/history-long-ratio",
             params
-          )
+          ),
+          100
         );
       } catch (e) {
         return err(e);
@@ -2120,11 +2191,12 @@ function registerHyperliquidTools(server2) {
       try {
         const params = {};
         if (coin) params.coin = coin;
-        return ok(
+        return okList(
           await apiGet(
             "/api/upgrade/v2/hl/liquidations/top-positions",
             params
-          )
+          ),
+          50
         );
       } catch (e) {
         return err(e);
@@ -2232,10 +2304,11 @@ function registerHyperliquidTools(server2) {
     },
     async ({ coin, interval }) => {
       try {
-        return ok(
+        return okList(
           await apiGet(
             `/api/upgrade/v2/hl/klines-with-taker-vol/${coin}/${interval}`
-          )
+          ),
+          100
         );
       } catch (e) {
         return err(e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aicoin/opendata-mcp",
-  "version": "1.0.9",
+  "version": "1.0.10",
   "description": "AiCoin OpenData MCP Server - crypto market data via AiCoin Open API",
   "main": "build/index.js",
   "type": "module",