Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
What This Skill Does
Wraps the mootdx library to fetch China A-share market data via the TDX protocol. Covers K-line bars, real-time quotes, and tick-by-tick transaction records for Shanghai, Shenzhen, and ChiNext markets. Includes a timezone patch that prevents silent failures when running outside Beijing trading hours.
The automatic time_frame patch prevents the silent empty-result failure that occurs when calling mootdx from servers outside the Beijing timezone, which the raw library does not handle.
When to use it
- Fetching real-time Level-2 quotes for a watchlist of A-share stocks
- Pulling 1-minute intraday bars for technical indicator calculation
- Recording tick-by-tick transaction history for a specific trading date
- Batch-fetching K-line data for multiple stocks in parallel
- Checking live bid/ask order book depth during trading sessions
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Fetch 1-minute bars for 000001.SZ on 2025-02-10 at 10:30
- 1Initialize Quotes client with market='std'
- 2Apply tdxpy.hq.time_frame patch to bypass trading-hour restriction
- 3Strip the .SZ suffix to convert stock code to TDX numeric format
- 4Call get_bars with frequency=7, date='20250210', time='10:30:00', filter_by_time=True
- 5Calculate start offset accounting for 240 trading minutes per day and the 11:30-13:00 lunch gap
List of bar dicts each containing datetime, open, high, low, close, vol, and amount for the requested period