tongstock-workflow（同材工作流程）

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
• FenHong field → cash dividend per share (元)
• SongZhuanGu field → 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

Finance Fields

XdXr Categories

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

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