ClawHub

Baostock Skill

Finance
#financial#stock

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.

Install

openclaw skills install @liyico/baostock-skill

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

# 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)
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

{
  "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:

[
  {
    "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:

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

IssueCheck
Import errorpip3 install baostock
No data returnedCheck symbol format (sh/sz prefix) and trading day
Network errorBaoStock uses domestic servers; should be fine

Examples

# 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
More in Finance