@openfinclaw/findoo-datahub-plugin 2026.3.2

package/skills/crypto-defi/skill.md

@@ -0,0 +1,69 @@
+---
+name: fin-crypto-defi
+description: "Crypto & DeFi data — CEX market data (tickers/orderbook/funding), DeFi protocol TVL/yields/stablecoins/DEX volumes, CoinGecko market cap/trending. All via DataHub."
+metadata: { "openclaw": { "emoji": "🪙", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# Crypto & DeFi
+
+Use the **fin_crypto** tool for cryptocurrency and DeFi analysis via DataHub (works out of the box). For simple OHLCV data, use **fin_data_ohlcv** instead.
+
+## When to Use
+
+- "BTC最新价格" / "Bitcoin ticker"
+- "ETH永续资金费率" / "funding rate"
+- "DeFi TVL排行" / "DeFi protocol ranking"
+- "Aave收益率" / "DeFi yield opportunities"
+- "USDT发行量" / "stablecoin market cap"
+- "币圈热搜" / "trending coins"
+
+## CEX Market Data
+
+| endpoint              | Description            | Example                                                         |
+| --------------------- | ---------------------- | --------------------------------------------------------------- |
+| `market/ticker`       | Single ticker snapshot | `fin_crypto(endpoint="market/ticker", symbol="BTC/USDT")`       |
+| `market/tickers`      | All tickers            | `fin_crypto(endpoint="market/tickers")`                         |
+| `market/orderbook`    | Order book depth       | `fin_crypto(endpoint="market/orderbook", symbol="BTC/USDT")`    |
+| `market/trades`       | Recent trades          | `fin_crypto(endpoint="market/trades", symbol="BTC/USDT")`       |
+| `market/funding_rate` | Perpetual funding rate | `fin_crypto(endpoint="market/funding_rate", symbol="BTC/USDT")` |
+
+## CoinGecko Market Intelligence
+
+| endpoint            | Description            | Example                                                    |
+| ------------------- | ---------------------- | ---------------------------------------------------------- |
+| `coin/market`       | Market cap ranking     | `fin_crypto(endpoint="coin/market", limit=20)`             |
+| `coin/historical`   | Coin historical data   | `fin_crypto(endpoint="coin/historical", symbol="bitcoin")` |
+| `coin/info`         | Coin detail info       | `fin_crypto(endpoint="coin/info", symbol="ethereum")`      |
+| `coin/categories`   | Category rankings      | `fin_crypto(endpoint="coin/categories")`                   |
+| `coin/trending`     | Trending / hot coins   | `fin_crypto(endpoint="coin/trending")`                     |
+| `coin/global_stats` | Global market overview | `fin_crypto(endpoint="coin/global_stats")`                 |
+
+## DeFi Protocol Data (DefiLlama)
+
+| endpoint              | Description                 | Example                                                      |
+| --------------------- | --------------------------- | ------------------------------------------------------------ |
+| `defi/protocols`      | Protocol TVL ranking        | `fin_crypto(endpoint="defi/protocols", limit=20)`            |
+| `defi/tvl_historical` | Full TVL history            | `fin_crypto(endpoint="defi/tvl_historical")`                 |
+| `defi/protocol_tvl`   | Single protocol TVL history | `fin_crypto(endpoint="defi/protocol_tvl", symbol="aave")`    |
+| `defi/chains`         | Blockchain TVL comparison   | `fin_crypto(endpoint="defi/chains")`                         |
+| `defi/yields`         | Yield farming opportunities | `fin_crypto(endpoint="defi/yields")`                         |
+| `defi/stablecoins`    | Stablecoin market data      | `fin_crypto(endpoint="defi/stablecoins")`                    |
+| `defi/fees`           | Protocol fees/revenue       | `fin_crypto(endpoint="defi/fees")`                           |
+| `defi/dex_volumes`    | DEX trading volumes         | `fin_crypto(endpoint="defi/dex_volumes")`                    |
+| `defi/coin_prices`    | DeFi token prices           | `fin_crypto(endpoint="defi/coin_prices", symbol="ethereum")` |
+
+## Simple OHLCV (via CCXT)
+
+Use **fin_data_ohlcv** for simple crypto candlestick data via CCXT:
+
+```
+fin_data_ohlcv(symbol="BTC/USDT", market="crypto", timeframe="1d")
+```
+
+## Market Overview Pattern
+
+1. `fin_crypto(coin/global_stats)` — total market cap, BTC dominance
+2. `fin_crypto(coin/market)` — top coins by market cap
+3. `fin_crypto(coin/trending)` — what's hot
+4. `fin_crypto(defi/protocols)` — DeFi TVL leaders
+5. `fin_crypto(defi/chains)` — which chains are growing

package/skills/data-query/skill.md

@@ -0,0 +1,56 @@
+---
+name: fin-data-query
+description: "Generic DataHub query — directly call any of 172 financial data endpoints by path. Fallback when specialized tools don't cover the data need."
+metadata: { "openclaw": { "emoji": "🔍", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# Data Query (Fallback)
+
+Use the **fin_query** tool as a generic fallback to access any of the 172 DataHub endpoints directly (works out of the box).
+
+## When to Use
+
+- When specialized tools (fin_stock, fin_index, fin_macro, fin_derivatives, fin_crypto, fin_market) don't cover the specific data need
+- When querying less common endpoints
+
+## DataHub Categories
+
+| Category        | Endpoints | Coverage                                                      |
+| --------------- | --------- | ------------------------------------------------------------- |
+| `equity/*`      | 83        | A-share, HK, US — prices, fundamentals, ownership, money flow |
+| `crypto/*`      | 23        | CEX market data, CoinGecko, DeFi via DefiLlama                |
+| `economy/*`     | 21        | China macro, rates, FX, World Bank                            |
+| `derivatives/*` | 13        | Futures, options, convertible bonds                           |
+| `index/*`       | 12        | Index data, thematic indices                                  |
+| `etf/*`         | 9         | ETF prices, NAV, fund data                                    |
+| `currency/*`    | 3         | FX historical, search, snapshots                              |
+| `news/*`        | 1         | Company news                                                  |
+
+## Example Calls
+
+```
+# ETF fund manager info
+fin_query(path="etf/fund/manager", params={"symbol": "110011"})
+
+# Currency historical
+fin_query(path="currency/price/historical", params={"symbol": "USDCNH"})
+
+# Company news
+fin_query(path="news/company", params={"symbol": "AAPL"})
+
+# Coverage metadata — see all available endpoints
+fin_query(path="coverage/providers")
+fin_query(path="coverage/commands")
+```
+
+## When to Prefer Specialized Tools
+
+| Data Need                   | Use Instead       |
+| --------------------------- | ----------------- |
+| Stock quote / financials    | `fin_stock`       |
+| Index / ETF / Fund          | `fin_index`       |
+| GDP / CPI / interest rates  | `fin_macro`       |
+| Futures / options / CB      | `fin_derivatives` |
+| Crypto / DeFi               | `fin_crypto`      |
+| Dragon-tiger / market radar | `fin_market`      |
+| Simple OHLCV (CCXT/Yahoo)   | `fin_data_ohlcv`  |

package/skills/derivatives/skill.md

@@ -0,0 +1,53 @@
+---
+name: fin-derivatives
+description: "Derivatives analysis — futures (holdings/settlement/warehouse/term structure), options (chains/Greeks/IV), convertible bonds. All via DataHub."
+metadata: { "openclaw": { "emoji": "📉", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# Derivatives Analysis
+
+Use the **fin_derivatives** tool for futures, options, and convertible bond analysis via DataHub (works out of the box).
+
+## When to Use
+
+- "螺纹钢期货持仓" / "rebar futures holding"
+- "IF2501 结算价" / "futures settlement"
+- "铜仓单变化" / "warehouse receipts"
+- "AAPL期权链" / "option chains with Greeks"
+- "可转债转股溢价率" / "CB conversion premium"
+
+## Available Endpoints
+
+### Futures
+
+| endpoint             | Description              | Example                                                                                     |
+| -------------------- | ------------------------ | ------------------------------------------------------------------------------------------- |
+| `futures/historical` | Futures historical OHLCV | `fin_derivatives(symbol="RB2501.SHF", endpoint="futures/historical")`                       |
+| `futures/info`       | Contract specification   | `fin_derivatives(symbol="RB2501.SHF", endpoint="futures/info")`                             |
+| `futures/holding`    | Position ranking         | `fin_derivatives(symbol="RB2501.SHF", endpoint="futures/holding", trade_date="2025-02-28")` |
+| `futures/settle`     | Daily settlement         | `fin_derivatives(symbol="RB2501.SHF", endpoint="futures/settle")`                           |
+| `futures/warehouse`  | Warehouse receipts       | `fin_derivatives(symbol="RB.SHF", endpoint="futures/warehouse")`                            |
+| `futures/mapping`    | Active contract mapping  | `fin_derivatives(symbol="RB.SHF", endpoint="futures/mapping")`                              |
+
+### Options
+
+| endpoint         | Description               | Example                                                           |
+| ---------------- | ------------------------- | ----------------------------------------------------------------- |
+| `options/basic`  | Option contract list      | `fin_derivatives(symbol="510050.SH", endpoint="options/basic")`   |
+| `options/daily`  | Option daily prices       | `fin_derivatives(symbol="10004537.SH", endpoint="options/daily")` |
+| `options/chains` | Option chains with Greeks | `fin_derivatives(symbol="AAPL", endpoint="options/chains")`       |
+
+### Convertible Bonds
+
+| endpoint            | Description     | Example                                                             |
+| ------------------- | --------------- | ------------------------------------------------------------------- |
+| `convertible/basic` | CB basic info   | `fin_derivatives(symbol="113xxx.SH", endpoint="convertible/basic")` |
+| `convertible/daily` | CB daily prices | `fin_derivatives(symbol="113xxx.SH", endpoint="convertible/daily")` |
+
+## Futures Analysis Pattern
+
+1. `fin_derivatives(futures/info)` — contract specification
+2. `fin_derivatives(futures/historical)` — price trend
+3. `fin_derivatives(futures/holding)` — major institution positions
+4. `fin_derivatives(futures/settle)` — settlement and open interest
+5. `fin_derivatives(futures/warehouse)` — warehouse receipts (supply signal)

package/skills/equity/skill.md

@@ -0,0 +1,64 @@
+---
+name: fin-equity
+description: "Equity research — A-share, HK, US stock analysis, financials, money flow, holders, dividends, index/ETF/fund, Stock Connect flows. All via DataHub."
+metadata: { "openclaw": { "emoji": "📊", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# Equity Research
+
+Use **fin_stock**, **fin_index**, and **fin_market** tools for equity analysis across A-share, HK, and US markets. All data routes through DataHub (works out of the box).
+
+## When to Use
+
+- "茅台行情" / "贵州茅台最新股价" / "AAPL earnings"
+- "腾讯港股今天行情" / "00700.HK daily"
+- "沪深300成分股" / "CSI 300 constituents"
+- "50ETF净值" / "ETF NAV"
+- "北向资金" / "Stock Connect flows"
+
+## Stock Data (fin_stock)
+
+| endpoint                  | Description           | Example                                                             |
+| ------------------------- | --------------------- | ------------------------------------------------------------------- |
+| `price/historical`        | Historical OHLCV      | `fin_stock(symbol="600519.SH", endpoint="price/historical")`        |
+| `fundamental/income`      | Income statement      | `fin_stock(symbol="600519.SH", endpoint="fundamental/income")`      |
+| `fundamental/balance`     | Balance sheet         | `fin_stock(symbol="600519.SH", endpoint="fundamental/balance")`     |
+| `fundamental/cash`        | Cash flow statement   | `fin_stock(symbol="AAPL", endpoint="fundamental/cash")`             |
+| `fundamental/ratios`      | Financial ratios      | `fin_stock(symbol="00700.HK", endpoint="fundamental/ratios")`       |
+| `fundamental/dividends`   | Dividend history      | `fin_stock(symbol="600519.SH", endpoint="fundamental/dividends")`   |
+| `ownership/top10_holders` | Top 10 shareholders   | `fin_stock(symbol="600519.SH", endpoint="ownership/top10_holders")` |
+| `moneyflow/individual`    | Capital flow tracking | `fin_stock(symbol="600519.SH", endpoint="moneyflow/individual")`    |
+| `discovery/gainers`       | Top gainers           | `fin_stock(endpoint="discovery/gainers")`                           |
+
+## Index / ETF / Fund (fin_index)
+
+| endpoint             | Description              | Example                                                        |
+| -------------------- | ------------------------ | -------------------------------------------------------------- |
+| `price/historical`   | Index daily data         | `fin_index(symbol="000300.SH", endpoint="price/historical")`   |
+| `constituents`       | Index constituent stocks | `fin_index(symbol="000300.SH", endpoint="constituents")`       |
+| `daily_basic`        | Index PE/PB valuation    | `fin_index(symbol="000300.SH", endpoint="daily_basic")`        |
+| `thematic/ths_index` | THS concept index list   | `fin_index(endpoint="thematic/ths_index")`                     |
+| `thematic/ths_daily` | THS concept daily data   | `fin_index(symbol="885760.TI", endpoint="thematic/ths_daily")` |
+
+## Cross-Border Flows (fin_market)
+
+| endpoint          | Description                       | Example                                                           |
+| ----------------- | --------------------------------- | ----------------------------------------------------------------- |
+| `flow/hsgt_flow`  | Northbound/Southbound daily flows | `fin_market(endpoint="flow/hsgt_flow", start_date="2025-02-01")`  |
+| `flow/hsgt_top10` | Top 10 HSGT holdings              | `fin_market(endpoint="flow/hsgt_top10", trade_date="2025-02-28")` |
+
+## Symbol Format
+
+- A-shares: `600519.SH` (Shanghai), `000001.SZ` (Shenzhen)
+- HK stocks: `00700.HK`
+- US stocks: `AAPL`
+- Index: `000300.SH`, ETF: `510050.SH`
+
+## Deep Analysis Pattern
+
+1. `fin_stock(price/historical)` — price trend
+2. `fin_stock(fundamental/income)` — profitability
+3. `fin_stock(fundamental/cash)` — cash quality
+4. `fin_stock(moneyflow/individual)` — institutional flow
+5. `fin_stock(ownership/top10_holders)` — ownership changes
+6. `fin_market(flow/hsgt_flow)` — cross-border capital

package/skills/macro/skill.md

@@ -0,0 +1,60 @@
+---
+name: fin-macro
+description: "Macro economics and interest rates — China GDP/CPI/PPI/PMI/M2, global rates (Shibor/LPR/Libor/Treasury), World Bank data, FX rates. All via DataHub."
+metadata: { "openclaw": { "emoji": "🏛️", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# Macro & Rates
+
+Use the **fin_macro** tool for macroeconomic indicators and interest rate data via DataHub (works out of the box).
+
+## When to Use
+
+- "中国最新GDP" / "China GDP growth"
+- "CPI数据" / "latest CPI"
+- "Shibor利率" / "interbank rate"
+- "LPR是多少" / "loan prime rate"
+- "美国国债收益率" / "US Treasury yield"
+- "世界银行GDP对比" / "World Bank comparison"
+
+## Available Endpoints
+
+### China Macro
+
+| endpoint           | Description           | Example                                  |
+| ------------------ | --------------------- | ---------------------------------------- |
+| `gdp/real`         | China GDP             | `fin_macro(endpoint="gdp/real")`         |
+| `cpi`              | Consumer Price Index  | `fin_macro(endpoint="cpi")`              |
+| `ppi`              | Producer Price Index  | `fin_macro(endpoint="ppi")`              |
+| `pmi`              | Purchasing Managers   | `fin_macro(endpoint="pmi")`              |
+| `money_supply`     | Money supply M0/M1/M2 | `fin_macro(endpoint="money_supply")`     |
+| `social_financing` | Social financing      | `fin_macro(endpoint="social_financing")` |
+
+### Interest Rates
+
+| endpoint      | Description              | Example                             |
+| ------------- | ------------------------ | ----------------------------------- |
+| `shibor`      | Shanghai Interbank Rate  | `fin_macro(endpoint="shibor")`      |
+| `shibor_lpr`  | Loan Prime Rate          | `fin_macro(endpoint="shibor_lpr")`  |
+| `libor`       | London Interbank Rate    | `fin_macro(endpoint="libor")`       |
+| `hibor`       | Hong Kong Interbank Rate | `fin_macro(endpoint="hibor")`       |
+| `treasury_cn` | China treasury yields    | `fin_macro(endpoint="treasury_cn")` |
+| `treasury_us` | US treasury yields       | `fin_macro(endpoint="treasury_us")` |
+
+### Global (World Bank)
+
+| endpoint               | Description           | Example                                                    |
+| ---------------------- | --------------------- | ---------------------------------------------------------- |
+| `worldbank/gdp`        | World Bank GDP        | `fin_macro(endpoint="worldbank/gdp", country="CN")`        |
+| `worldbank/population` | World Bank population | `fin_macro(endpoint="worldbank/population", country="US")` |
+| `worldbank/inflation`  | World Bank inflation  | `fin_macro(endpoint="worldbank/inflation", country="CN")`  |
+| `worldbank/indicator`  | Custom WB indicator   | `fin_macro(endpoint="worldbank/indicator", country="CN")`  |
+
+## Macro Cycle Analysis Pattern
+
+1. `fin_macro(gdp/real)` — growth trend
+2. `fin_macro(cpi)` — inflation
+3. `fin_macro(pmi)` — manufacturing activity
+4. `fin_macro(shibor)` — liquidity conditions
+5. `fin_macro(shibor_lpr)` — policy rate direction
+6. `fin_macro(treasury_cn)` — bond market signal

package/skills/market-radar/skill.md

@@ -0,0 +1,47 @@
+---
+name: fin-market-radar
+description: "Market monitoring — dragon-tiger list, limit-up/down stats, block trades, sector money flow, margin trading, global index snapshots, IPO calendar. All via DataHub."
+metadata: { "openclaw": { "emoji": "📡", "requires": { "extensions": ["findoo-datahub-plugin"] } } }
+---
+
+# Market Radar
+
+Use the **fin_market** tool for market-wide monitoring and anomaly detection via DataHub (works out of the box).
+
+## When to Use
+
+- "今天龙虎榜" / "dragon-tiger list"
+- "涨停板有哪些" / "limit up stocks"
+- "大宗交易" / "block trades today"
+- "板块资金流向" / "sector money flow"
+- "融资融券余额" / "margin balance"
+- "北向资金" / "northbound flow"
+- "全球指数" / "global index snapshot"
+
+## Available Endpoints
+
+| endpoint                | Description                          | Key Params                |
+| ----------------------- | ------------------------------------ | ------------------------- |
+| `market/top_list`       | Dragon-tiger list (top movers)       | `trade_date="2025-02-28"` |
+| `market/top_inst`       | Institutional trades on dragon-tiger | `trade_date`              |
+| `market/limit_list`     | Limit-up/down stocks                 | `trade_date`              |
+| `market/suspend`        | Trading suspensions                  | `trade_date`              |
+| `market/trade_calendar` | Exchange calendar                    | —                         |
+| `moneyflow/individual`  | Per-stock capital flow               | `symbol`                  |
+| `moneyflow/industry`    | Sector capital flow                  | `trade_date`              |
+| `moneyflow/block_trade` | Block trade records                  | `trade_date`              |
+| `margin/summary`        | Market margin summary                | `trade_date`              |
+| `margin/detail`         | Per-stock margin detail              | `symbol`                  |
+| `flow/hsgt_flow`        | Northbound/Southbound flows          | `start_date`, `end_date`  |
+| `flow/hsgt_top10`       | Top HSGT holdings                    | `trade_date`              |
+| `discovery/gainers`     | Top gainers                          | —                         |
+| `discovery/losers`      | Top losers                           | —                         |
+| `discovery/active`      | Most active                          | —                         |
+| `discovery/new_share`   | IPO calendar                         | —                         |
+
+## Post-market Review Pattern
+
+1. `fin_market(market/top_list)` — who made the dragon-tiger list
+2. `fin_market(market/limit_list)` — limit-up/down count
+3. `fin_market(margin/summary)` — margin trading changes
+4. `fin_market(flow/hsgt_flow)` — northbound capital trend

package/src/adapters/crypto-adapter.ts

@@ -0,0 +1,103 @@
+import type { OHLCVCache } from "../ohlcv-cache.js";
+import type { OHLCV, Ticker } from "../types.js";
+
+export type CcxtExchange = {
+  fetchTicker: (symbol: string) => Promise<Record<string, unknown>>;
+  fetchOHLCV: (
+    symbol: string,
+    timeframe: string,
+    since?: number,
+    limit?: number,
+  ) => Promise<Array<[number, number, number, number, number, number]>>;
+};
+
+export interface CryptoAdapter {
+  getOHLCV(params: {
+    symbol: string;
+    timeframe: string;
+    since?: number;
+    limit?: number;
+    exchangeId?: string;
+  }): Promise<OHLCV[]>;
+  getTicker(symbol: string, exchangeId?: string): Promise<Ticker>;
+}
+
+export function createCryptoAdapter(
+  cache: OHLCVCache,
+  getExchangeInstance: (id?: string) => Promise<CcxtExchange>,
+  defaultExchangeId?: string,
+): CryptoAdapter {
+  async function resolveExchange(exchangeId?: string): Promise<CcxtExchange> {
+    return getExchangeInstance(exchangeId ?? defaultExchangeId);
+  }
+
+  function ccxtToOHLCV(raw: [number, number, number, number, number, number]): OHLCV {
+    return {
+      timestamp: raw[0],
+      open: raw[1],
+      high: raw[2],
+      low: raw[3],
+      close: raw[4],
+      volume: raw[5],
+    };
+  }
+
+  return {
+    async getOHLCV(params) {
+      const { symbol, timeframe, since, limit, exchangeId } = params;
+      const market = "crypto";
+
+      // Check cache for existing data
+      const range = cache.getRange(symbol, market, timeframe);
+
+      if (range) {
+        // If since + limit are specified and we have enough data in cache, return cached
+        if (since != null && limit != null) {
+          const cached = cache.query(symbol, market, timeframe, since);
+          if (cached.length >= limit) {
+            return cached.slice(0, limit);
+          }
+        }
+
+        // Fetch data after the latest cached timestamp
+        const exchange = await resolveExchange(exchangeId);
+        const fetchSince = range.latest + 1;
+        const raw = await exchange.fetchOHLCV(symbol, timeframe, fetchSince, limit);
+        if (raw.length > 0) {
+          const newRows = raw.map(ccxtToOHLCV);
+          cache.upsertBatch(symbol, market, timeframe, newRows);
+        }
+
+        // Return all cached data (including newly stored)
+        return cache.query(symbol, market, timeframe, since);
+      }
+
+      // Full cache miss — fetch from exchange
+      const exchange = await resolveExchange(exchangeId);
+      const raw = await exchange.fetchOHLCV(symbol, timeframe, since, limit);
+      const rows = raw.map(ccxtToOHLCV);
+
+      if (rows.length > 0) {
+        cache.upsertBatch(symbol, market, timeframe, rows);
+      }
+
+      return rows;
+    },
+
+    async getTicker(symbol, exchangeId) {
+      const exchange = await resolveExchange(exchangeId);
+      const raw = await exchange.fetchTicker(symbol);
+
+      return {
+        symbol,
+        market: "crypto",
+        last: raw.last as number,
+        bid: raw.bid as number | undefined,
+        ask: raw.ask as number | undefined,
+        volume24h: raw.quoteVolume as number | undefined,
+        changePct24h: raw.percentage as number | undefined,
+        timestamp: (raw.timestamp as number) ?? Date.now(),
+      };
+    },
+  };
+}

package/src/adapters/equity-adapter.ts

@@ -0,0 +1,11 @@
+import type { OHLCV, Ticker } from "../types.js";
+
+export interface EquityAdapter {
+  getOHLCV(params: {
+    symbol: string;
+    timeframe: string;
+    since?: number;
+    limit?: number;
+  }): Promise<OHLCV[]>;
+  getTicker(symbol: string): Promise<Ticker>;
+}

package/src/adapters/yahoo-adapter.ts

@@ -0,0 +1,110 @@
+import type { OHLCVCache } from "../ohlcv-cache.js";
+import type { OHLCV, Ticker } from "../types.js";
+import type { EquityAdapter } from "./equity-adapter.js";
+
+/**
+ * Duck-typed client interface matching yahoo-finance2's API surface.
+ * Avoids hard dependency on the yahoo-finance2 package at type level.
+ */
+export type YahooFinanceClient = {
+  chart: (
+    symbol: string,
+    options: { period1: string | number; period2?: string | number; interval?: string },
+  ) => Promise<{ quotes: Array<Record<string, unknown>> }>;
+  quote: (symbol: string) => Promise<Record<string, unknown>>;
+};
+
+/** Map our canonical timeframes to Yahoo Finance interval strings. */
+const TIMEFRAME_MAP: Record<string, string> = {
+  "1m": "1m",
+  "5m": "5m",
+  "15m": "15m",
+  "1h": "60m",
+  "4h": "60m", // Yahoo has no 4h; use 1h as fallback
+  "1d": "1d",
+  "1W": "1wk",
+  "1M": "1mo",
+};
+
+/** Default lookback in ms (~1 year). */
+const DEFAULT_LOOKBACK_MS = 365 * 24 * 60 * 60 * 1000;
+
+/** Convert a Yahoo chart quote row to canonical OHLCV, or null if data is missing. */
+function rowToOHLCV(row: Record<string, unknown>): OHLCV | null {
+  const date = row.date as Date | undefined;
+  if (!date) return null;
+
+  const open = row.open as number | null | undefined;
+  const high = row.high as number | null | undefined;
+  const low = row.low as number | null | undefined;
+  const close = row.close as number | null | undefined;
+  const volume = row.volume as number | null | undefined;
+
+  // Yahoo returns null values for non-trading days
+  if (open == null || high == null || low == null || close == null) return null;
+
+  return {
+    timestamp: date.getTime(),
+    open,
+    high,
+    low,
+    close,
+    volume: volume ?? 0,
+  };
+}
+
+export function createYahooAdapter(cache: OHLCVCache, client: YahooFinanceClient): EquityAdapter {
+  return {
+    async getOHLCV(params) {
+      const { symbol, timeframe, since, limit } = params;
+      const market = "equity";
+      const interval = TIMEFRAME_MAP[timeframe] ?? "1d";
+
+      // Check cache first
+      const range = cache.getRange(symbol, market, timeframe);
+      if (range) {
+        if (since != null && limit != null) {
+          const cached = cache.query(symbol, market, timeframe, since);
+          if (cached.length >= limit) {
+            return cached.slice(0, limit);
+          }
+        }
+      }
+
+      // Determine fetch window
+      const period1 = since ?? Date.now() - DEFAULT_LOOKBACK_MS;
+      const result = await client.chart(symbol, { period1, interval });
+
+      const rows = result.quotes
+        .map(rowToOHLCV)
+        .filter((r): r is OHLCV => r !== null)
+        .sort((a, b) => a.timestamp - b.timestamp);
+
+      if (rows.length > 0) {
+        cache.upsertBatch(symbol, market, timeframe, rows);
+      }
+
+      // Return from cache for consistency (merges with any existing data)
+      if (range || rows.length > 0) {
+        const all = cache.query(symbol, market, timeframe, since);
+        return limit ? all.slice(0, limit) : all;
+      }
+      return rows;
+    },
+
+    async getTicker(symbol) {
+      const raw = await client.quote(symbol);
+
+      return {
+        symbol,
+        market: "equity" as const,
+        last: (raw.regularMarketPrice as number) ?? 0,
+        bid: raw.bid as number | undefined,
+        ask: raw.ask as number | undefined,
+        volume24h: raw.regularMarketVolume as number | undefined,
+        changePct24h: raw.regularMarketChangePercent as number | undefined,
+        timestamp: (raw.regularMarketTime as Date)?.getTime?.() ?? Date.now(),
+      };
+    },
+  };
+}

package/src/config.ts

@@ -0,0 +1,51 @@
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+
+export type PluginConfig = {
+  datahubApiUrl: string;
+  datahubUsername: string;
+  datahubPassword: string;
+  requestTimeoutMs: number;
+};
+
+function readEnv(keys: string[]): string | undefined {
+  for (const key of keys) {
+    const value = process.env[key]?.trim();
+    if (value) return value;
+  }
+  return undefined;
+}
+
+// Public DataHub defaults — works out of the box
+const DEFAULT_DATAHUB_URL = "http://43.134.61.136:8088";
+const DEFAULT_DATAHUB_USERNAME = "admin";
+const DEFAULT_DATAHUB_PASSWORD = "98ffa5c5-1ec6-4735-8e0c-715a5eca1a8d";
+
+export function resolveConfig(api: OpenClawPluginApi): PluginConfig {
+  const raw = api.pluginConfig as Record<string, unknown> | undefined;
+
+  const datahubApiUrl =
+    (typeof raw?.datahubApiUrl === "string" ? raw.datahubApiUrl : undefined) ??
+    readEnv(["DATAHUB_API_URL", "OPENFINCLAW_DATAHUB_API_URL"]) ??
+    DEFAULT_DATAHUB_URL;
+
+  const datahubUsername =
+    (typeof raw?.datahubUsername === "string" ? raw.datahubUsername : undefined) ??
+    readEnv(["DATAHUB_USERNAME", "OPENFINCLAW_DATAHUB_USERNAME"]) ??
+    DEFAULT_DATAHUB_USERNAME;
+
+  const datahubPassword =
+    (typeof raw?.datahubPassword === "string" ? raw.datahubPassword : undefined) ??
+    (typeof raw?.datahubApiKey === "string" ? raw.datahubApiKey : undefined) ??
+    readEnv(["DATAHUB_PASSWORD", "OPENFINCLAW_DATAHUB_PASSWORD", "DATAHUB_API_KEY"]) ??
+    DEFAULT_DATAHUB_PASSWORD;
+
+  const timeoutRaw = raw?.requestTimeoutMs ?? readEnv(["OPENFINCLAW_DATAHUB_TIMEOUT_MS"]);
+  const timeout = Number(timeoutRaw);
+
+  return {
+    datahubApiUrl: datahubApiUrl.replace(/\/+$/, ""),
+    datahubUsername,
+    datahubPassword,
+    requestTimeoutMs: Number.isFinite(timeout) && timeout >= 1000 ? Math.floor(timeout) : 30_000,
+  };
+}