openclaw-data-china-stock

---
name: openclaw-data-china-stock
description: A-share/ETF/Option market data collection plugin for OpenClaw.
tags: [data, china, etf, option, openclaw]
---

# OpenClaw Data China Stock

This plugin provides a ClawHub/OpenClaw compatible toolset for collecting A-share, ETF, and listed option data.

## Key tools

- `tool_fetch_market_data`: Cross-asset unified entry (recommended).
- `tool_fetch_index_data` / `tool_fetch_etf_data` / `tool_fetch_option_data`: Compatibility/alias unified entries.
- `tool_get_option_contracts`: Fetch option contracts by underlying.
- `tool_read_market_data` / `tool_read_*`: Read previously cached Parquet data (when enabled).

### Paired skill suite

- `skills/china-macro-analyst/SKILL.md`
- `skills/technical-analyst/SKILL.md`
- `skills/market-scanner/SKILL.md`
- `skills/market-sentinel/SKILL.md`
- `skills/fund-flow-analyst/SKILL.md`
- `skills/strategy-backtester/SKILL.md` (MVP mode)
- `skills/fundamental-analyst/SKILL.md`

### China macro analyst tools

- **Primary**: `tool_fetch_macro_data` / `tool_fetch_macro_snapshot`
- **Compatibility wrappers**: `tool_fetch_macro_*` (21 tools; kept for backward compatibility)
- **Skill**: `skills/china-macro-analyst/SKILL.md` (institutional 4-section narrative template; rules in `macro_config.yaml`)

### Multi-factor equity screening (A-share)

- **`tool_screen_equity_factors`**: Single entry for oscillation/trend templates (e.g. `reversal_5d`, `fund_flow_3d`, `sector_momentum_5d`) over `hs300|zz500|zz1000|a_share|custom`; returns `quality_score`, `degraded`, `config_hash`, optional `sw_mapping` stats. Implemented in `plugins/analysis/equity_factor_screening.py`; registered in `tool_runner.py` / `config/tools_manifest.yaml` (+ JSON). JSON Schema: `docs/schemas/tool_screen_equity_factors.schema.json`.
- **`tool_batch_fetch`**: Batch runner includes `tool_screen_equity_factors` (see `plugins/merged/tool_batch_fetch.py` whitelist).
- **申万一级映射**：`config/sw_industry_level1_mapping.json`，由 `scripts/update_sw_industry_level1_mapping.py` 生成（默认乐咕乐股 `sw_index_first_info` + `sw_index_third_cons`；可选 `SW_MAP_USE_EM_SPOT=1` 走东财快照）。消费侧：`plugins/analysis/sw_industry_mapping.py`。

助手侧夜盘落盘、质量门禁与熔断工具（`tool_finalize_screening_nightly` / `tool_set_screening_emergency_pause`）在 **etf-options-ai-assistant** 仓库注册；规程 Skill **`ota_equity_factor_screening_brief`** 仅在该助手仓维护并同步到 Gateway。

### Fund-flow tools (pick one job, do not duplicate)

- **`tool_capital_flow`**: Single-stock **summary** for workflows that need `flow_judgement` / `risk_flags` style outputs (e.g. limit-up strategies).
- **`tool_fetch_a_share_fund_flow`**: **Tabular / ranking / history** for onshore A-share money flow (`query_kind` selects market/sector/stock tables, big deals, main-force ranks, sector drill-down). Uses Eastmoney/Tonghuashun-style AkShare routes with an explicit attempt chain; raw data is not investment advice.
- **`tool_fetch_northbound_flow`**: **Stock Connect northbound** flows (cross-border), separate from onshore A-share flow tools—keep narratives and citations distinct.
- **`tool_fetch_a_share_technical_screener`**: Tonghuashun-style **technical stock screeners** (new highs, consecutive up days, volume patterns, MA breakouts, etc.) via AkShare `stock_rank_*_ths`—**not** the same as locally computed MACD/RSI from OHLC (use `tool_stock_data_fetcher` / `tool_calculate_technical_indicators` for those).

## Safety and independence

The plugin is designed to run independently (no dependency on any other repository):

- It does not inject `~/.openclaw/.env`.
- It supports plugin-specific cache/data paths (configured inside the plugin).

## Why it helps retail users

- Unified cross-asset entry (`tool_fetch_market_data`) to reduce “tool switching” friction.
- Multi-source provider priority + automatic fallback to avoid single-provider outages breaking your workflow.
- Default read-only disk cache semantics (`data_cache.enabled=false`) to minimize local data pollution risk.

## Typical usage

Example: fetch A-share index daily historical data:

```yaml
tools:
  - name: tool_fetch_market_data
    params:
      asset_type: index
      view: historical
      asset_code: "000001"
      period: daily
      start_date: "20260201"
      end_date: "20260228"
```

Example: fetch ETF 5-minute bars:

```yaml
tools:
  - name: tool_fetch_market_data
    params:
      asset_type: etf
      view: minute
      asset_code: "510300"
      period: "5"
      start_date: "20260201"
      end_date: "20260228"
```

Example: fetch latest CPI and use macro snapshot:

```yaml
tools:
  - name: tool_fetch_macro_data
    params:
      dataset: cpi
      latest_only: true
  - name: tool_fetch_macro_snapshot
    params:
      scope: monthly
      include_quadrant: true
```

## Cache policy

- Default: `data_cache.enabled=false`
  - Disk parquet reads are allowed (if cache exists).
  - Disk parquet writes are skipped.
  - Corrupted parquet files are not deleted in this mode.
- `data_cache.enabled=true`
  - Disk parquet reads and writes are both enabled.