tongstock-cli（tongstock CLI 搜索）

TongStock CLI & HTTP API Reference

TDX (通达信) protocol client for Chinese A-share market data (Shanghai, Shenzhen, Beijing exchanges).

Prerequisites

# Build from source
git clone https://github.com/sjzsdu/tongstock.git
cd tongstock
go build -o tongstock-cli ./cmd/cli
go build -o tongstock-server ./cmd/server

# Verify
./tongstock-cli --help

CLI Commands

quote — Real-time Quotes (五档行情)

tongstock-cli quote <code> [code2 ...]

Returns: price, open, high, low, volume, amount, last close, bid/ask 5 levels, inner/outer volume.

tongstock-cli quote 000001              # 平安银行
tongstock-cli quote 000001 600000       # Multiple stocks
tongstock-cli quote 600519              # 贵州茅台

codes — Stock Code List (股票代码)

tongstock-cli codes <subcommand> [flags]

Subcommands

Flags

Categories

Examples

# 默认列出深圳市场所有证券
tongstock-cli codes list

# 上海市场
tongstock-cli codes list -e sh

# 北京市场
tongstock-cli codes list -e bj

# 按分类过滤 - 只显示股票
tongstock-cli codes list -e sz -c stock

# 按分类过滤 - 只显示ETF
tongstock-cli codes list -e sz -c etf

# 查看统计信息
tongstock-cli codes stats

# 查看所有交易所统计
tongstock-cli codes stats --all

# 按交易所过滤
tongstock-cli codes stats -e sh

kline — K-line (Candlestick) Data

tongstock-cli kline --code <code> --type <type> [--all]

K-line types:

tongstock-cli kline -c 000001 -t day
tongstock-cli kline -c 600519 -t week
tongstock-cli kline -c 000001 -t 5m
tongstock-cli kline -c 000001 -t day --all   # Full history

index — Index K-line (指数K线)

tongstock-cli index --code <code> --type <type>

Same flags as kline. Returns additional fields: UpCount (上涨家数), DownCount (下跌家数).

Common index codes:

• 999999 — 上证指数
• 399001 — 深证成指
• 399006 — 创业板指
• 399300 — 沪深300

tongstock-cli index -c 999999 -t day     # 上证指数 daily
tongstock-cli index -c 399300 -t 5m      # 沪深300 5-minute

minute — Intraday Minute Data (分时数据)

tongstock-cli minute <code>

tongstock-cli minute 000001

trade — Tick-by-tick Trades (分笔成交)

tongstock-cli trade <code> [--history] [--date <YYYYMMDD>]

tongstock-cli trade 000001                              # Today
tongstock-cli trade 000001 --history --date 20250314    # Historical

xdxr — Ex-rights & Dividends (除权除息)

tongstock-cli xdxr <code>

Returns history of: dividends (分红), bonus shares (送股), rights issue (配股), share capital changes (股本变动).

tongstock-cli xdxr 000001
tongstock-cli xdxr 600519

finance — Financial Data (财务数据)

tongstock-cli finance <code>

Returns: total shares, float shares, total assets, net assets, revenue, net profit, NAV per share, shareholder count, IPO date, etc.

tongstock-cli finance 000001
tongstock-cli finance 600519

company — Company Info / F10 (公司信息)

tongstock-cli company <code>

Lists available F10 document categories (latest tips, company profile, financial analysis, shareholder research, etc).

tongstock-cli company 000001

company-content — Company Info Content / F10 (公司信息内容)

tongstock-cli company-content <code> [filename] [--block <name>] [--start <offset>] [--length <length>]

Available F10 blocks:

tongstock-cli company-content 000001                          # Basic usage
tongstock-cli company-content 000001 --block "公司概况"       # By block name
tongstock-cli company-content 000001 --block "财务分析"       # Financial analysis
tongstock-cli company-content 000001 --start 30744 --length 9560  # By range

block — Sector Classification (板块分类)

tongstock-cli block <subcommand> [flags]

Subcommands

Flags

Available Block Files

Examples

# 列出所有板块文件
tongstock-cli block files

# 列出指数板块（默认）
tongstock-cli block list -f block_zs.dat

# 按Type过滤（2=标准板块）
tongstock-cli block list -f block.dat -t 2

# 按成分股数量排序
tongstock-cli block list -f block_fg.dat -s

# 显示板块成分股
tongstock-cli block show "沪深300" -f block_zs.dat

# 模糊搜索板块
tongstock-cli block show "银行" -f block_fg.dat

# 按股票代码查询所属板块
tongstock-cli block show --code 600519

indicator — Technical Indicators (技术指标)

tongstock-cli indicator --code <code> --type <type> [--all] [--count <n>] [--json]

Computes MACD, KDJ, MA(5/10/20/60/120), BOLL, RSI(6/12/24), Volume Ratio indicators with signal detection.

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

# Basic usage (table output)
tongstock-cli indicator -c 000001 -t day

# Full history
tongstock-cli indicator -c 000001 -t day --all

# Custom K-line count
tongstock-cli indicator -c 000001 -t day --count 500

# JSON output (for program parsing)
tongstock-cli indicator -c 000001 -t day --json

JSON Output Format:

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

screen — Signal Screening (信号筛选)

tongstock-cli screen --codes <codes> --type <type> --signal <signal>

Available Signals:

• golden_cross - 金叉 (DIF crosses above DEA, or K crosses above D)
• death_cross - 死叉 (DIF crosses below DEA, or K crosses below D)
• overbought - 超买 (J > 100 or RSI > 80)
• oversold - 超卖 (J < 0 or RSI < 20)

tongstock-cli screen -c "000001,600519" -t day -s golden_cross
tongstock-cli screen -f codes.txt -t day -s oversold

count — Securities Count (证券数量)

tongstock-cli count [--exchange <sz|sh|bj>]

tongstock-cli count
tongstock-cli count -e sh
tongstock-cli count -e bj

auction — Call Auction (集合竞价)

tongstock-cli auction <code>

tongstock-cli auction 000001

HTTP API

Start server: tongstock-server (listens on :8080)

Core APIs

API Examples

# 查询行情
curl "http://localhost:8080/api/quote?code=000001"

# 股票代码列表（带分类）
curl "http://localhost:8080/api/codes/list?exchange=sz&category=stock"
curl "http://localhost:8080/api/codes/list?exchange=sz&category=etf"

# 股票代码统计
curl "http://localhost:8080/api/codes/stats?exchange=sz"
curl "http://localhost:8080/api/codes/stats?all=true"

# 查询K线
curl "http://localhost:8080/api/kline?code=000001&type=day"

# 板块文件列表
curl "http://localhost:8080/api/block/files"

# 板块列表（过滤+排序）
curl "http://localhost:8080/api/block/list?file=block_zs.dat&type=2&sort=true"

# 板块成分股
curl "http://localhost:8080/api/block/show?name=沪深300&file=block_zs.dat"

# 按股票代码查询所属板块
curl "http://localhost:8080/api/block/show?code=600519"

# 查询财务数据
curl "http://localhost:8080/api/finance?code=600519"

# 查询除权除息
curl "http://localhost:8080/api/xdxr?code=000001"

# 技术指标
curl "http://localhost:8080/api/indicator?code=000001&type=day"

Caching

Codes and Block APIs are cached in SQLite for 24 hours:

• codes.db - codes cache
• blocks.db - blocks cache

Stock Code Conventions

Codes can be passed as 6-digit (auto-detected) or 8-digit with prefix (sh600000, sz000001, bj830001).