tongstock-workflow
Installation
SKILL.md
TongStock Analysis Workflows
Pre-built workflows for Chinese A-share analysis using tongstock-cli. Each workflow combines multiple data sources into actionable output.
Workflow 1: Single Stock Deep Analysis (个股深度分析)
Full research report for one stock. Run all steps and synthesize.
# Step 1: Real-time quote with 5-level bid/ask
tongstock-cli quote <code>
# Step 2: Financial fundamentals
tongstock-cli finance <code>
# Step 3: Ex-rights/dividend history
tongstock-cli xdxr <code>
# Step 4: Recent daily K-lines (price trend)
tongstock-cli kline -c <code> -t day
# Step 5: Company F10 info categories
tongstock-cli company <code>
# Step 6: Get specific F10 content
tongstock-cli company-content <code> --block "公司概况" # Company profile
tongstock-cli company-content <code> --block "财务分析" # Financial analysis
tongstock-cli company-content <code> --block "股东研究" # Shareholder research
Analysis checklist:
- Current price vs. NAV per share → P/B ratio
- Net profit trend (from finance data)
- Dividend history frequency and amount (from xdxr)
- Recent price trend and volume pattern (from kline)
- Key support/resistance levels from K-line data
Workflow 2: Stock Screening by Fundamentals (基本面选股)
Screen stocks by retrieving financial data for a batch of codes.
# Step 1: Get all stock codes for a market
tongstock-cli codes -e sz > /tmp/sz_codes.txt
# Step 2: For each candidate, fetch finance data
for code in 000001 600519 000858 601318; do
echo "=== $code ==="
tongstock-cli finance $code
echo ""
done
Screening criteria to evaluate:
- Total shares & float shares → liquidity
- Net profit > 0 → profitable
- NAV per share → valuation floor
- Shareholder count trend → institutional interest
- Revenue scale → company size
Workflow 3: Dividend Analysis (分红分析)
Find stocks with consistent dividend history.
# Get ex-rights/dividend records
tongstock-cli xdxr <code>
What to look for in output:
- Category = "除权除息" entries → actual dividend events
FenHongfield → cash dividend per share (元)SongZhuanGufield → bonus/transfer shares per 10 shares- Frequency: annual dividends = positive signal
- Calculate dividend yield: FenHong / current_price × 100%
Workflow 4: Sector/Industry Analysis (板块分析)
Find which stocks belong to a sector, then analyze the sector.
# Step 1: List industry sectors
tongstock-cli block -f block_fg.dat
# Step 2: List concept sectors
tongstock-cli block -f block_gn.dat
# Step 3: For interesting sector stocks, get quotes
tongstock-cli quote <code1> <code2> <code3>
# Step 4: Compare with index
tongstock-cli index -c 999999 -t day
Analysis approach:
- Identify sector constituents from block data
- Compare individual stock performance vs. sector index
- Look for sector rotation signals (volume surge + price breakout)
Workflow 5: Technical Quick Check (技术面速查)
Fast technical overview using multiple timeframes.
# Multi-timeframe K-lines
tongstock-cli kline -c <code> -t day # Trend
tongstock-cli kline -c <code> -t 60m # Intraday trend
tongstock-cli kline -c <code> -t 5m # Short-term momentum
# Today's tick-level activity
tongstock-cli minute <code> # Minute-by-minute
tongstock-cli trade <code> # Tick trades (买卖方向)
What to evaluate:
- Daily K: overall trend direction (uptrend/downtrend/sideways)
- 60m K: medium-term momentum
- 5m K: entry/exit timing
- Minute data: intraday price pattern
- Trade data: buy vs. sell pressure (Status field: 0=buy, 1=sell)
Workflow 6: Market Overview (大盘概览)
Quick pulse of the overall market.
# Major indices
tongstock-cli index -c 999999 -t day # 上证指数
tongstock-cli index -c 399001 -t day # 深证成指
tongstock-cli index -c 399006 -t day # 创业板指
tongstock-cli index -c 399300 -t day # 沪深300
Key metrics from index bars:
- UpCount vs. DownCount → market breadth (涨跌家数)
- Volume trend → participation level
- Price vs. moving average crossovers
Workflow 7: HTTP API Batch Analysis (API 批量分析)
When the server is running, use HTTP API for programmatic access:
# Start server in background
tongstock-server &
# Batch fetch via API (JSON output, easy to parse)
curl -s "http://localhost:8080/api/quote?code=000001" | jq .
curl -s "http://localhost:8080/api/finance?code=000001" | jq .
curl -s "http://localhost:8080/api/xdxr?code=000001" | jq .
curl -s "http://localhost:8080/api/kline?code=000001&type=day" | jq .
# Compare multiple stocks
for code in 000001 600519 000858; do
echo "=== $code ==="
curl -s "http://localhost:8080/api/finance?code=$code" | jq '{code: .code, net_profit: .JingLiRun, nav: .MeiGuJingZiChan, shareholders: .GuDongRenShu}'
done
Output Interpretation Guide
Quote Fields
| Field | Meaning |
|---|---|
| Price | Latest trade price |
| LastClose | Previous close (for calculating % change) |
| SVol | Inner volume 内盘 (seller-initiated) |
| BVol | Outer volume 外盘 (buyer-initiated) |
| BidAsk[0-4] | 5-level bid/ask depth |
Finance Fields
| Field | Meaning | Unit |
|---|---|---|
| LiuTongGuBen | Float shares | 万股 |
| ZongGuBen | Total shares | 万股 |
| JingLiRun | Net profit | 万元 |
| MeiGuJingZiChan | NAV per share | 元 |
| GuDongRenShu | Shareholder count | 人 |
| ZhuYingShouRu | Revenue | 万元 |
XdXr Categories
| Category | Meaning |
|---|---|
| 1 | 除权除息 (ex-dividend) |
| 2-10 | Share capital changes |
| 11-12 | Share consolidation |
| 13-14 | Warrant issuance |
Workflow 8: Technical Indicator Analysis (技术指标分析)
Compute and display technical indicators for a single stock.
# Single stock with default parameters (table output)
tongstock-cli indicator -c <code> -t day
# JSON format output (single day)
tongstock-cli indicator -c <code> -t day --json
# JSON format with multiple days history
tongstock-cli indicator -c <code> -t day --json --days 5
# All historical data
tongstock-cli indicator -c <code> -t day --all
# Custom parameter config file
tongstock-cli indicator -c <code> -t day --config configs/params.yaml
# Different timeframes
tongstock-cli indicator -c <code> -t 60m # 60-minute
tongstock-cli indicator -c <code> -t week # Weekly
Supported Indicators:
- MA: 5, 10, 20, 60, 120 day moving averages
- MACD: DIF, DEA, Histogram (default: 12/26/9)
- KDJ: K, D, J values (default: 9/3/3)
- BOLL: Upper, Middle, Lower bands (default: 20/2.0)
- RSI: RSI6, RSI12, RSI24 (relative strength)
- Volume Ratio: Current volume / 5-day average volume
Table Output includes:
- Last 20 days: Date, Close, MA5/10/20/60/120, DIF/DEA/HIST, K/D/J, RSI6/12/24, UPPER/MID/LOWER, Volume Ratio
- Latest signals: 金叉 (golden cross), 死叉 (death cross), 超买 (overbought), 超卖 (oversold), 多头排列 (bull alignment), 空头排列 (bear alignment), 突破上轨 (break upper band), 跌破下轨 (break lower band)
JSON Output (single day):
{
"code": "000001",
"name": "平安银行",
"timestamp": "2026-03-29",
"price": { "current": 12.58, "change": 0.45, "change_pct": 3.71 },
"ma": { "ma5": 12.32, "ma10": 12.18, "ma20": 11.95, "ma60": 11.50, "ma120": 11.20, "trend": "bullish" },
"macd": { "dif": 0.35, "dea": 0.22, "hist": 0.26, "signal": "golden_cross" },
"kdj": { "k": 72.5, "d": 68.2, "j": 81.1, "signal": "overbought" },
"rsi": { "rsi6": 65.2, "rsi12": 62.8, "rsi24": 58.4, "signal": "neutral" },
"boll": { "upper": 13.20, "middle": 12.50, "lower": 11.80, "position": 0.65, "signal": "normal" },
"volume": { "current": 1250000, "avg5": 980000, "ratio": 1.28, "signal": "active" },
"signals": ["golden_cross", "overbought", "多头排列"],
"summary": { "trend": "上升趋势", "signal": "持有", "strength": 72 }
}
Parameter resolution:
- Per-stock override > Category override (large_cap/small_cap) > Default
- Categories auto-detected by code prefix (600xxx = large_cap, 002xxx = small_cap)
Workflow 9: Batch Signal Screening (批量信号筛选)
Screen a list of stocks for specific signals using parallel computation.
# Screen specific stocks for golden cross
tongstock-cli screen -c "000001,600519,000858,601318" -t day -s golden_cross
# Screen from file (one code per line)
tongstock-cli screen -f codes.txt -t day -s oversold
# Screen with concurrency control
tongstock-cli screen -c "000001,600519" -p 5 -s death_cross
Available signal filters (-s):
| Signal | Description |
|---|---|
golden_cross |
DIF crosses above DEA (MACD), or K crosses above D (KDJ) |
death_cross |
DIF crosses below DEA (MACD), or K crosses below D (KDJ) |
overbought |
J > 100 (KDJ) or RSI > 80 |
oversold |
J < 0 (KDJ) or RSI < 20 |
Combination with sector analysis:
# Step 1: Get sector stocks
tongstock-cli block -f block_fg.dat | grep "银行" > banking.txt
# Step 2: Screen for signals
tongstock-cli screen -f banking.txt -t day -s golden_cross -p 8
Output table columns:
- Code, Date, Close, MA5/10/20, DIF, K, J, Latest Signals
Related skills