@openfinclaw/findoo-datahub-plugin 2026.3.10 → 2026.3.12

package/index.ts

@@ -46,23 +46,28 @@ const findooDatahubPlugin = {
     // --- 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.",
+        "error",
+        "findoo-datahub-plugin: API key is required. Set DATAHUB_API_KEY env var or configure in Control UI → Plugins → Findoo DataHub.",
       );
     }
 
-    const client = new DataHubClient(
-      config.datahubApiUrl,
-      config.datahubUsername,
-      config.datahubApiKey ?? "98ffa5c5-1ec6-4735-8e0c-715a5eca1a8d",
-      config.requestTimeoutMs,
-    );
+    const client = config.datahubApiKey
+      ? new DataHubClient(
+          config.datahubApiUrl,
+          config.datahubUsername,
+          config.datahubApiKey,
+          config.requestTimeoutMs,
+        )
+      : null;
 
     // --- Local cache + regime detector ---
     const dbPath = api.resolvePath("state/findoo-ohlcv-cache.sqlite");
     const cache = new OHLCVCache(dbPath);
     const regimeDetector = new RegimeDetector();
 
+    const NO_KEY_ERROR =
+      "DataHub API key not configured. Set DATAHUB_API_KEY env var or configure in Control UI → Plugins → Findoo DataHub.";
+
     // --- Data provider service (exposed to other extensions) ---
     const dataProvider = {
       async getOHLCV(params: {
@@ -72,6 +77,8 @@ const findooDatahubPlugin = {
         since?: number;
         limit?: number;
       }) {
+        if (!client) throw new Error(NO_KEY_ERROR);
+
         // Check cache first
         const range = cache.getRange(params.symbol, params.market, params.timeframe);
         if (range && params.since != null && params.limit != null) {
@@ -92,6 +99,7 @@ const findooDatahubPlugin = {
       },
 
       async getTicker(symbol: string, market: MarketType) {
+        if (!client) throw new Error(NO_KEY_ERROR);
         return client.getTicker(symbol, market);
       },
 
@@ -233,6 +241,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const endpoint = String(params.endpoint ?? "price/historical");
             const qp = buildParams(params);
             const results = await client.equity(endpoint, qp);
@@ -283,6 +292,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const endpoint = String(params.endpoint ?? "price/historical");
             const qp = buildParams(params);
             const results = await client.index(endpoint, qp);
@@ -351,6 +361,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const endpoint = String(params.endpoint ?? "cpi");
             const qp = buildParams(params);
             // Route currency/* and fixedincome/* endpoints to their categories
@@ -416,6 +427,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const endpoint = String(params.endpoint ?? "futures/historical");
             const qp = buildParams(params);
             const results = await client.derivatives(endpoint, qp);
@@ -483,6 +495,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const endpoint = String(params.endpoint ?? "coin/market");
             const qp = buildParams(params);
             // Endpoint-specific param mapping for crypto APIs
@@ -570,6 +583,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const endpoint = String(params.endpoint ?? "market/top_list");
             const qp = buildParams(params);
             // Auto-alias: trade_date→date for endpoints that use 'date' param
@@ -618,6 +632,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const path = String(params.path ?? "").trim();
             if (!path) throw new Error("path is required");
             const qp = (params.params ?? {}) as Record<string, string>;
@@ -766,6 +781,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const indicator = String(params.indicator ?? "sma");
             const qp: Record<string, string> = {};
             if (params.symbol) qp.symbol = String(params.symbol);
@@ -830,6 +846,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const endpoint = String(params.endpoint ?? "info");
             const qp = buildParams(params);
             const results = await client.etf(endpoint, qp);
@@ -871,6 +888,7 @@ const findooDatahubPlugin = {
         }),
         async execute(_toolCallId: string, params: Record<string, unknown>) {
           try {
+            if (!client) return json({ error: NO_KEY_ERROR });
             const endpoint = String(params.endpoint ?? "price/historical");
             const qp = buildParams(params);
             // Route news/* to the generic query path
@@ -902,7 +920,7 @@ const findooDatahubPlugin = {
         parameters: Type.Object({}),
         async execute() {
           return json({
-            datahub: config.datahubApiUrl,
+            connected: !!client,
             markets: dataProvider.getSupportedMarkets(),
             categories: [
               "equity",

package/openclaw.plugin.json

@@ -1,34 +1,27 @@
 {
   "id": "findoo-datahub-plugin",
   "name": "Findoo DataHub",
-  "description": "Unified financial data source — 172 endpoints covering equity (A/HK/US), crypto, macro, derivatives, index, ETF via OpenBB DataHub. Works out of the box.",
+  "description": "Unified financial data source — 172 endpoints covering equity (A/HK/US), crypto, macro, derivatives, index, ETF. Works out of the box.",
   "kind": "financial",
   "version": "2026.3.2",
   "skills": ["./skills"],
   "configSchema": {
     "type": "object",
     "properties": {
-      "datahubApiUrl": {
-        "type": "string",
-        "default": "http://43.134.61.136:8088",
-        "description": "DataHub REST API base URL. Change only for self-hosted OpenBB instances"
-      },
-      "datahubUsername": {
-        "type": "string",
-        "default": "admin",
-        "description": "DataHub HTTP Basic Auth username"
-      },
       "datahubApiKey": {
         "type": "string",
-        "description": "DataHub API key (required). Set via config or DATAHUB_API_KEY env var.",
+        "minLength": 1,
+        "description": "DataHub API key (required). Also accepted via DATAHUB_API_KEY env var.",
         "sensitive": true
-      },
-      "requestTimeoutMs": {
-        "type": "number",
-        "default": 30000,
-        "minimum": 1000,
-        "maximum": 120000
       }
     }
+  },
+  "uiHints": {
+    "datahubApiKey": {
+      "label": "API Key",
+      "help": "DataHub API 密钥（必填）。",
+      "sensitive": true,
+      "placeholder": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+    }
   }
 }

package/package.json

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

package/skills/derivatives/skill.md

@@ -101,10 +101,10 @@ fin_derivatives(futures/holding)     → 主力持仓方向
 - US: `fin_derivatives(endpoint="options/chains", symbol="SPY")` → 直接取返回的 IV 字段 → 与 VIX 历史对比
 - ⚠️ A 股标的有限 (50ETF/300ETF/科创50ETF 等)，个股期权几乎不存在
 
-| IV 分位     | 看涨                       | 看跌                       | 无方向                  |
-| ----------- | -------------------------- | -------------------------- | ----------------------- |
-| < 30th (低) | 买 Call / Bull Call Spread | 买 Put / Bear Put Spread   | Long Straddle/Strangle  |
-| 30-70th     | Bull Call Spread           | Bear Put Spread            | Iron Condor             |
+| IV 分位     | 看涨                       | 看跌                       | 无方向                                |
+| ----------- | -------------------------- | -------------------------- | ------------------------------------- |
+| < 30th (低) | 买 Call / Bull Call Spread | 买 Put / Bear Put Spread   | Long Straddle/Strangle                |
+| 30-70th     | Bull Call Spread           | Bear Put Spread            | Iron Condor                           |
 | > 70th (高) | 卖 Put / Bull Put Spread   | 卖 Call / Bear Call Spread | Short Straddle/Strangle ⚠️ 必须设止损 |
 
 ### 常用策略参数

package/skills/risk-monitor/skill.md

@@ -112,20 +112,20 @@ Credit_stress = 0.4*shibor_score + 0.3*curve_score + 0.3*margin_score
 
 ## 风险传导链模型
 
-| 路径 | 链路 | 频率 | 升级触发 |
-|------|------|------|---------|
-| **A 外部冲击** | 美债↑(`treasury_us`) → CNH贬(`USDCNH`) → 北向流出(`hsgt_flow`) → 大宗联动(AU/SC) → A股承压 | 日频 | 10Y日变>10bp |
-| **B 去杠杆** | 监管收紧 → 融资降(`margin/summary`) → 杠杆平仓(`margin/trading`) → 质押风险(`pledge/stat`) → 连锁跌停 | 周频 | 融资连降3日 |
-| **C 流动性危机** | Shibor飙升(`shibor`) → 债券抛售(`treasury_cn`) → 利差异常 → 股债双杀 | 日频 | O/N>3% |
+| 路径             | 链路                                                                                                  | 频率 | 升级触发     |
+| ---------------- | ----------------------------------------------------------------------------------------------------- | ---- | ------------ |
+| **A 外部冲击**   | 美债↑(`treasury_us`) → CNH贬(`USDCNH`) → 北向流出(`hsgt_flow`) → 大宗联动(AU/SC) → A股承压            | 日频 | 10Y日变>10bp |
+| **B 去杠杆**     | 监管收紧 → 融资降(`margin/summary`) → 杠杆平仓(`margin/trading`) → 质押风险(`pledge/stat`) → 连锁跌停 | 周频 | 融资连降3日  |
+| **C 流动性危机** | Shibor飙升(`shibor`) → 债券抛售(`treasury_cn`) → 利差异常 → 股债双杀                                  | 日频 | O/N>3%       |
 
 ## 风险情景预案
 
-| 情景 | 触发条件 | 行动 |
-|------|---------|------|
-| **A 美联储冲击** | 10Y 5日升>25bp + USDCNH周升>0.8% + 北向3日出>150亿 | 减成长至30%，增配高股息，IF空头对冲 |
-| **B 信用事件** | 融资10日降>8% + O/N>3.5% + 银行地产跌停>15 | 清仓金融地产，仓位<30%，增配国债ETF(511010.SH) |
-| **C 地缘冲突** | AU日涨>2% + SC日涨>5% + USDCNH 3日升>1% | 仓位30%，加配黄金/现金/短期国债 |
-| **D 钱荒** | O/N>5% + 大面积强平 + 跌停>200 + 10Y-1Y<10bp | 全清仓转现金。恢复: O/N<2.5% + 跌停<50 |
+| 情景             | 触发条件                                           | 行动                                           |
+| ---------------- | -------------------------------------------------- | ---------------------------------------------- |
+| **A 美联储冲击** | 10Y 5日升>25bp + USDCNH周升>0.8% + 北向3日出>150亿 | 减成长至30%，增配高股息，IF空头对冲            |
+| **B 信用事件**   | 融资10日降>8% + O/N>3.5% + 银行地产跌停>15         | 清仓金融地产，仓位<30%，增配国债ETF(511010.SH) |
+| **C 地缘冲突**   | AU日涨>2% + SC日涨>5% + USDCNH 3日升>1%            | 仓位30%，加配黄金/现金/短期国债                |
+| **D 钱荒**       | O/N>5% + 大面积强平 + 跌停>200 + 10Y-1Y<10bp       | 全清仓转现金。恢复: O/N<2.5% + 跌停<50         |
 
 ## 尾部风险预警 (Perfect Storm)