@aicoin/opendata-mcp 1.0.17 → 1.0.19

package/build/index.js

@@ -44,14 +44,11 @@ Endpoint: ${path}`;
   }
   throw new Error(msg);
 }
+var FREE_KEY = "ronJ8uI0Yj2soAfGVs5H1YALUIINbE22";
+var FREE_SECRET = "CWHZcH2us1CLSE7grroR1TpS0Z1JxTwU";
 function getCredentials() {
-  const key = process.env.AICOIN_ACCESS_KEY_ID;
-  const secret = process.env.AICOIN_ACCESS_SECRET;
-  if (!key || !secret) {
-    throw new Error(
-      "Missing AICOIN_ACCESS_KEY_ID or AICOIN_ACCESS_SECRET. Register at https://www.aicoin.com/opendata to get your API credentials."
-    );
-  }
+  const key = process.env.AICOIN_ACCESS_KEY_ID || FREE_KEY;
+  const secret = process.env.AICOIN_ACCESS_SECRET || FREE_SECRET;
   return { key, secret };
 }
 async function apiGet(path, params = {}) {
@@ -376,7 +373,9 @@ function registerCoinTools(server2) {
     "Get aggregated stablecoin-margined open interest history",
     {
       symbol: z2.string().describe("Coin symbol, e.g. BTC"),
-      interval: z2.string().describe("Interval: 1m,2m,15m,30m"),
+      interval: z2.string().describe(
+        "Interval: 1m,3m,5m,15m,30m,1h,4h,6h,8h,12h,1d,1w"
+      ),
       limit: z2.string().optional().describe("Number of records, default 100"),
       start_time: z2.string().optional().describe("Start time in ms"),
       end_time: z2.string().optional().describe("End time in ms")
@@ -406,7 +405,9 @@ function registerCoinTools(server2) {
     "Get aggregated coin-margined open interest history",
     {
       symbol: z2.string().describe("Coin symbol, e.g. BTC"),
-      interval: z2.string().describe("Interval: 1m,2m,15m,30m"),
+      interval: z2.string().describe(
+        "Interval: 1m,3m,5m,15m,30m,1h,4h,6h,8h,12h,1d,1w"
+      ),
       limit: z2.string().optional().describe("Number of records, default 100"),
       start_time: z2.string().optional().describe("Start time in ms"),
       end_time: z2.string().optional().describe("End time in ms")
@@ -796,14 +797,23 @@ function registerMarketTools(server2) {
     "get_futures_interest",
     "Get futures open interest data",
     {
-      coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
-      ...maxItemsParam
+      lan: z4.string().optional().describe("Language: cn or en"),
+      page: z4.string().optional().describe("Page number"),
+      pageSize: z4.string().optional().describe("Page size, max 20"),
+      currency: z4.string().optional().describe("Currency: cny or usd")
     },
-    async ({ coin, _max_items }) => {
+    async ({ lan, page, pageSize, currency }) => {
       try {
-        return okList(
-          await apiGet("/api/v2/futures/interest", { coin }),
-          parseMax(_max_items, 50)
+        const params = {};
+        if (lan) params.lan = lan;
+        if (page) params.page = page;
+        if (pageSize) params.pageSize = pageSize;
+        if (currency) params.currency = currency;
+        return ok(
+          await apiGet(
+            "/api/v2/futures/interest",
+            params
+          )
         );
       } catch (e) {
         return err(e);
@@ -1037,12 +1047,37 @@ function registerMarketTools(server2) {
       coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
       entity_type: z4.string().optional().describe(
         "Entity type: public-companies, eth-treasuries, etc."
-      )
+      ),
+      name: z4.string().optional().describe("Entity name fuzzy search"),
+      ticker: z4.string().optional().describe("Stock ticker filter"),
+      start_date: z4.string().optional().describe("Start date, ISO 8601"),
+      end_date: z4.string().optional().describe("End date, ISO 8601"),
+      page: z4.string().optional().describe("Page number, default 1"),
+      page_size: z4.string().optional().describe("Page size, default 20, max 100"),
+      sort_order: z4.string().optional().describe("Sort: asc or desc, default desc")
     },
-    async ({ coin, entity_type }) => {
+    async ({
+      coin,
+      entity_type,
+      name,
+      ticker,
+      start_date,
+      end_date,
+      page,
+      page_size,
+      sort_order
+    }) => {
       try {
         const body = { coin };
         if (entity_type) body.entity_type = entity_type;
+        if (name) body.name = name;
+        if (ticker) body.ticker = ticker;
+        if (start_date) body.start_date = start_date;
+        if (end_date) body.end_date = end_date;
+        if (page) body.page = Number(page);
+        if (page_size)
+          body.page_size = Number(page_size);
+        if (sort_order) body.sort_order = sort_order;
         return ok(
           await apiPost(
             "/api/upgrade/v2/coin-treasuries/entities",
@@ -1059,19 +1094,42 @@ function registerMarketTools(server2) {
     "Get coin treasury historical data",
     {
       coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
-      entity_id: z4.string().optional().describe("Entity ID filter"),
-      ...maxItemsParam
+      name: z4.string().optional().describe("Entity name filter"),
+      type: z4.string().optional().describe("Trade type: Buy or Sell"),
+      start_date: z4.string().optional().describe("Start date, ISO 8601"),
+      end_date: z4.string().optional().describe("End date, ISO 8601"),
+      page: z4.string().optional().describe("Page number, default 1"),
+      page_size: z4.string().optional().describe("Page size, default 20"),
+      sort_by: z4.string().optional().describe("Sort field, default date"),
+      sort_order: z4.string().optional().describe("Sort: asc or desc, default desc")
     },
-    async ({ coin, entity_id, _max_items }) => {
+    async ({
+      coin,
+      name,
+      type,
+      start_date,
+      end_date,
+      page,
+      page_size,
+      sort_by,
+      sort_order
+    }) => {
       try {
         const body = { coin };
-        if (entity_id) body.entity_id = entity_id;
-        return okList(
+        if (name) body.name = name;
+        if (type) body.type = type;
+        if (start_date) body.start_date = start_date;
+        if (end_date) body.end_date = end_date;
+        if (page) body.page = Number(page);
+        if (page_size)
+          body.page_size = Number(page_size);
+        if (sort_by) body.sort_by = sort_by;
+        if (sort_order) body.sort_order = sort_order;
+        return ok(
           await apiPost(
             "/api/upgrade/v2/coin-treasuries/history",
             body
-          ),
-          parseMax(_max_items, 100)
+          )
         );
       } catch (e) {
         return err(e);
@@ -1083,19 +1141,33 @@ function registerMarketTools(server2) {
     "Get accumulated coin treasury historical data",
     {
       coin: z4.string().describe("Coin ticker, e.g. BTC, ETH"),
-      entity_id: z4.string().optional().describe("Entity ID filter"),
-      ...maxItemsParam
+      entity_type: z4.string().optional().describe("Entity type filter"),
+      start_date: z4.string().optional().describe("Start date, ISO 8601"),
+      end_date: z4.string().optional().describe("End date, ISO 8601"),
+      interval: z4.string().optional().describe(
+        "Interval: daily, weekly, or monthly"
+      )
     },
-    async ({ coin, entity_id, _max_items }) => {
+    async ({
+      coin,
+      entity_type,
+      start_date,
+      end_date,
+      interval
+    }) => {
       try {
         const body = { coin };
-        if (entity_id) body.entity_id = entity_id;
-        return okList(
+        if (entity_type)
+          body.entity_type = entity_type;
+        if (start_date)
+          body.start_date = start_date;
+        if (end_date) body.end_date = end_date;
+        if (interval) body.interval = interval;
+        return ok(
           await apiPost(
             "/api/upgrade/v2/coin-treasuries/history/accumulated",
             body
-          ),
-          parseMax(_max_items, 100)
+          )
         );
       } catch (e) {
         return err(e);
@@ -1244,16 +1316,11 @@ function registerFeatureTools(server2) {
   server2.tool(
     "get_ls_ratio",
     "Get long/short ratio data",
-    {
-      coin: z5.string().describe("Coin key, e.g. bitcoin"),
-      period: z5.string().optional().describe("Period filter")
-    },
-    async ({ coin, period }) => {
+    {},
+    async () => {
       try {
-        const params = { coin };
-        if (period) params.period = period;
         return ok(
-          await apiGet("/api/v2/mix/ls-ratio", params)
+          await apiGet("/api/v2/mix/ls-ratio")
         );
       } catch (e) {
         return err(e);
@@ -1264,18 +1331,22 @@ function registerFeatureTools(server2) {
     "get_liquidation_data",
     "Get liquidation/forced-close data",
     {
-      coin: z5.string().optional().describe("Coin key filter"),
-      period: z5.string().optional().describe("Period filter"),
-      ...maxItemsParam
+      currency: z5.string().optional().describe("Currency: cny or usd, default cny"),
+      type: z5.string().optional().describe(
+        "Query type: 1=by coin, 2=by platform"
+      ),
+      coinKey: z5.string().optional().describe("Coin key, used when type=1"),
+      marketKey: z5.string().optional().describe("Market key, used when type=2")
     },
-    async ({ coin, period, _max_items }) => {
+    async ({ currency, type, coinKey, marketKey }) => {
       try {
         const params = {};
-        if (coin) params.coin = coin;
-        if (period) params.period = period;
-        return okList(
-          await apiGet("/api/v2/mix/liq", params),
-          parseMax(_max_items, 50)
+        if (currency) params.currency = currency;
+        if (type) params.type = type;
+        if (coinKey) params.coinKey = coinKey;
+        if (marketKey) params.marketKey = marketKey;
+        return ok(
+          await apiGet("/api/v2/mix/liq", params)
         );
       } catch (e) {
         return err(e);
@@ -1379,10 +1450,16 @@ function registerFeatureTools(server2) {
   server2.tool(
     "get_nav",
     "Get navigation bar data (market overview)",
-    {},
-    async () => {
+    {
+      lan: z5.string().optional().describe("Language: cn or en")
+    },
+    async ({ lan }) => {
       try {
-        return ok(await apiGet("/api/v2/mix/nav"));
+        const params = {};
+        if (lan) params.lan = lan;
+        return ok(
+          await apiGet("/api/v2/mix/nav", params)
+        );
       } catch (e) {
         return err(e);
       }
@@ -1440,18 +1517,12 @@ function registerFeatureTools(server2) {
   server2.tool(
     "get_signal_alert",
     "Get signal alert data",
-    {
-      coin: z5.string().optional().describe("Coin key filter"),
-      ...maxItemsParam
-    },
-    async ({ coin, _max_items }) => {
+    { ...maxItemsParam },
+    async ({ _max_items }) => {
       try {
-        const params = {};
-        if (coin) params.coin = coin;
         return okList(
           await apiGet(
-            "/api/v2/signal/signalAlert",
-            params
+            "/api/v2/signal/signalAlert"
           ),
           parseMax(_max_items, 50)
         );
@@ -1463,11 +1534,18 @@ function registerFeatureTools(server2) {
   server2.tool(
     "get_signal_alert_config",
     "Get signal alert configuration options",
-    {},
-    async () => {
+    {
+      lan: z5.string().optional().describe("Language: cn or en")
+    },
+    async ({ lan }) => {
       try {
+        const params = {};
+        if (lan) params.lan = lan;
         return ok(
-          await apiGet("/api/v2/signal/signalAlertConf")
+          await apiGet(
+            "/api/v2/signal/signalAlertConf",
+            params
+          )
         );
       } catch (e) {
         return err(e);
@@ -1497,11 +1575,17 @@ function registerFeatureTools(server2) {
     "add_signal_alert",
     "Add a new signal alert",
     {
-      params_json: z5.string().describe("Alert params as JSON string")
+      subType: z5.string().describe("Alert sub type"),
+      symbol: z5.string().describe("Trading pair symbol"),
+      remark: z5.string().optional().describe("Alert remark/note")
     },
-    async ({ params_json }) => {
+    async ({ subType, symbol, remark }) => {
       try {
-        const params = JSON.parse(params_json);
+        const params = {
+          subType,
+          symbol
+        };
+        if (remark) params.remark = remark;
         return ok(
           await apiGet(
             "/api/v2/signal/addSignalAlert",
@@ -1688,13 +1772,17 @@ function registerHyperliquidTools(server2) {
     "hl_get_trader_stats",
     "Get Hyperliquid trader statistics by address",
     {
-      address: z6.string().describe("Wallet address, e.g. 0x...")
+      address: z6.string().describe("Wallet address, e.g. 0x..."),
+      period: z6.string().optional().describe("Period in days, e.g. 7, 30")
     },
-    async ({ address }) => {
+    async ({ address, period }) => {
       try {
+        const params = {};
+        if (period) params.period = period;
         return ok(
           await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/addr-stat`
+            `/api/upgrade/v2/hl/traders/${address}/addr-stat`,
+            params
           )
         );
       } catch (e) {
@@ -1734,12 +1822,20 @@ function registerHyperliquidTools(server2) {
     "Get Hyperliquid user trade fills by wallet address",
     {
       address: z6.string().describe("Wallet address, e.g. 0x..."),
+      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
+      limit: z6.string().optional().describe("Max results"),
       ...maxItemsParam
     },
-    async ({ address, _max_items }) => {
+    async ({ address, coin, limit, _max_items }) => {
       try {
+        const params = {};
+        if (coin) params.coin = coin;
+        if (limit) params.limit = limit;
         return okList(
-          await apiGet(`/api/upgrade/v2/hl/fills/${address}`),
+          await apiGet(
+            `/api/upgrade/v2/hl/fills/${address}`,
+            params
+          ),
           parseMax(_max_items, 50)
         );
       } catch (e) {
@@ -1786,12 +1882,16 @@ function registerHyperliquidTools(server2) {
     "Get Hyperliquid top trades",
     {
       coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
+      interval: z6.string().optional().describe("Interval, e.g. 4h, 1d"),
+      limit: z6.string().optional().describe("Max results"),
       ...maxItemsParam
     },
-    async ({ coin, _max_items }) => {
+    async ({ coin, interval, limit, _max_items }) => {
       try {
         const params = {};
         if (coin) params.coin = coin;
+        if (interval) params.interval = interval;
+        if (limit) params.limit = limit;
         return okList(
           await apiGet(
             "/api/upgrade/v2/hl/fills/top-trades",
@@ -1809,13 +1909,19 @@ function registerHyperliquidTools(server2) {
     "Get filled orders by wallet address",
     {
       address: z6.string().describe("Wallet address"),
+      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
+      limit: z6.string().optional().describe("Max results, default 1000"),
       ...maxItemsParam
     },
-    async ({ address, _max_items }) => {
+    async ({ address, coin, limit, _max_items }) => {
       try {
+        const params = {};
+        if (coin) params.coin = coin;
+        if (limit) params.limit = limit;
         return okList(
           await apiGet(
-            `/api/upgrade/v2/hl/filled-orders/${address}/latest`
+            `/api/upgrade/v2/hl/filled-orders/${address}/latest`,
+            params
           ),
           parseMax(_max_items, 50)
         );
@@ -1847,13 +1953,19 @@ function registerHyperliquidTools(server2) {
     "Get latest orders by wallet address",
     {
       address: z6.string().describe("Wallet address"),
+      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
+      limit: z6.string().optional().describe("Max results, default 2000"),
       ...maxItemsParam
     },
-    async ({ address, _max_items }) => {
+    async ({ address, coin, limit, _max_items }) => {
       try {
+        const params = {};
+        if (coin) params.coin = coin;
+        if (limit) params.limit = limit;
         return okList(
           await apiGet(
-            `/api/upgrade/v2/hl/orders/${address}/latest`
+            `/api/upgrade/v2/hl/orders/${address}/latest`,
+            params
           ),
           parseMax(_max_items, 50)
         );
@@ -1883,12 +1995,16 @@ function registerHyperliquidTools(server2) {
     "Get top open orders on Hyperliquid",
     {
       coin: z6.string().optional().describe("Coin filter"),
+      min_val: z6.string().optional().describe("Min order value filter"),
+      limit: z6.string().optional().describe("Max results"),
       ...maxItemsParam
     },
-    async ({ coin, _max_items }) => {
+    async ({ coin, min_val, limit, _max_items }) => {
       try {
         const params = {};
         if (coin) params.coin = coin;
+        if (min_val) params.min_val = min_val;
+        if (limit) params.limit = limit;
         return okList(
           await apiGet(
             "/api/upgrade/v2/hl/orders/top-open-orders",
@@ -1905,12 +2021,17 @@ function registerHyperliquidTools(server2) {
     "hl_get_active_stats",
     "Get active order statistics",
     {
-      coin: z6.string().optional().describe("Coin filter")
+      coin: z6.string().optional().describe("Coin filter"),
+      whale_threshold: z6.string().optional().describe(
+        "Whale threshold (order value limitPx * sz)"
+      )
     },
-    async ({ coin }) => {
+    async ({ coin, whale_threshold }) => {
       try {
         const params = {};
         if (coin) params.coin = coin;
+        if (whale_threshold)
+          params.whale_threshold = whale_threshold;
         return ok(
           await apiGet(
             "/api/upgrade/v2/hl/orders/active-stats",
@@ -1950,12 +2071,20 @@ function registerHyperliquidTools(server2) {
     "Get PNL curve data by address",
     {
       address: z6.string().describe("Wallet address"),
+      period: z6.string().optional().describe(
+        "Period in days: 0(allTime), 1, 7, 30"
+      ),
       ...maxItemsParam
     },
-    async ({ address, _max_items }) => {
+    async ({ address, period, _max_items }) => {
       try {
+        const params = {};
+        if (period) params.period = period;
         return okList(
-          await apiGet(`/api/upgrade/v2/hl/pnls/${address}`),
+          await apiGet(
+            `/api/upgrade/v2/hl/pnls/${address}`,
+            params
+          ),
           parseMax(_max_items, 100)
         );
       } catch (e) {
@@ -2018,13 +2147,19 @@ function registerHyperliquidTools(server2) {
     "Get completed trades list by address",
     {
       address: z6.string().describe("Wallet address"),
+      coin: z6.string().optional().describe("Coin filter, e.g. BTC"),
+      limit: z6.string().optional().describe("Max results, default 100"),
       ...maxItemsParam
     },
-    async ({ address, _max_items }) => {
+    async ({ address, coin, limit, _max_items }) => {
       try {
+        const params = {};
+        if (coin) params.coin = coin;
+        if (limit) params.limit = limit;
         return okList(
           await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/completed-trades`
+            `/api/upgrade/v2/hl/traders/${address}/completed-trades`,
+            params
           ),
           parseMax(_max_items, 50)
         );
@@ -2057,13 +2192,23 @@ function registerHyperliquidTools(server2) {
     "Get completed position history for a coin",
     {
       address: z6.string().describe("Wallet address"),
-      coin: z6.string().describe("Coin, e.g. BTC")
+      coin: z6.string().describe("Coin, e.g. BTC"),
+      startTime: z6.string().optional().describe(
+        "Start time in ms, at least one of startTime/endTime required"
+      ),
+      endTime: z6.string().optional().describe(
+        "End time in ms, at least one of startTime/endTime required"
+      )
     },
-    async ({ address, coin }) => {
+    async ({ address, coin, startTime, endTime }) => {
       try {
+        const params = {};
+        if (startTime) params.startTime = startTime;
+        if (endTime) params.endTime = endTime;
         return ok(
           await apiGet(
-            `/api/upgrade/v2/hl/traders/${address}/completed-position-history/${coin}`
+            `/api/upgrade/v2/hl/traders/${address}/completed-position-history/${coin}`,
+            params
           )
         );
       } catch (e) {

package/package.json

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