Finflow — Chinese Financial Data CLI

Finflow (@openduo/finflow) aggregates real-time data from four Chinese platforms — CLS (财联社), Jin10 (金十), Xueqiu (雪球), Gelonghui (格隆汇) — with Yahoo Finance as a fallback for markets they don't cover (Japan/Korea/HK/US). Cover A-shares, HK, US stocks, futures, commodities, forex, global indices, macro & flash news.

Core principles

1. Run via Bash: finflow <command> — install first if missing: npm install -g @openduo/finflow.
2. Stock codes are flexible: sh600519, SH600519, 600519 all work — the CLI normalizes internally.
3. Markets: A-shares (SH600519), HK (00700), US (AAPL, NVDA, .DJI). JP/KR and Yahoo-only symbols fall back to Yahoo.
4. Output is always one compact JSON line — {"data": {...}, "meta": {"source", "timestamp", "command"}}. Parse it (pipe to jq or python).
5. Percent fields are percentage numbers, not ratios: changePercent: -4.34 means -4.34% (NOT -0.0434 or -434%). This holds for every percent-named field across every command — changePercent, percent, turnoverRate, amplitude, pe, pb, dividendYield, etc. Display them verbatim with a %; never ×/÷ 100. (change is the absolute price delta — a different field.)
6. Name → code first: if a company is named without a code (茅台/宁德时代/腾讯), run quote search <名字> to get the code before quoting. Never guess a code from a name.

The golden rule: classify the question, then pick ONE command

Almost every market question maps to a single finflow command that pulls the whole picture at once. The #1 source of bad answers is reconstructing data from memory — listing "半导体/AI/白酒" tickers by hand, guessing an index code, etc. Before running anything, classify what the user is actually asking (which kind of 板块? per-stock or market-wide flow? snapshot or multi-period?), then pick from the tables below. The data is one command away.

❌→✅ Anti-patterns (do not do these)

"板块 / 行业 / 概念 / 市场" — four meanings, four commands

Chinese "板块" is overloaded. The single word that causes the most misuse. Match the user's word to its real meaning first:

拿不准是行业还是概念？先试 quote industry（申万覆盖了绝大多数真实行业）；如果明显是一个题材叙事/政策主题，就走概念。想看"整个板块今天涨跌排第几"用 sector rank。永远不要因为分不清就退回去凭记忆列股票——直接拉，拉不到再换下一种。

Intent → command (pick by what the user wants)

A. Single stock (个股)

B. Sector / industry / concept / board (板块)

C. Fundamentals & statements (基本面/财报) — f10 ≠ finance

D. Market overview (大盘/市场) — don't guess index codes

两种"异动"别混：盘中实时板块轮动/拉升跳水时间轴 = sector anchor（板块项的 cls 码直接 sector <code> 下钻成分股）；官方收盘后龙虎榜（异常波动上榜） = market longhu。某股异动后想找同行业联动股用 quote related（同概念板块成员用 sector plate → sector <plate>）。

E. Capital flow (资金面) — per-stock vs market-wide

F. News & info (资讯) — quote search ≠ info search

G. Macro / calendar / futures

Global options

Name → code lookup

To turn a company name into a tradable code, run finflow quote search <keyword> (Xueqiu, live). It is the single source of truth — it covers all three markets in one call (A-shares + HK + US), which a per-market offline list cannot, and it stays current as stocks list/rename. No login, cookie, or local index needed.

Each hit is {code, name, type}. type is always "stock" — don't filter on it; read the market/instrument from the code prefix instead:

A name that is also listed in HK/US returns all of them at once (e.g. 比亚迪 → SZ002594 A, 01211 H, BYDDY US ADR) — pick by prefix.

Two boundaries to expect:

• Concept/industry words return plates, indices, and ETFs — not a member-stock list. quote search 半导体 gives you BK0021 半导体 and SOXX/SOXL, not the constituent stocks. For industry → its stocks, use quote industry <indcode>; for concept → its members, use sector <platecode>.
• Search matches the official security name (substring/prefix), not slang. 茅台 works (it's a substring of 贵州茅台); pure market slang like 宁王 returns nothing — normalize it to the official name/短称 before searching.

Command Reference (detailed syntax)

quote — securities

quote <code> — Single quote (CLS, auto-fallback xq → Yahoo).

quote batch <codes...> — Batch (Xueqiu, single-source, no fallback). Auto-prefixes SH/SZ for 6-digit A-share codes; supports HK/US.

quote batch sh600519 sz000858        # A股
quote batch 00700 09988               # 港股
quote batch AAPL NVDA TSLA .DJI       # 美股

quote search <keyword> — Search by name/code across A/HK/US (Xueqiu, live). This is the name → code entry point — see [Name → code lookup](#name--code-lookup) above for the code-prefix conventions and the two boundaries (concept words return plates not members; slang isn't matched). Note: -n has no effect here — it always returns the top ~10 hits.

quote search 比亚迪          # → SZ002594 (A) · 01211 (H) · BYDDY (US ADR)

quote related <code> — Same-industry peers (Xueqiu). The one-command 以点扩面 (茅台 → 五粮液/泸州老窖/洋河/古井贡酒).

quote industry [indcode] [--market cn|us|hk] — Industry → member stocks (Xueqiu). indcode is a 行业代码 (板块ID) — NOT a stock code. Each market uses a different classification:

• No ind_code → lists all industries of that market {code, name, pinyin} (run first to find the code).
• With ind_code → that industry's stocks. Pass the matching --market (codes differ per market).

This is industry → stocks. It is not "which industry does stock X belong to" (don't pass a stock code).

quote board <type> — Stocks by board/market (Xueqiu). Market is derived from <type>, no flag:

| type | board | | type | board | |------|-------|-|------|-------| | shsz | 沪深一览 | | shb | 沪市B股 | | sha | 沪市A股 | | szb | 深市B股 | | sza | 深市A股 | | zxb | 中小板 | | cyb | 创业板 | | xsbno | 新三板协议 | | kcb | 科创板 | | xsbin | 新三板做市 | | us | 美股一览 | | uschina | 中概股 | | hk | 港股一览 | | | |

industry & board share these options:

--order-by keys (only these are confirmed sortable; unknown key → empty): current(当前价) chg(涨跌额) percent(涨跌幅) currentyearpercent(年初至今) volume(成交量) amount(成交额) turnoverrate(换手率) pettm(市盈率TTM) dividendyield(股息率) marketcapital(市值).

Each returned stock: {code, name, price, changePercent, amount, volume, marketCap, pe, pb, turnoverRate}.

quote industry                       # list 申万 (A股) industries
quote industry S2701 -n 20           # A股 半导体, top 20 by 涨跌幅
quote industry 453010 --market us -n 10   # 美股 半导体
quote board cyb                      # 创业板 涨跌幅 ranking
quote board kcb --order-by market_capital -n 5   # 科创板 市值前5
quote board us_china                 # 中概股一览

quote kline <code> — K-line.

Minute periods (1m…120m) auto-use xueqiu; daily+ default to cls. US/HK → always --src xq.

quote depth <code> — 5-level order book. quote ticks <code> — tick trades. quote timeline <code> — intraday line. All take --src cls|xq (US/HK → xq).

sector — the whole plate/concept workflow in one command group (CLS).

The workflow: sector anchor (今日哪些板块异动) → grab a plate's cls* code → sector <code> (一键下钻成分股) → quote <stock> (挑个股). Or bottom-up: sector plate <stock> (个股属于哪些板块) → sector <plate> (同板块兄弟股).

platecode (cls plate id, e.g. cls80405=华为产业链) — get it by reverse-lookup: sector plate <stock> where <stock> is ANY stock you know is in the concept (e.g. 润和软件 sz300339 → 华为产业链 cls80405); the result lists that stock's plates, each with a code. Then sector <platecode>. For same-industry peers use quote related instead; for a stock's industry profile (F10) use quote industry-profile <code>. (sector rank -t concept only lists today's ~6 hot concepts — don't rely on it to find a specific concept's code.)

quote flow — capital flow

Default without code → market flow (same as flow market).

quote f10 / quote finance — fundamentals (Xueqiu)

quote f10 <code> with no subcommand → indicator.

quote finance <code> — multi-period statements:

info — news & flash

info flash — flash/breaking news.

CLS categories: all red announcement watch hk_us fund remind. GLH categories: all popular AStock HKStock USStock fundLive ai international chineseMainland hongkongMacaoTaiwan virtualAssets exchangeCommodity house debenture.

info news — articles.

info topic — topics.

info search — full-site search (news/articles/stocks). Not for resolving stock codes — use quote search for that.

market — overview

calendar — macro

All accept optional <date> (default today, YYYY-MM-DD).

Default (no subcommand) → calendar macro today.

future — futures

Top-level --channel/-c applies to all: all(默认) oil steel coal gas metal nonferrous chemical sugar grain pig macro.

price — real-time futures / commodity / forex / index quotes

Live price snapshots (source: jin10 market-ws, ~2–3s push, no auth) for the instruments the A/HK/US stock commands don't cover: domestic futures, spot commodities, forex, global indices. This is the counterpart to quote (stocks) — use price for any CODE.EXCHANGE-form symbol.

price XAUUSD.GOODS i9888.DCE DXY.NYF    # CODE.EXCHANGE codes, space-separated
price                                    # default watchlist (12 mainstream instruments)

Each item: {code, price, change, changePercent, open, high, low, preclose, openInterest, turnover, timestamp}. changePercent is a percentage number (show with %); preclose = 昨结算 (domestic futures) or 昨收 (international) — the change reference. Codes are passed through verbatim (case-preserving) — both market-ws and the OSS K-line path are case-sensitive (i9888.DCE ≠ I9888.DCE); use the exact case from the table or symbolist.

quote vs price: quote = securities with stock codes (SH600519 / 00700 / AAPL); price = everything market-ws streams, codes contain a . exchange suffix (XAUUSD.GOODS / i9888.DCE / DXY.NYF / SPX.INDEX).

Constructing codes — lookup the product code, then apply the rule. Only 主力合约 (888/9888), 连续合约 (c1), and active 现货/外汇/指数 stream live.

国内期货主力 — 主力码 = 产品码 + 后缀，总长固定 5：1 字母产品码加 9888，2 字母产品码加 888。查下表得产品码 → 拼接 → 加交易所后缀（.DCE/.SHF/.CZC/.INE/.CF/.GFEX）。例：铁矿石 i→i9888.DCE；螺纹钢 rb→rb888.SHF；十年国债 T→T9888.CF。

具体月份合约（非主力，按需拼）：国内 = 产品码 + YYMM（i2509=铁矿石25年09月，rb2510，au2506）。

国际期货连续合约 = 产品码 + c1，加交易所后缀：

例：GCc1.CMX(COMEX金) CLc1.NYM(WTI油) SIc1.CMX(COMEX银) SGXCNc1.SGX(A50)。

现货商品 (CODE.GOODS): XAUUSD=黄金 XAGUSD=白银 XPDUSD=钯金 XPTUSD=铂金 USOIL=WTI原油 UKOIL=布伦特 NGAS=天然气 COPPER=铜 NGAS=天然气。 外汇 (CODE.NYF/.FXCM/.BANK): 货币对 = 基础+报价货币 — DXY=美元指数 EURUSD GBPUSD USDJPY USDCAD AUDUSD NZDUSD USDCNH=离岸人民币 USDCHF=瑞郎。 全球指数 (CODE.INDEX): SPX=标普500 DJI=道琼斯 NDX=纳指100 HSI=恒生 N225=日经225 KS11=韩国KOSPI GDAXI=德国DAX FCHI=法国CAC 000001.SH=上证综指。 上海金/银 T+D (CODE.ICBCM): Au(T+D) Ag(T+D) mAu(T+D) Au99.99。

Querying more symbols: full DB at https://app-server.jin10.com/symbolisthero0507.txt (gzip JSON, ~90k, schema c/m/n/d/t/r; subscribe as c + "." + m). For codes not in the tables above (小品种, 期权, historical months), fetch it and search by n (Chinese name). Non-streaming codes return no snapshot.

price kline — K-line history for non-equity instruments

Historical candles for the same CODE.EXCHANGE symbols price covers, via tm-qtg (10006 file list → OSS download). Source: jin10 tm-qtg. No guest token needed (register with empty token).

price kline XAUUSD.GOODS -p d -n 120      # 现货黄金 日线 120 根
price kline i9888.DCE -p 5m -n 60         # 铁矿石 5分钟 60 根
price kline SPX.INDEX -p w -n 52          # 标普500 周线

Each item: {date, open, high, low, close, volume}. date is ISO (minute periods keep full timestamp; daily+ keep yyyy-mm-dd).

Limits (2026-06):

• K-line comes from pre-generated gzip files on OSS, not the live WS feed. Intraday (minute) files update during the session → near-real-time (~last closed bar). Daily/weekly/monthly files are batch-snapshotted → the latest 1–2 bars may not be on OSS yet. For live price use price <code>.
• Not every symbol has K-line files. Verified: XAUUSD.GOODS (5min+daily), i9888.DCE (5min), SPX.INDEX (5min). Some (rb888.SHF, DXY.NYF) return no files. If 0 candles, the symbol likely isn't on OSS — try price <code> for a live quote instead.
• Intraday returns up to ~1000 candles (one file ≈ 3.5 days of 5min); daily/weekly/monthly paginate through all files (few).
• Symbols are case-sensitive (i9888.DCE, not I9888.DCE).

Auth (zero-config)

All commands work with no setup. Xueqiu (F10, finance, industry, board, longhu, flow, margin, search) auto-fetches an anonymous session (full /hq cookie set incl. acw_tc WAF cookie) on first use, cached at ~/.xueqiu-anon-cookie; no login needed. Jin10 (flash detail, flash date, topic show, calendar macro/event/holiday) tries a browser cookie and works without it (less data); flash date needs login. CLS signs every request (no login). Gelonghui needs no auth.

Interpretation tips & known limits

• meta.source = which platform served the data (freshness context). Fallback markers use the space form (xq fallback, yahoo fallback).
• market emotion shows limit-up/down counts, seal rates — key sentiment.
• quote flow market / market flow show northbound (沪港通/深港通) capital — key for A-share trend.
• Non-trading hours: emotion, timeline return empty; longhu empty before close (~17:30); sector anchor only has data for trading days.
• -n defaults vary: most 10; kline 120; industry/board 30; flow history uses -c.
• Xueqiu single-source commands (search/industry/board/f10/finance/flow history) have no cls/Yahoo fallback — if xueqiu's WAF blocks them they error. Only quote <code> and kline/depth/ticks/timeline have fallback chains.
• CLS flash with jin10 source auto-paginates up to 50 pages (slow for large -n).
• info flash -c <栏目> (non-all) is cls single-source with no cross-source fallback. The category is filtered server-side by cls, so results are accurate for watch/hk_us/fund/red/announcement. Use default (all) or -s jin10 for cross-source results.
• Time formats are mostly ISO, but timeline (时分), ticks (时分秒), and some calendar commands are exceptions — parse carefully.