# Xueqiu

> Xueqiu (雪球)

- Skill: `spike-faye-lei/xueqiu` (Agent Skill, multi-file: 14 files)
- Install (CLI): `npx skillmds@latest add spike-faye-lei/xueqiu`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spike-faye-lei/xueqiu/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spike-faye-lei (https://skillmd.com/u/spike-faye-lei)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spike-faye-lei/xueqiu

---

# Xueqiu (雪球)

## Overview
Chinese finance and social investing platform. Stock quotes, order book, industry comparisons, market events, and social discussion feed.

## Workflows

### Search and inspect a stock
1. `searchStocks(q)` → `list[].code` (e.g. SH600519)
2. `getStockQuote(symbol=code)` → real-time price, volume, market cap
3. `getOrderBook(symbol=code)` → bid/ask depth at 5 levels

### Analyze stock history and fundamentals
1. `searchStocks(q)` → `list[].code`
2. `getStockKline(symbol=code, begin, period)` → historical candlestick data (OHLCV)
3. `getStockFinancials(symbol=code)` → ROE, EPS, revenue, net profit per period

### Community sentiment on a stock
1. `searchStocks(q)` → `list[].code`
2. `getStockComments(symbol=code)` → user posts and discussions about the stock

### Compare industry peers
1. `searchStocks(q)` → `list[].code`
2. `getIndustryStocks(code ← searchStocks)` → all stocks in same industry with price, PE, market cap

### Browse market activity
1. `getHotEvents` → trending market topics with heat scores
2. `getTimeline` → social discussion feed with posts and authors

### Track watchlist
1. `getWatchlist(pid)` → user's followed stocks with `stocks[].symbol`, live prices (requires login)

## Operations

| Operation | Intent | Key Input | Key Output | Notes |
|-----------|--------|-----------|------------|-------|
| searchStocks | search stocks by keyword | `q` | code, name, exchange, current, percentage | entry point |
| getStockQuote | real-time stock quote | `symbol` ← searchStocks.code | current, percent, chg, volume, market_capital, high, low | supports batch (comma-separated) |
| getOrderBook | bid/ask order book | `symbol` ← searchStocks.code | bp1-5/bc1-5 (bids), sp1-5/sc1-5 (asks) | A-share stocks only |
| getStockKline | candlestick chart data | `symbol` ← searchStocks.code, `begin` (ms timestamp), `period` | column names + OHLCV data arrays | periods: day/week/month/1m-120m |
| getStockFinancials | financial indicators | `symbol` ← searchStocks.code, `type` (Q1-Q4/all), `count` | avg_roe, basic_eps, total_revenue, net_profit, gross_margin | CN A-share stocks |
| getStockComments | stock discussion feed | `symbol` ← searchStocks.code, `count`, `sort`, `source` | posts with description, author, reply_count, fav_count | paginated |
| getWatchlist | user's stock watchlist | `pid` (-1 for default) | stocks[].symbol, name, current, percent, market_capital | requires login |
| getHotEvents | trending market events | `count` (optional) | tag, hot, status_count, content | entry point |
| getTimeline | hot discussion feed | `since_id`, `max_id`, `size` | posts with title, description, author, timestamps | paginated via next_max_id |
| getIndustryStocks | industry peer stocks | `code` ← searchStocks.code | symbol, name, current, percentage, pe_ttm, marketCapital | |

## Quick Start

```bash
# Search for a stock
openweb xueqiu exec searchStocks '{"q":"茅台","count":10}'

# Get real-time quote (supports batch: "SH600519,AAPL")
openweb xueqiu exec getStockQuote '{"symbol":"SH600519"}'

# Get order book depth
openweb xueqiu exec getOrderBook '{"symbol":"SH600519"}'

# Get K-line chart data (30 days before timestamp)
openweb xueqiu exec getStockKline '{"symbol":"SH600519","begin":1712505600000,"period":"day","count":-30}'

# Get financial indicators (last 5 annual reports)
openweb xueqiu exec getStockFinancials '{"symbol":"SH600519","type":"Q4","count":5}'

# Get stock community discussion
openweb xueqiu exec getStockComments '{"symbol":"SH600519","count":10,"sort":"time"}'

# Get user's watchlist (requires login)
openweb xueqiu exec getWatchlist '{"pid":-1,"category":1,"size":100}'

# Get hot market events
openweb xueqiu exec getHotEvents '{"count":10}'

# Browse social timeline
openweb xueqiu exec getTimeline '{"since_id":-1,"max_id":-1,"size":15}'

# Get industry peers
openweb xueqiu exec getIndustryStocks '{"code":"SH600519","type":1,"size":30}'
```