Finflow — Chinese Financial Data CLI
Finflow (@openduo/finflow) aggregates real-time data from four Chinese financial platforms: CLS (财联社), Jin10 (金十), Xueqiu (雪球), and Gelonghui (格隆汇).
Core Principles
- Run via Bash:
finflow <command>— if not found, install first withnpm install -g @openduo/finflow - Stock code formats are flexible:
sh600519,SH600519,600519all work — the CLI normalizes internally - Global markets supported: A-shares (
SH600519), HK stocks (00700,09988), US stocks (AAPL,NVDA,.DJI) - Default output is JSON with
{data, meta}envelope. Use-f textonly when the user wants human-readable tables. Use-f rawfor debugging.
Global Options (apply to all commands)
| Flag | Default | Description | ||
|---|---|---|---|---|
-n <num> | 10 | Number of items | ||
| `-f json\ | text\ | raw` | json | Output format |
-h | — | Show help |
Command Reference
Stock Quotes — quote
quote <code> — Single stock quote (CLS)
quote batch <codes...> — Batch quotes (Xueqiu). Auto-prefixes SH/SZ for 6-digit A-share codes. Supports HK/US stocks.
quote batch sh600519 sz000858 # A股
quote batch 00700 09988 # 港股（纯数字代码）
quote batch AAPL NVDA TSLA .DJI # 美股quote search <keyword> — Search stocks (Xueqiu)
quote search 白酒quote related <code> — Related stocks (Xueqiu)
quote kline <code> — K-line data
| Flag | Alias | Default | Values | Description |
|---|---|---|---|---|
--period | -p | d | d w m y 5d 1m 5m 15m 30m 60m 120m | Period |
--number | -n | 120 | number | Number of candles |
--src | — | auto | cls xq | Data source |
Source auto-selection: minute periods (1m 5m 15m 30m 60m 120m) auto-use xueqiu; daily+ default to cls. For US/HK stocks, always use --src xq.
quote kline sh600519 -p d -n 120 # 日K 120根 (cls)
quote kline sh600519 -p 5m -n 48 # 5分钟K线 (xueqiu, auto)
quote kline sh600519 -p w # 周K (cls)
quote kline sh600519 -p d --src xq # 强制用雪球quote depth <code> — 5-level order book
| Flag | Default | Values | Description |
|---|---|---|---|
--src | cls | cls xq | Data source |
quote ticks <code> — Tick-by-tick trades. Options same as depth.
quote timeline <code> — Intraday timeline. Options same as depth.
quote sector — Sector/plate data
| Subcommand | Args | Options | Description |
|---|---|---|---|
sector rank | — | -t <type> (default: industry) | Plate ranking. Type: industry concept |
sector plate <code> | code | — | Stock's associated plates |
sector industry <code> | code | — | Industry info (xueqiu) |
Default (no subcommand): with code → plate, without → rank -t industry.
Capital Flow — quote flow
| Subcommand | Args | Options | Source | Description |
|---|---|---|---|---|
| (default) | code | — | cls | Per-stock fund flow (main in/out, super/large/medium/small) |
flow market | — | — | glh | Northbound/southbound capital |
flow history <code> | code | -c <num> (default: 20) | xq | Historical flow + 3d/5d/10d/20d net |
flow margin <code> | code | — | xq | Margin trading data |
flow intraday <code> | code | — | xq | Intraday capital flow |
flow xq <code> | code | — | xq | Xueqiu capital flow |
Default without code → shows market flow (same as flow market).
Fundamentals — quote f10 / quote finance
quote f10 subcommands (all require xueqiu login):
| Subcommand | Description |
|---|---|
f10 indicator <code> | Key indicators: ROE, EPS, gross margin, revenue growth |
f10 holders <code> | Top 10 shareholders |
f10 bonus <code> | Dividend history (up to 15 items) |
f10 event <code> | Corporate events (up to 20 items) |
quote finance <code> — Financial statements (xueqiu login):
| Flag | Alias | Default | Values | Description |
|---|---|---|---|---|
--type | -t | indicator | indicator cashflow income balance | Report type |
| Type | Content |
|---|---|
indicator | ROE, EPS, gross margin, revenue YoY |
income | Revenue, net profit, attributable net profit |
balance | Total assets, liabilities, debt ratio, equity |
cashflow | Operating, investing, financing, net increase |
News & Flash — info
info flash — Flash/breaking news
| Flag | Alias | Default | Values | Description |
|---|---|---|---|---|
--src | -s | cls | cls jin10 glh | Data source |
--category | -c | varies | varies by source | Category/channel filter |
CLS categories (-s cls): all red announcement watch hk_us fund remind GLH categories (-s glh): all popular AStock HKStock USStock fundLive ai international chineseMainland hongkongMacaoTaiwan virtualAssets exchangeCommodity house debenture
| Subcommand | Args | Extra Options | Notes |
|---|---|---|---|
flash important | — | --channel <glh_channel> | Important news (glh) |
flash popular | — | — | Popular flash (glh) |
flash detail <id> | id | — | Flash detail (jin10, tries browser cookie) |
flash date <date> | date | — | Historical flash (jin10, requires login) |
flash live [channel] | channel | --interval <sec> (default: 10) | Real-time monitoring (glh, infinite loop) |
info news — Articles
| Subcommand | Args | Description |
|---|---|---|
| (default) | — | CLS headline news |
news depth [channel] | channel | CLS deep articles. Channels: headline ashare world company realestate finance_ch hkstock fund broker auto tech pinjian |
news slide | — | Important events slideshow (jin10) |
news feature | — | Featured articles (jin10) |
news hot | — | Hot articles ranking (cls) |
news stock <code> | code | Per-stock news (cls) |
info report <code> — Institutional research reports (xueqiu, requires login)
info topic — Topics
| Subcommand | Args | Description |
|---|---|---|
| (default) | — | List all topics (jin10) |
topic search <keyword> | keyword | Search topics |
topic groups | — | Topic category groups |
topic hot | — | Hot CLS subjects |
topic show <id> | id | Articles in topic (jin10, tries browser cookie) |
Market Overview — market
| Subcommand | Args/Options | Source | Description | |
|---|---|---|---|---|
| (default) | — | glh | Major indices + Shanghai/Shenzhen capital flow | |
market emotion | — | cls | Market sentiment: limit-up/down, seal rate, turnover, distribution | |
market rank [type] | type: change volume amount turnover amplitude (default: change) | cls | Stock ranking | |
market index | — | glh | Major market indices | |
market hk [sort] | sort: netChange turnoverValue turnVolume (default: netChange). `-o asc\ | desc (default: desc`) | glh | HK stock ranking |
market flow | — | glh | Northbound/southbound capital flow | |
market rates | — | jin10 | Global central bank interest rates |
Macro Calendar — calendar
All subcommands accept an optional <date> argument (defaults to today).
| Subcommand | Source | Description |
|---|---|---|
calendar invest [date] | cls | A-share investment calendar |
calendar macro [date] | jin10 | Global macro data releases |
calendar event [date] | jin10 | Macro events (speeches, decisions) |
calendar holiday [date] | jin10 | Global holidays |
calendar ashare | jin10 (WS) | A-share major events |
calendar hk [date] | jin10 (WS) | HK stock data calendar |
calendar us [date] | jin10 (WS) | US stock data calendar |
calendar future-event [date] | jin10 | Futures calendar events |
calendar future-holiday [date] | jin10 | Futures calendar holidays |
All dates default to today, format: YYYY-MM-DD.
Default (no subcommand): same as calendar invest with today.
Futures — future
Top-level --channel / -c applies to all subcommands:
| Channel | Description |
|---|---|
all | 全部 (default) |
oil | 原油 |
steel | 钢铁 |
coal | 煤炭 |
gas | 天然气 |
metal | 金属 |
nonferrous | 有色金属 |
chemical | 化工 |
sugar | 白糖 |
grain | 粮食 |
pig | 生猪 |
macro | 宏观 |
| Subcommand | Description |
|---|---|
| (default) | Futures flash news (paginated) |
future headline | Futures headlines |
future basis [date] | Spot-futures basis. -g <group>: 黑色系 金属 农产品 能源化工 金融 |
future calendar [date] | Futures data calendar |
future event [date] | Futures calendar events |
future holiday [date] | Futures calendar holidays |
Portfolio — portfolio (requires xueqiu login)
| Subcommand | Args | Options | Description |
|---|---|---|---|
| (default) | — | — | List all groups (stocks/cubes/funds) |
portfolio stocks <pid> | pid: -1=all, -5=沪深 | — | View stocks with live quotes |
portfolio stocks add <symbol> | symbol | -c <gid> (default: 1) | Add stock to group |
portfolio stocks remove <symbol> | symbol | -c <gid> (default: 1) | Remove stock from group |
portfolio cube <code> | code | — | Cube NAV trend (up to 20) |
portfolio cube holding <code> | code | — | Cube holdings with weight/price |
Config — config
| Subcommand | Args | Description |
|---|---|---|
config cookie [value] | value | Set/show xueqiu cookie. Without value: shows masked current cookie |
config login | — | Auto-extract from macOS Chrome (Keychain + AES-128-CBC) |
Cookie Requirements
Most commands work without login. These require xueqiu cookie (finflow config login):
quote f10,quote finance,quote flow history/margin/intraday/xqportfolio(all subcommands),info reportquote depth/timeline --src xq,quote kline --src xq
Jin10 commands (info flash detail, info flash date, info topic show, calendar macro/event/holiday) try browser cookie automatically, work without it but with less data.
Data Interpretation Tips
meta.sourcetells you which platform the data came from — useful context for freshness- CLS flash is fastest for A-share breaking news
market emotionshows limit-up/down counts, seal rates — key sentiment indicatorsquote flow marketshows northbound (沪港通/深港通) capital — important for A-share trend- Non-trading hours: some commands return empty data (emotion, timeline)
- CLS flash with jin10 source auto-paginates up to 50 pages (slow for large
-n)
Common Workflows
"茅台现在多少钱？" → quote sh600519 "帮我看看今天大盘怎么样" → market emotion + market index "今天有什么财经新闻" → info flash -n 20 "美股那边有什么重要新闻" → info flash -s glh -c USStock "白酒板块怎么样" → quote sector rank -t concept (filter by name for 白酒) "北向资金今天流入多少" → quote flow market "帮我看看贵州茅台的财务数据" → quote f10 indicator sh600519 + quote finance sh600519 -t income "今天有什么宏观事件" → calendar macro "今晚美国有什么CPI数据" → calendar macro 2026-04-10 (filter by country=美国) "期货方面有什么消息" → future headline or future -c oil "最近的原油期现基差" → future basis -g 能源化工 "今天涨停板排行" → market rank change "港股成交额排行" → market hk turnoverValue