Stock Real-Time & Historical Data Skill
Purpose
Fetch real-time (or near-real-time) and historical stock market data for any stock symbol across:
- A股 (沪市 Shanghai / 深市 Shenzhen)
- 港股 (Hong Kong)
- 美股 (US Markets)
Data is sourced from 东方财富 (Eastmoney) and 新浪财经 (Sina Finance) public APIs — no API key required.
When to Use
Load this skill when the user asks about:
- Current stock price / 现价 / 最新价
- Intraday high/low, open, close / 最高最低开盘收盘
- Price change amount and percentage / 涨跌额涨跌幅
- Volume and turnover / 成交量成交额
- Limit-up / limit-down price / 涨停跌停价
- Historical K-line data / 历史行情 / K线 / 走势图
- Price history for a date range / 某段时间的走势
- Moving averages (MA5/MA10/MA20/MA60)
- Weekly or monthly candlestick data
Workflow
Step 1 — Identify the stock
Determine the stock code and market from the user's input.
Use the auto-detection logic in the script, or ask if ambiguous:
| Code pattern | Market |
|---|---|
6-digit starting with 6 |
沪市 (sh) |
6-digit starting with 00 or 30 |
深市 (sz) |
| 5-digit number | 港股 (hk) |
| Uppercase letters only | 美股 (us) |
For well-known names (e.g., "中航成飞", "贵州茅台", "腾讯"), resolve to code before running.
Step 2a — Real-time quote
Execute the fetch script for live data:
python scripts/fetch_stock.py <CODE> [--market sh|sz|hk|us] [--json]
Examples:
python scripts/fetch_stock.py 302132 # 中航成飞
python scripts/fetch_stock.py 600519 # 贵州茅台
python scripts/fetch_stock.py 00700 --market hk # 腾讯控股
python scripts/fetch_stock.py AAPL --market us # 苹果
python scripts/fetch_stock.py 302132 --json # JSON output
Step 2b — Historical K-line
Execute the history script for past data:
python scripts/fetch_history.py <CODE> [--start YYYYMMDD] [--end YYYYMMDD] [--period daily|weekly|monthly] [--market sh|sz|hk|us] [--json]
Examples:
# Default: last 6 months daily
python scripts/fetch_history.py 302132
# Custom date range
python scripts/fetch_history.py 302132 --start 20260101 --end 20260325
# Weekly K-line
python scripts/fetch_history.py 600519 --period weekly --start 20250901
# Hong Kong stock
python scripts/fetch_history.py 00700 --market hk --start 20260101
# US stock
python scripts/fetch_history.py AAPL --market us --start 20260101
# JSON output (for programmatic use)
python scripts/fetch_history.py 302132 --start 20260101 --json
The scripts are located at: ~/.workbuddy/skills/stock-realtime-data/scripts/
Step 3 — Present the data
For real-time quotes, present:
- Stock name + code + market
- Current price with color hint: 涨=红色 跌=绿色 (A股惯例)
- Change amount and percentage
- Today's open / high / low
- Yesterday's close
- Volume and turnover (if available)
- Limit-up/down prices (A股)
For historical data, present:
- Summary statistics (highest/lowest, average volume, up/down day count, MA lines)
- Recent K-line table with OHLCV data
- Notable patterns or trends observed
Always append: ⚠️ 数据仅供参考，不构成投资建议。
Step 4 — Handle errors gracefully
If a script fails (network error, unsupported code, market closed):
1. Try the alternative data source (Eastmoney ↔ Sina fallback is built in)
2. Inform the user of the data source and any known latency (港股/美股 may have 15-min delay)
3. Suggest checking 券商 app for definitive real-time data
Reference
See references/api_reference.md for:
- Full API endpoint documentation (real-time + historical)
- Field mappings for Eastmoney and Sina APIs
- Symbol format per market
- Troubleshooting tips
