Baostock Skill

Query Chinese A-share market data using BaoStock. Use when user asks for stock quotes, historical K-line, fundamentals, or market analysis. Supports real-time quotation, daily/minute data, financial reports.

BaoStock Finance Skill

This skill wraps BaoStock (http://baostock.com) to provide easy access to Chinese A-share market data. BaoStock is a stable domestic data source with no compilation requirements.

What It Does

• Real-time quotes: Latest price, volume, change for A-shares
• Historical data: Daily, weekly, monthly, minute bars
• K-line data: OHLC with adjust factors (qfq, hfq)
• Financial data: Basic indicators, PE/PB, market cap
• Index data: SSE, SZSE, CSI indices
• Stock basics: List of A-shares, industry classification

When to Use

User asks like:

• "查询贵州茅台最新股价"
• "获取宁德时代最近30天的日线数据"
• "列出所有银行股"
• "分析中国平安的市盈率"
• "获取上证指数历史数据"

How to Invoke

bash

# Single stock quote
baostock --symbol sh600519 --type quote

# Historical K-line (daily)
baostock --symbol sh600519 --type history --start-date 2024-01-01 --end-date 2024-12-31

# Minute data (5-minute intervals)
baostock --symbol sh600519 --type history --frequency 5 --start-date 2024-03-01

# Stock list (all A-shares)
baostock --type stock-list

# Index data
baostock --symbol sh000001 --type index-history --start-date 2024-01-01

Dependencies

• Python 3.8+
• baostock package (pip install baostock)
• pandas (should be installed)

bash

pip3 install baostock

Data Source

BaoStock fetches data from BaoXin (宝新) data provider. It is:

• ✅ Domestic source, no external network issues
• ✅ Free for non-commercial use
• ✅ Supports minute-level data
• ⚠️ Some delay for real-time data (~15 min for minute bars)

Output Format

Default: JSON

json

{
  "symbol": "sh600519",
  "name": "贵州茅台",
  "price": 1680.50,
  "change": 1.23,
  "pct_change": 0.07,
  "volume": 1234567,
  "amount": 2000000000,
  "timestamp": "2025-03-18 15:00:00"
}

For historical data:

json

[
  {
    "date": "2025-03-18",
    "open": 1670.00,
    "high": 1690.00,
    "low": 1668.50,
    "close": 1680.50,
    "volume": 1234567,
    "amount": 2000000000
  }
]

Integration with OpenClaw

This skill can be assigned to finance.yaml role:

yaml

plugins:
  allow:
    - baostock-skill
    - feishu-doc
    - feishu-bitable

Limitations

• Real-time quotes are actually 15-min delayed (free tier)
• Some stocks may have missing data (new listings)
• No direct access to order book (Level 2)
• API rate limits: ~100 requests/minute

Troubleshooting

Issue	Check
Import error	pip3 install baostock
No data returned	Check symbol format (sh/sz prefix) and trading day
Network error	BaoStock uses domestic servers; should be fine

Examples

bash

# Get all stock names and codes
baostock --type stock-list --output stocks.csv

# Get daily history for last 30 days
baostock --symbol sh600519 --type history --days 30

# Get 5-minute bars for today (if market open)
baostock --symbol sh600519 --type history --frequency 5