Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Wrapper around the mootdx library for fetching China A-share stock market data via TDX protocol. Supports K-line bars (1-minute and daily), real-time quotes with Level-2 order book data, and tick-by-tick transaction records for historical dates and live sessions.
The client automatically applies the tdxpy time_frame patch that prevents silent empty results when running on servers outside Beijing timezone, a common failure mode with raw mootdx.
When to use it
- Fetching real-time Level-2 bid/ask quotes for a batch of A-share stocks
- Pulling 1-minute candlestick bars for a specific stock at a past intraday timestamp
- Retrieving tick-by-tick transaction history for a specific trading day
- Monitoring live intraday transaction flow for a single Shanghai or Shenzhen stock
- Backtesting with historical daily OHLCV data across multiple A-share equities in parallel
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Get real-time quotes for 000001.SZ, 600300.SH, and 300750.SZ
- 1Initialize Quotes client with market='std'
- 2Apply tdxpy.hq.time_frame patch to bypass trading-hour restriction
- 3Call get_realtime_quotes(['000001.SZ', '600300.SH', '300750.SZ'])
- 4Return list of quote dicts with OHLC, volume, percent change, and pre-close for each stock
List of dicts containing trade_date, open, high, low, close, pre_close, change, pct_chg, vol, and amount for each requested stock