@openfinclaw/findoo-datahub-plugin 2026.3.2 → 2026.3.10

package/index.ts

@@ -20,10 +20,13 @@ function buildParams(params: Record<string, unknown>): Record<string, string> {
   if (params.start_date) out.start_date = String(params.start_date);
   if (params.end_date) out.end_date = String(params.end_date);
   if (params.trade_date) out.trade_date = String(params.trade_date);
+  if (params.date) out.date = String(params.date);
   if (params.limit) out.limit = String(params.limit);
   if (params.provider) out.provider = String(params.provider);
   if (params.country) out.country = String(params.country);
   if (params.indicator) out.indicator = String(params.indicator);
+  if (params.manager) out.manager = String(params.manager);
+  if (params.hs_type) out.hs_type = String(params.hs_type);
   return out;
 }
 
@@ -37,14 +40,21 @@ const findooDatahubPlugin = {
     "172 endpoints covering equity (A/HK/US), crypto, macro, derivatives, index, ETF.",
   kind: "financial" as const,
 
-  async register(api: OpenClawPluginApi) {
+  register(api: OpenClawPluginApi) {
     const config = resolveConfig(api);
 
     // --- DataHub client ---
+    if (!config.datahubApiKey) {
+      api.log?.(
+        "warn",
+        "findoo-datahub-plugin: no API key configured. Set DATAHUB_API_KEY env var or plugins.findoo-datahub-plugin.datahubApiKey in config. Using built-in dev key.",
+      );
+    }
+
     const client = new DataHubClient(
       config.datahubApiUrl,
       config.datahubUsername,
-      config.datahubPassword,
+      config.datahubApiKey ?? "98ffa5c5-1ec6-4735-8e0c-715a5eca1a8d",
       config.requestTimeoutMs,
     );
 
@@ -118,7 +128,7 @@ const findooDatahubPlugin = {
     } as Parameters<typeof api.registerService>[0]);
 
     // ============================================================
-    // AI Tools (10 total)
+    // AI Tools (13 total)
     // ============================================================
 
     // === Tool 1: fin_stock — Equity data ===
@@ -127,7 +137,7 @@ const findooDatahubPlugin = {
         name: "fin_stock",
         label: "Stock Data (A/HK/US)",
         description:
-          "Fetch A-share, HK, or US equity data — quotes, historical prices, income, balance sheet, cashflow, ratios, money flow, holders, dividends, news.",
+          "Fetch A-share, HK, or US equity data — quotes, historical prices, financials (income/balance/cash/ratios/metrics + VIP variants), ownership (top10/shareholder_trade/repurchase/pledge), money flow, concept lists, calendar (earnings/ipo), discovery (gainers/losers), HK subset (hk/*), US subset (us/*). Notes: estimates/consensus is yfinance-only (US/HK, rate-limited, NOT for A-share — use fundamental/earnings_forecast instead). fundamental/stock_factor returns pre-computed MACD/KDJ/RSI/BOLL/CCI. market/stock_limit requires symbol param (no batch scan by date).",
         parameters: Type.Object({
           symbol: Type.String({
             description: "Stock code. A-shares: 600519.SH; HK: 00700.HK; US: AAPL",
@@ -136,17 +146,81 @@ const findooDatahubPlugin = {
             type: "string",
             enum: [
               "price/historical",
+              "price/quote",
+              "profile",
+              "search",
+              "screener",
+              // fundamentals — A-share
               "fundamental/income",
               "fundamental/balance",
               "fundamental/cash",
               "fundamental/ratios",
               "fundamental/metrics",
               "fundamental/dividends",
+              "fundamental/adj_factor",
+              "fundamental/earnings_forecast",
+              "fundamental/financial_audit",
+              "fundamental/financial_express",
+              "fundamental/forecast_vip",
+              "fundamental/revenue_per_segment",
+              "fundamental/management",
+              // ownership & structure
               "ownership/top10_holders",
+              "ownership/top10_float_holders",
+              "ownership/major_holders",
+              "ownership/shareholder_trade",
+              "ownership/repurchase",
+              "ownership/share_float",
+              "ownership/holder_number",
+              "ownership/share_statistics",
+              "pledge/stat",
+              "pledge/detail",
+              // money flow & market
               "moneyflow/individual",
               "market/top_list",
+              // discovery & calendar
               "discovery/gainers",
               "discovery/losers",
+              "discovery/active",
+              "discovery/undervalued_growth",
+              "discovery/undervalued_large_caps",
+              "discovery/growth_tech",
+              "discovery/aggressive_small_caps",
+              "discovery/name_change",
+              "calendar/earnings",
+              "calendar/ipo",
+              "compare/peers",
+              "shorts/short_volume",
+              "concept/concept_detail",
+              "concept/concept_list",
+              // estimates (yfinance only — US/HK stocks, not A-share; may hit rate limits)
+              "estimates/consensus",
+              // additional fundamentals (VIP / tushare-only)
+              "fundamental/backup_daily",
+              "fundamental/balance_vip",
+              "fundamental/cashflow_vip",
+              "fundamental/dividend_detail",
+              "fundamental/historical_splits",
+              "fundamental/income_vip",
+              "fundamental/revenue_segment_vip",
+              "fundamental/stock_factor",
+              // HK
+              "hk/income",
+              "hk/balancesheet",
+              "hk/cashflow",
+              "hk/fina_indicator",
+              "hk/basic",
+              "hk/hold",
+              "hk/adj_factor",
+              "hk/trade_cal",
+              // US
+              "us/income",
+              "us/balancesheet",
+              "us/cashflow",
+              "us/fina_indicator",
+              "us/basic",
+              "us/adj_factor",
+              "us/trade_cal",
             ],
             description: "DataHub equity endpoint path",
           }),
@@ -182,7 +256,7 @@ const findooDatahubPlugin = {
         name: "fin_index",
         label: "Index / ETF / Fund",
         description:
-          "Query index constituents, valuations, ETF prices/NAV, fund manager/portfolio.",
+          "Query index data — constituents, daily valuations (PE/PB via daily_basic), thematic/concept indices (ths_index/ths_daily/ths_member), classification, global indices. Use constituents (not members) for index composition.",
         parameters: Type.Object({
           symbol: Type.Optional(
             Type.String({ description: "Index/ETF/fund code. Index: 000300.SH; ETF: 510050.SH" }),
@@ -193,6 +267,10 @@ const findooDatahubPlugin = {
               "price/historical",
               "constituents",
               "daily_basic",
+              "available",
+              "info",
+              "classify",
+              "global_index",
               "thematic/ths_index",
               "thematic/ths_daily",
               "thematic/ths_member",
@@ -228,7 +306,7 @@ const findooDatahubPlugin = {
         name: "fin_macro",
         label: "Macro / Rates / FX",
         description:
-          "China macro (GDP/CPI/PPI/PMI/M2), interest rates (Shibor/LPR/Libor/Hibor), treasury yields, FX, WorldBank data.",
+          "China macro (GDP/CPI/PPI/PMI/M2/social financing), interest rates (Shibor/LPR/Libor/Hibor), CN/US treasury yields, FX rates (currency/*), WorldBank data (worldbank/*), economic calendar, fixedincome rate aliases (fixedincome/rate/*). Notes: LIBOR terminated 2023 (data stops 2020-06). fixedincome/rate/* are aliases for shibor/libor/hibor. worldbank/country provides country classification for EM vs DM analysis.",
         parameters: Type.Object({
           endpoint: Type.Unsafe<string>({
             type: "string",
@@ -241,18 +319,29 @@ const findooDatahubPlugin = {
               "social_financing",
               "shibor",
               "shibor_lpr",
+              "shibor_quote",
               "libor",
               "hibor",
               "treasury_cn",
               "treasury_us",
               "index_global",
+              "wz_index",
               "calendar",
+              "currency/price/historical",
+              "currency/search",
+              "currency/snapshots",
+              "worldbank/country",
               "worldbank/gdp",
               "worldbank/population",
               "worldbank/inflation",
               "worldbank/indicator",
+              // fixedincome (dedicated DataHub paths, same data as shibor/libor/hibor)
+              "fixedincome/rate/shibor",
+              "fixedincome/rate/shibor_lpr",
+              "fixedincome/rate/libor",
+              "fixedincome/rate/hibor",
             ],
-            description: "DataHub economy endpoint path",
+            description: "DataHub economy/currency endpoint path",
           }),
           symbol: Type.Optional(Type.String({ description: "Currency pair or indicator code" })),
           country: Type.Optional(Type.String({ description: "Country code for WorldBank" })),
@@ -264,10 +353,22 @@ const findooDatahubPlugin = {
           try {
             const endpoint = String(params.endpoint ?? "cpi");
             const qp = buildParams(params);
-            const results = await client.economy(endpoint, qp);
+            // Route currency/* and fixedincome/* endpoints to their categories
+            let results: unknown[];
+            let category: string;
+            if (endpoint.startsWith("currency/")) {
+              results = await client.currency(endpoint.replace("currency/", ""), qp);
+              category = "currency";
+            } else if (endpoint.startsWith("fixedincome/")) {
+              results = await client.query(endpoint, qp);
+              category = "fixedincome";
+            } else {
+              results = await client.economy(endpoint, qp);
+              category = "economy";
+            }
             return json({
               success: true,
-              endpoint: `economy/${endpoint}`,
+              endpoint: `${category}/${endpoint.startsWith("currency/") ? endpoint.replace("currency/", "") : endpoint}`,
               count: results.length,
               results,
             });
@@ -285,7 +386,7 @@ const findooDatahubPlugin = {
         name: "fin_derivatives",
         label: "Futures / Options / CB",
         description:
-          "Futures (daily, holdings, settlement, warehouse, mapping), options (basic, daily, chains), convertible bonds.",
+          "Futures (daily OHLCV, holdings/OI, settlement, warehouse receipts, contract mapping, term structure curve), options (basic info, daily, chains with Greeks/IV), convertible bonds (basic, daily). Use futures/curve for contango/backwardation analysis.",
         parameters: Type.Object({
           symbol: Type.Optional(
             Type.String({ description: "Contract code, e.g. IF2501.CFX, 113xxx.SH (CB)" }),
@@ -299,6 +400,7 @@ const findooDatahubPlugin = {
               "futures/settle",
               "futures/warehouse",
               "futures/mapping",
+              "futures/curve",
               "options/basic",
               "options/daily",
               "options/chains",
@@ -337,7 +439,7 @@ const findooDatahubPlugin = {
         name: "fin_crypto",
         label: "Crypto & DeFi",
         description:
-          "Crypto market data (tickers, orderbook, funding rates) via CEX, DeFi (TVL, yields, stablecoins, fees, DEX volumes) via DefiLlama, market cap rankings via CoinGecko.",
+          "Crypto market data (ticker/orderbook/trades/funding_rate) via CEX, DeFi (protocols/TVL/yields/stablecoins/fees/dex_volumes/bridges/chains) via DefiLlama, market metrics (coin/market/info/categories/trending/global_stats) via CoinGecko. price/historical for crypto OHLCV, search for symbol lookup.",
         parameters: Type.Object({
           endpoint: Type.Unsafe<string>({
             type: "string",
@@ -361,19 +463,42 @@ const findooDatahubPlugin = {
               "defi/stablecoins",
               "defi/fees",
               "defi/dex_volumes",
+              "defi/bridges",
               "defi/coin_prices",
+              "price/historical",
+              "search",
             ],
             description: "DataHub crypto endpoint path",
           }),
           symbol: Type.Optional(
             Type.String({ description: "Coin ID, trading pair, or protocol slug" }),
           ),
+          start_date: Type.Optional(
+            Type.String({ description: "Start date for coin/historical (YYYY-MM-DD)" }),
+          ),
+          end_date: Type.Optional(
+            Type.String({ description: "End date for coin/historical (YYYY-MM-DD)" }),
+          ),
           limit: Type.Optional(Type.Number()),
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
             const endpoint = String(params.endpoint ?? "coin/market");
             const qp = buildParams(params);
+            // Endpoint-specific param mapping for crypto APIs
+            if (qp.symbol) {
+              const coinIdEndpoints = ["coin/historical", "coin/info"];
+              if (coinIdEndpoints.includes(endpoint)) {
+                qp.coin_id = qp.symbol;
+                delete qp.symbol;
+              } else if (endpoint === "defi/protocol_tvl") {
+                qp.protocol = qp.symbol;
+                delete qp.symbol;
+              } else if (endpoint === "defi/coin_prices") {
+                qp.coins = qp.symbol;
+                delete qp.symbol;
+              }
+            }
             const results = await client.crypto(endpoint, qp);
             return json({
               success: true,
@@ -395,7 +520,7 @@ const findooDatahubPlugin = {
         name: "fin_market",
         label: "Market Radar",
         description:
-          "Market monitoring — dragon-tiger list, limit-up/down stats, block trades, sector money flow, margin, Stock Connect flows, global index, IPO calendar.",
+          "A-share market monitoring — dragon-tiger list (top_list/top_inst), limit-up/down stats (limit_list), block trades, sector money flow (moneyflow/industry), margin (summary/detail/trading), Stock Connect northbound (hsgt_flow/hsgt_top10) and southbound (ggt_daily/ggt_monthly), market snapshots, discovery (gainers/losers/active/new_share). Notes: flow/hsgt_top10 requires 'date' param (NOT trade_date). flow/hs_const requires 'hs_type' param (SH or SZ). market/stock_limit requires 'symbol' (no date-only scan). market_snapshots returns full market snapshot (12000+ records, no params needed).",
         parameters: Type.Object({
           endpoint: Type.Unsafe<string>({
             type: "string",
@@ -410,8 +535,14 @@ const findooDatahubPlugin = {
               "moneyflow/block_trade",
               "margin/summary",
               "margin/detail",
+              "margin/trading",
               "flow/hsgt_flow",
               "flow/hsgt_top10",
+              "flow/ggt_daily",
+              "flow/ggt_monthly",
+              "flow/hs_const",
+              "market/stock_limit",
+              "market_snapshots",
               "discovery/gainers",
               "discovery/losers",
               "discovery/active",
@@ -420,7 +551,19 @@ const findooDatahubPlugin = {
             description: "DataHub equity endpoint for market data",
           }),
           trade_date: Type.Optional(Type.String({ description: "Trade date, e.g. 2025-02-28" })),
+          date: Type.Optional(
+            Type.String({
+              description:
+                "Date param for hsgt_top10 (uses 'date' not 'trade_date'), e.g. 2025-02-28",
+            }),
+          ),
           symbol: Type.Optional(Type.String({ description: "Symbol for specific queries" })),
+          hs_type: Type.Optional(
+            Type.String({
+              description:
+                "Stock Connect type for hs_const: SH (northbound) or SZ (northbound Shenzhen)",
+            }),
+          ),
           start_date: Type.Optional(Type.String()),
           end_date: Type.Optional(Type.String()),
           limit: Type.Optional(Type.Number()),
@@ -429,6 +572,17 @@ const findooDatahubPlugin = {
           try {
             const endpoint = String(params.endpoint ?? "market/top_list");
             const qp = buildParams(params);
+            // Auto-alias: trade_date→date for endpoints that use 'date' param
+            const dateEndpoints = [
+              "market/top_list",
+              "market/top_inst",
+              "market/limit_list",
+              "flow/hsgt_top10",
+            ];
+            if (qp.trade_date && !qp.date && dateEndpoints.includes(endpoint)) {
+              qp.date = qp.trade_date;
+              delete qp.trade_date;
+            }
             const results = await client.equity(endpoint, qp);
             return json({
               success: true,
@@ -450,7 +604,7 @@ const findooDatahubPlugin = {
         name: "fin_query",
         label: "Raw DataHub Query",
         description:
-          "Direct passthrough to any of 172 DataHub endpoints by path. Use when other tools don't cover the specific data.",
+          "Direct passthrough to any of 168 DataHub endpoints by path. Use when other tools don't cover the specific data. Accepts arbitrary query params. Example paths: equity/fundamental/income, crypto/defi/protocols, economy/cpi, fixedincome/rate/shibor.",
         parameters: Type.Object({
           path: Type.String({
             description:
@@ -575,7 +729,171 @@ const findooDatahubPlugin = {
       { names: ["fin_data_regime"] },
     );
 
-    // === Tool 10: fin_data_markets — Supported Markets ===
+    // === Tool 10: fin_ta — Technical Analysis Indicators ===
+    api.registerTool(
+      {
+        name: "fin_ta",
+        label: "Technical Analysis",
+        description:
+          "Calculate technical indicators (SMA, EMA, RSI, MACD, Bollinger Bands) for any symbol. DataHub fetches OHLCV and computes server-side.",
+        parameters: Type.Object({
+          symbol: Type.String({
+            description:
+              "Stock/crypto symbol. A: 600519.SH; HK: 00700.HK; US: AAPL; Crypto: BTC-USDT",
+          }),
+          indicator: Type.Unsafe<string>({
+            type: "string",
+            enum: ["sma", "ema", "rsi", "macd", "bbands"],
+            description: "Technical indicator to calculate",
+          }),
+          period: Type.Optional(
+            Type.Number({
+              description: "Indicator period (default: 20 for SMA/EMA/BBANDS, 14 for RSI)",
+            }),
+          ),
+          limit: Type.Optional(
+            Type.Number({ description: "Number of OHLCV bars to fetch (default: 200)" }),
+          ),
+          fast: Type.Optional(Type.Number({ description: "MACD fast period (default: 12)" })),
+          slow: Type.Optional(Type.Number({ description: "MACD slow period (default: 26)" })),
+          signal: Type.Optional(Type.Number({ description: "MACD signal period (default: 9)" })),
+          std: Type.Optional(
+            Type.Number({ description: "Bollinger Bands std dev (default: 2.0)" }),
+          ),
+          provider: Type.Optional(
+            Type.String({ description: "Data provider override (auto-detected if omitted)" }),
+          ),
+        }),
+        async execute(_toolCallId: string, params: Record<string, unknown>) {
+          try {
+            const indicator = String(params.indicator ?? "sma");
+            const qp: Record<string, string> = {};
+            if (params.symbol) qp.symbol = String(params.symbol);
+            if (params.period) qp.period = String(params.period);
+            if (params.limit) qp.limit = String(params.limit);
+            if (params.fast) qp.fast = String(params.fast);
+            if (params.slow) qp.slow = String(params.slow);
+            if (params.signal) qp.signal = String(params.signal);
+            if (params.std) qp.std = String(params.std);
+            if (params.provider) qp.provider = String(params.provider);
+            const results = await client.ta(indicator, qp);
+            return json({
+              success: true,
+              endpoint: `ta/${indicator}`,
+              count: results.length,
+              results,
+            });
+          } catch (err) {
+            return json({ error: err instanceof Error ? err.message : String(err) });
+          }
+        },
+      },
+      { names: ["fin_ta"] },
+    );
+
+    // === Tool 11: fin_etf — ETF & Fund Data ===
+    api.registerTool(
+      {
+        name: "fin_etf",
+        label: "ETF & Fund",
+        description:
+          "ETF and fund data — NAV history, fund info (type/size/fees), historical prices, portfolio holdings (top 10, quarterly), manager track record, dividends, share changes (subscription/redemption trends), adjusted NAV (dividend-reinvested), search. Use fund/manager with a known fund code to find manager info; manager param available for search.",
+        parameters: Type.Object({
+          symbol: Type.Optional(
+            Type.String({
+              description: "ETF/Fund code. ETF: 510050.SH; Fund: 110011",
+            }),
+          ),
+          manager: Type.Optional(
+            Type.String({
+              description: "Fund manager name for search endpoint (e.g. 张坤)",
+            }),
+          ),
+          endpoint: Type.Unsafe<string>({
+            type: "string",
+            enum: [
+              "nav",
+              "info",
+              "historical",
+              "fund/portfolio",
+              "fund/manager",
+              "fund/dividends",
+              "fund/share",
+              "fund/adj_nav",
+              "search",
+            ],
+            description: "DataHub ETF/fund endpoint path",
+          }),
+          start_date: Type.Optional(Type.String({ description: "Start date, e.g. 2025-01-01" })),
+          end_date: Type.Optional(Type.String({ description: "End date, e.g. 2025-12-31" })),
+          limit: Type.Optional(Type.Number({ description: "Max records to return" })),
+        }),
+        async execute(_toolCallId: string, params: Record<string, unknown>) {
+          try {
+            const endpoint = String(params.endpoint ?? "info");
+            const qp = buildParams(params);
+            const results = await client.etf(endpoint, qp);
+            return json({
+              success: true,
+              endpoint: `etf/${endpoint}`,
+              count: results.length,
+              results,
+            });
+          } catch (err) {
+            return json({ error: err instanceof Error ? err.message : String(err) });
+          }
+        },
+      },
+      { names: ["fin_etf"] },
+    );
+
+    // === Tool 12: fin_currency — FX & News ===
+    api.registerTool(
+      {
+        name: "fin_currency",
+        label: "FX & News",
+        description:
+          "Foreign exchange rates (price/historical, search, snapshots) and company news (news/company). Major pairs: USDCNH, EURUSD, USDJPY. Use search to find available currency pair symbols.",
+        parameters: Type.Object({
+          endpoint: Type.Unsafe<string>({
+            type: "string",
+            enum: ["price/historical", "search", "snapshots", "news/company"],
+            description: "DataHub currency/news endpoint path",
+          }),
+          symbol: Type.Optional(
+            Type.String({
+              description: "Currency pair (USDCNH, EURUSD) or stock symbol for news (AAPL)",
+            }),
+          ),
+          start_date: Type.Optional(Type.String({ description: "Start date, e.g. 2025-01-01" })),
+          end_date: Type.Optional(Type.String({ description: "End date, e.g. 2025-12-31" })),
+          limit: Type.Optional(Type.Number({ description: "Max records to return" })),
+        }),
+        async execute(_toolCallId: string, params: Record<string, unknown>) {
+          try {
+            const endpoint = String(params.endpoint ?? "price/historical");
+            const qp = buildParams(params);
+            // Route news/* to the generic query path
+            const results =
+              endpoint === "news/company"
+                ? await client.query(`news/company`, qp)
+                : await client.currency(endpoint, qp);
+            const category = endpoint === "news/company" ? "news" : "currency";
+            return json({
+              success: true,
+              endpoint: `${category}/${endpoint === "news/company" ? "company" : endpoint}`,
+              count: results.length,
+              results,
+            });
+          } catch (err) {
+            return json({ error: err instanceof Error ? err.message : String(err) });
+          }
+        },
+      },
+      { names: ["fin_currency"] },
+    );
+
+    // === Tool 13: fin_data_markets — Supported Markets ===
     api.registerTool(
       {
         name: "fin_data_markets",

package/openclaw.plugin.json

@@ -18,9 +18,9 @@
         "default": "admin",
         "description": "DataHub HTTP Basic Auth username"
       },
-      "datahubPassword": {
+      "datahubApiKey": {
         "type": "string",
-        "description": "DataHub HTTP Basic Auth password",
+        "description": "DataHub API key (required). Set via config or DATAHUB_API_KEY env var.",
         "sensitive": true
       },
       "requestTimeoutMs": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openfinclaw/findoo-datahub-plugin",
-  "version": "2026.3.2",
+  "version": "2026.3.10",
   "description": "Unified financial data source — free mode (CCXT/CoinGecko/DefiLlama/Yahoo) + full mode (172 DataHub endpoints)",
   "keywords": [
     "crypto",