API Documentation

Base URL https://quantsonar.com · All endpoints are GET · Auth header X-API-Key · Get a free API key →

# Recommended: official Python SDK (returns pandas DataFrames)
pip install quantsonar

import quantsonar as qs
qs.set_token("qs_your_key")  # or env QUANTSONAR_TOKEN
df = qs.daily(symbol="600519.SH", start_date="20260101")
qs.endpoints()  # list every endpoint

# Or plain curl — any language, three lines
curl "https://quantsonar.com/v1/market/daily?symbol=600519.SH&start_date=20260101" \
     -H "X-API-Key: qs_your_key"

Use with AI

Let Claude, Cursor or any MCP-capable client query A-share data directly. AI calls draw from your daily quota.

# Remote MCP server (zero install)
https://quantsonar.com/mcp
# Auth header
X-API-Key: qs_your_key

# Claude Code, one line
claude mcp add --transport http quantsonar https://quantsonar.com/mcp \
       --header "X-API-Key: qs_your_key"

Also available as a Claude Skill built on the Python SDK: quantsonar-skills.

Auth & rate limits

Every request needs the X-API-Key header. Three limit layers: daily quota by tier (FREE 100 / Starter 1,000 / PRO 3,000 / Expert 10,000 calls/day), per-minute burst (30 / 100 / 200 / 500), and a fair-use daily egress cap. Endpoints above your tier can be tried 2× free per day (real data, with an X-Trial-Remaining header); after that they return 403 with an upgrade hint. Responses carry X-RateLimit-Limit / X-RateLimit-Remaining; exceeding limits returns 429, quota resets next day.

Conventions

Convention	Detail
symbol	Security codes carry exchange suffixes: `000001.SZ`, `600519.SH`, `430047.BJ`. Bare codes return 422.
dates	Requests and responses use `YYYYMMDD` (e.g. `20260707`).
numbers	Prices and volumes are real JSON numbers, never strings.
row caps	No pagination; each call truncates at a fixed cap (6,000 rows normal, 20,000 financial) — enough for a market-wide single-day slice. Narrow with date ranges or filters.
errors	`401` missing/invalid key · `403` tier too low · `422` bad params · `429` rate limited. Core `detail` messages are bilingual (中文 / English).
versioning	Within v1, changes are backward-compatible only: new endpoints, new response columns, new optional parameters. Columns are never removed, renamed, or changed in meaning/units. Breaking changes ship as a parallel `/v2` with at least 6 months of v1 deprecation, announced in the changelog.

Market Data

GET /v1/market/daily FREE

Daily OHLC bars

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (11)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
open	Open price
high	High price
low	Low price
close	Close price
pre_close	Previous close
change	Price change
pct_chg	Change (%)
vol	Volume (lots)
amount	Turnover (k CNY)

GET /v1/market/fundamentals STARTER

Daily valuation metrics (PE/PB/turnover/market cap)

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (18)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
close	Close price
turnover_rate	Turnover rate (%)
turnover_rate_f	Turnover rate, free float (%)
volume_ratio	Volume ratio
pe	P/E ratio
pe_ttm	P/E ratio TTM
pb	P/B ratio
ps	P/S ratio
ps_ttm	P/S ratio TTM
dv_ratio	Dividend yield (%)
dv_ttm	Dividend yield TTM (%)
total_share	Total shares (10k)
float_share	Floating shares (10k)
free_share	Free-float shares (10k)
total_mv	Total market cap (10k CNY)
circ_mv	Float market cap (10k CNY)

GET /v1/market/adj-factor STARTER

Adjustment factors

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (3)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
adj_factor	Adjustment factor (adjusted price = close × factor)

GET /v1/market/technical-factors PRO

Technical indicators

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (26)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
open_hfq	Open price (backward-adjusted)
close_hfq	Close price (backward-adjusted)
high_hfq	High price (backward-adjusted)
low_hfq	Low price (backward-adjusted)
pre_close_hfq	Pre close hfq
open_qfq	Open price (forward-adjusted)
close_qfq	Close price (forward-adjusted)
high_qfq	High price (forward-adjusted)
low_qfq	Low price (forward-adjusted)
pre_close_qfq	Pre close qfq
adj_factor	Adjustment factor (adjusted price = close × factor)
macd_dif	Macd dif
macd_dea	Macd dea
macd	Macd
kdj_k	Kdj k
kdj_d	Kdj d
kdj_j	Kdj j
rsi_6	Rsi 6
rsi_12	Rsi 12
rsi_24	Rsi 24
boll_upper	Boll upper
boll_mid	Boll mid
boll_lower	Boll lower
cci	Cci

GET /v1/market/technical-factors-pro EXPERT

Technical indicators Pro (adjusted prices + full set)

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (261)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
open	Open price
open_hfq	Open price (backward-adjusted)
open_qfq	Open price (forward-adjusted)
high	High price
high_hfq	High price (backward-adjusted)
high_qfq	High price (forward-adjusted)
low	Low price
low_hfq	Low price (backward-adjusted)
low_qfq	Low price (forward-adjusted)
close	Close price
close_hfq	Close price (backward-adjusted)
close_qfq	Close price (forward-adjusted)
pre_close	Previous close
change	Price change
pct_chg	Change (%)
vol	Volume (lots)
amount	Turnover (k CNY)
turnover_rate	Turnover rate (%)
turnover_rate_f	Turnover rate, free float (%)
volume_ratio	Volume ratio
pe	P/E ratio
pe_ttm	P/E ratio TTM
pb	P/B ratio
ps	P/S ratio
ps_ttm	P/S ratio TTM
dv_ratio	Dividend yield (%)
dv_ttm	Dividend yield TTM (%)
total_share	Total shares (10k)
float_share	Floating shares (10k)
free_share	Free-float shares (10k)
total_mv	Total market cap (10k CNY)
circ_mv	Float market cap (10k CNY)
adj_factor	Adjustment factor (adjusted price = close × factor)
asi_bfq	Accumulation swing index ASI (unadjusted)
asi_hfq	Accumulation swing index ASI (backward-adjusted)
asi_qfq	Accumulation swing index ASI (forward-adjusted)
asit_bfq	ASI moving average (unadjusted)
asit_hfq	ASI moving average (backward-adjusted)
asit_qfq	ASI moving average (forward-adjusted)
atr_bfq	Average true range ATR (unadjusted)
atr_hfq	Average true range ATR (backward-adjusted)
atr_qfq	Average true range ATR (forward-adjusted)
bbi_bfq	Bull-bear index BBI (unadjusted)
bbi_hfq	Bull-bear index BBI (backward-adjusted)
bbi_qfq	Bull-bear index BBI (forward-adjusted)
bias1_bfq	Bias ratio (6-day) (unadjusted)
bias1_hfq	Bias ratio (6-day) (backward-adjusted)
bias1_qfq	Bias ratio (6-day) (forward-adjusted)
bias2_bfq	Bias ratio (12-day) (unadjusted)
bias2_hfq	Bias ratio (12-day) (backward-adjusted)
bias2_qfq	Bias ratio (12-day) (forward-adjusted)
bias3_bfq	Bias ratio (24-day) (unadjusted)
bias3_hfq	Bias ratio (24-day) (backward-adjusted)
bias3_qfq	Bias ratio (24-day) (forward-adjusted)
boll_lower_bfq	Bollinger lower band (unadjusted)
boll_lower_hfq	Bollinger lower band (backward-adjusted)
boll_lower_qfq	Bollinger lower band (forward-adjusted)
boll_mid_bfq	Bollinger middle band (unadjusted)
boll_mid_hfq	Bollinger middle band (backward-adjusted)
boll_mid_qfq	Bollinger middle band (forward-adjusted)
boll_upper_bfq	Bollinger upper band (unadjusted)
boll_upper_hfq	Bollinger upper band (backward-adjusted)
boll_upper_qfq	Bollinger upper band (forward-adjusted)
brar_ar_bfq	Sentiment indicator AR (unadjusted)
brar_ar_hfq	Sentiment indicator AR (backward-adjusted)
brar_ar_qfq	Sentiment indicator AR (forward-adjusted)
brar_br_bfq	Willingness indicator BR (unadjusted)
brar_br_hfq	Willingness indicator BR (backward-adjusted)
brar_br_qfq	Willingness indicator BR (forward-adjusted)
cci_bfq	Commodity channel index CCI (unadjusted)
cci_hfq	Commodity channel index CCI (backward-adjusted)
cci_qfq	Commodity channel index CCI (forward-adjusted)
cr_bfq	Price momentum CR (unadjusted)
cr_hfq	Price momentum CR (backward-adjusted)
cr_qfq	Price momentum CR (forward-adjusted)
dfma_dif_bfq	Parallel-line difference DMA DIF (unadjusted)
dfma_dif_hfq	Parallel-line difference DMA DIF (backward-adjusted)
dfma_dif_qfq	Parallel-line difference DMA DIF (forward-adjusted)
dfma_difma_bfq	DMA DIFMA (unadjusted)
dfma_difma_hfq	DMA DIFMA (backward-adjusted)
dfma_difma_qfq	DMA DIFMA (forward-adjusted)
dmi_adx_bfq	Average directional index ADX (unadjusted)
dmi_adx_hfq	Average directional index ADX (backward-adjusted)
dmi_adx_qfq	Average directional index ADX (forward-adjusted)
dmi_adxr_bfq	ADX rating ADXR (unadjusted)
dmi_adxr_hfq	ADX rating ADXR (backward-adjusted)
dmi_adxr_qfq	ADX rating ADXR (forward-adjusted)
dmi_mdi_bfq	Directional indicator -DI (unadjusted)
dmi_mdi_hfq	Directional indicator -DI (backward-adjusted)
dmi_mdi_qfq	Directional indicator -DI (forward-adjusted)
dmi_pdi_bfq	Directional indicator +DI (unadjusted)
dmi_pdi_hfq	Directional indicator +DI (backward-adjusted)
dmi_pdi_qfq	Directional indicator +DI (forward-adjusted)
downdays	Consecutive down days
updays	Consecutive up days
dpo_bfq	Detrended price oscillator DPO (unadjusted)
dpo_hfq	Detrended price oscillator DPO (backward-adjusted)
dpo_qfq	Detrended price oscillator DPO (forward-adjusted)
madpo_bfq	DPO moving average (unadjusted)
madpo_hfq	DPO moving average (backward-adjusted)
madpo_qfq	DPO moving average (forward-adjusted)
ema_bfq_10	Exponential moving average EMA (10-day) (unadjusted)
ema_bfq_20	Exponential moving average EMA (20-day) (unadjusted)
ema_bfq_250	Exponential moving average EMA (250-day) (unadjusted)
ema_bfq_30	Exponential moving average EMA (30-day) (unadjusted)
ema_bfq_5	Exponential moving average EMA (5-day) (unadjusted)
ema_bfq_60	Exponential moving average EMA (60-day) (unadjusted)
ema_bfq_90	Exponential moving average EMA (90-day) (unadjusted)
ema_hfq_10	Exponential moving average EMA (10-day) (backward-adjusted)
ema_hfq_20	Exponential moving average EMA (20-day) (backward-adjusted)
ema_hfq_250	Exponential moving average EMA (250-day) (backward-adjusted)
ema_hfq_30	Exponential moving average EMA (30-day) (backward-adjusted)
ema_hfq_5	Exponential moving average EMA (5-day) (backward-adjusted)
ema_hfq_60	Exponential moving average EMA (60-day) (backward-adjusted)
ema_hfq_90	Exponential moving average EMA (90-day) (backward-adjusted)
ema_qfq_10	Exponential moving average EMA (10-day) (forward-adjusted)
ema_qfq_20	Exponential moving average EMA (20-day) (forward-adjusted)
ema_qfq_250	Exponential moving average EMA (250-day) (forward-adjusted)
ema_qfq_30	Exponential moving average EMA (30-day) (forward-adjusted)
ema_qfq_5	Exponential moving average EMA (5-day) (forward-adjusted)
ema_qfq_60	Exponential moving average EMA (60-day) (forward-adjusted)
ema_qfq_90	Exponential moving average EMA (90-day) (forward-adjusted)
emv_bfq	Ease of movement EMV (unadjusted)
emv_hfq	Ease of movement EMV (backward-adjusted)
emv_qfq	Ease of movement EMV (forward-adjusted)
maemv_bfq	EMV moving average (unadjusted)
maemv_hfq	EMV moving average (backward-adjusted)
maemv_qfq	EMV moving average (forward-adjusted)
expma_12_bfq	Smoothed moving average EXPMA (12-day) (unadjusted)
expma_12_hfq	Smoothed moving average EXPMA (12-day) (backward-adjusted)
expma_12_qfq	Smoothed moving average EXPMA (12-day) (forward-adjusted)
expma_50_bfq	Smoothed moving average EXPMA (50-day) (unadjusted)
expma_50_hfq	Smoothed moving average EXPMA (50-day) (backward-adjusted)
expma_50_qfq	Smoothed moving average EXPMA (50-day) (forward-adjusted)
kdj_bfq	KDJ %J (unadjusted)
kdj_hfq	KDJ %J (backward-adjusted)
kdj_qfq	KDJ %J (forward-adjusted)
kdj_d_bfq	KDJ %D (unadjusted)
kdj_d_hfq	KDJ %D (backward-adjusted)
kdj_d_qfq	KDJ %D (forward-adjusted)
kdj_k_bfq	KDJ %K (unadjusted)
kdj_k_hfq	KDJ %K (backward-adjusted)
kdj_k_qfq	KDJ %K (forward-adjusted)
ktn_down_bfq	Keltner channel lower (unadjusted)
ktn_down_hfq	Keltner channel lower (backward-adjusted)
ktn_down_qfq	Keltner channel lower (forward-adjusted)
ktn_mid_bfq	Keltner channel middle (unadjusted)
ktn_mid_hfq	Keltner channel middle (backward-adjusted)
ktn_mid_qfq	Keltner channel middle (forward-adjusted)
ktn_upper_bfq	Keltner channel upper (unadjusted)
ktn_upper_hfq	Keltner channel upper (backward-adjusted)
ktn_upper_qfq	Keltner channel upper (forward-adjusted)
lowdays	New-low days (250-day window)
topdays	New-high days (250-day window)
ma_bfq_10	Simple moving average MA (10-day) (unadjusted)
ma_bfq_20	Simple moving average MA (20-day) (unadjusted)
ma_bfq_250	Simple moving average MA (250-day) (unadjusted)
ma_bfq_30	Simple moving average MA (30-day) (unadjusted)
ma_bfq_5	Simple moving average MA (5-day) (unadjusted)
ma_bfq_60	Simple moving average MA (60-day) (unadjusted)
ma_bfq_90	Simple moving average MA (90-day) (unadjusted)
ma_hfq_10	Simple moving average MA (10-day) (backward-adjusted)
ma_hfq_20	Simple moving average MA (20-day) (backward-adjusted)
ma_hfq_250	Simple moving average MA (250-day) (backward-adjusted)
ma_hfq_30	Simple moving average MA (30-day) (backward-adjusted)
ma_hfq_5	Simple moving average MA (5-day) (backward-adjusted)
ma_hfq_60	Simple moving average MA (60-day) (backward-adjusted)
ma_hfq_90	Simple moving average MA (90-day) (backward-adjusted)
ma_qfq_10	Simple moving average MA (10-day) (forward-adjusted)
ma_qfq_20	Simple moving average MA (20-day) (forward-adjusted)
ma_qfq_250	Simple moving average MA (250-day) (forward-adjusted)
ma_qfq_30	Simple moving average MA (30-day) (forward-adjusted)
ma_qfq_5	Simple moving average MA (5-day) (forward-adjusted)
ma_qfq_60	Simple moving average MA (60-day) (forward-adjusted)
ma_qfq_90	Simple moving average MA (90-day) (forward-adjusted)
macd_bfq	MACD histogram (unadjusted)
macd_hfq	MACD histogram (backward-adjusted)
macd_qfq	MACD histogram (forward-adjusted)
macd_dea_bfq	MACD DEA line (unadjusted)
macd_dea_hfq	MACD DEA line (backward-adjusted)
macd_dea_qfq	MACD DEA line (forward-adjusted)
macd_dif_bfq	MACD DIF line (unadjusted)
macd_dif_hfq	MACD DIF line (backward-adjusted)
macd_dif_qfq	MACD DIF line (forward-adjusted)
mass_bfq	Mass index (unadjusted)
mass_hfq	Mass index (backward-adjusted)
mass_qfq	Mass index (forward-adjusted)
ma_mass_bfq	Mass index moving average (unadjusted)
ma_mass_hfq	Mass index moving average (backward-adjusted)
ma_mass_qfq	Mass index moving average (forward-adjusted)
mfi_bfq	Money flow index MFI (unadjusted)
mfi_hfq	Money flow index MFI (backward-adjusted)
mfi_qfq	Money flow index MFI (forward-adjusted)
mtm_bfq	Momentum MTM (unadjusted)
mtm_hfq	Momentum MTM (backward-adjusted)
mtm_qfq	Momentum MTM (forward-adjusted)
mtmma_bfq	MTM moving average (unadjusted)
mtmma_hfq	MTM moving average (backward-adjusted)
mtmma_qfq	MTM moving average (forward-adjusted)
obv_bfq	On-balance volume OBV (unadjusted)
obv_hfq	On-balance volume OBV (backward-adjusted)
obv_qfq	On-balance volume OBV (forward-adjusted)
psy_bfq	Psychological line PSY (unadjusted)
psy_hfq	Psychological line PSY (backward-adjusted)
psy_qfq	Psychological line PSY (forward-adjusted)
psyma_bfq	PSY moving average (unadjusted)
psyma_hfq	PSY moving average (backward-adjusted)
psyma_qfq	PSY moving average (forward-adjusted)
roc_bfq	Rate of change ROC (unadjusted)
roc_hfq	Rate of change ROC (backward-adjusted)
roc_qfq	Rate of change ROC (forward-adjusted)
maroc_bfq	ROC moving average (unadjusted)
maroc_hfq	ROC moving average (backward-adjusted)
maroc_qfq	ROC moving average (forward-adjusted)
rsi_bfq_12	Relative strength index RSI (12-day) (unadjusted)
rsi_bfq_24	Relative strength index RSI (24-day) (unadjusted)
rsi_bfq_6	Relative strength index RSI (6-day) (unadjusted)
rsi_hfq_12	Relative strength index RSI (12-day) (backward-adjusted)
rsi_hfq_24	Relative strength index RSI (24-day) (backward-adjusted)
rsi_hfq_6	Relative strength index RSI (6-day) (backward-adjusted)
rsi_qfq_12	Relative strength index RSI (12-day) (forward-adjusted)
rsi_qfq_24	Relative strength index RSI (24-day) (forward-adjusted)
rsi_qfq_6	Relative strength index RSI (6-day) (forward-adjusted)
taq_down_bfq	Donchian channel lower (unadjusted)
taq_down_hfq	Donchian channel lower (backward-adjusted)
taq_down_qfq	Donchian channel lower (forward-adjusted)
taq_mid_bfq	Donchian channel middle (unadjusted)
taq_mid_hfq	Donchian channel middle (backward-adjusted)
taq_mid_qfq	Donchian channel middle (forward-adjusted)
taq_up_bfq	Donchian channel upper (unadjusted)
taq_up_hfq	Donchian channel upper (backward-adjusted)
taq_up_qfq	Donchian channel upper (forward-adjusted)
trix_bfq	Triple EMA oscillator TRIX (unadjusted)
trix_hfq	Triple EMA oscillator TRIX (backward-adjusted)
trix_qfq	Triple EMA oscillator TRIX (forward-adjusted)
trma_bfq	TRIX moving average (unadjusted)
trma_hfq	TRIX moving average (backward-adjusted)
trma_qfq	TRIX moving average (forward-adjusted)
vr_bfq	Volume ratio VR (unadjusted)
vr_hfq	Volume ratio VR (backward-adjusted)
vr_qfq	Volume ratio VR (forward-adjusted)
wr_bfq	Williams %R (10-day) (unadjusted)
wr_hfq	Williams %R (10-day) (backward-adjusted)
wr_qfq	Williams %R (10-day) (forward-adjusted)
wr1_bfq	Williams %R (6-day) (unadjusted)
wr1_hfq	Williams %R (6-day) (backward-adjusted)
wr1_qfq	Williams %R (6-day) (forward-adjusted)
xsii_td1_bfq	XSII channel TD1 (unadjusted)
xsii_td1_hfq	XSII channel TD1 (backward-adjusted)
xsii_td1_qfq	XSII channel TD1 (forward-adjusted)
xsii_td2_bfq	XSII channel TD2 (unadjusted)
xsii_td2_hfq	XSII channel TD2 (backward-adjusted)
xsii_td2_qfq	XSII channel TD2 (forward-adjusted)
xsii_td3_bfq	XSII channel TD3 (unadjusted)
xsii_td3_hfq	XSII channel TD3 (backward-adjusted)
xsii_td3_qfq	XSII channel TD3 (forward-adjusted)
xsii_td4_bfq	XSII channel TD4 (unadjusted)
xsii_td4_hfq	XSII channel TD4 (backward-adjusted)
xsii_td4_qfq	XSII channel TD4 (forward-adjusted)

GET /v1/market/margin PRO

Margin trading detail

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (11)

Field	Description
trade_date	Trading date YYYYMMDD
symbol	Security code (with exchange suffix)
name	Security short name
rzye	Rzye
rqye	Rqye
rzmre	Rzmre
rqyl	Rqyl
rzche	Rzche
rqchl	Rqchl
rqmcl	Rqmcl
rzrqye	Rzrqye

GET /v1/market/block-trade PRO

Block trades

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (7)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
price	Latest price
vol	Volume (lots)
amount	Turnover (k CNY)
buyer	Buyer
seller	Seller

GET /v1/market/top-list PRO

Dragon-Tiger list (stocks)

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (10)

Field	Description
trade_date	Trading date YYYYMMDD
symbol	Security code (with exchange suffix)
name	Security short name
close	Close price
pct_change	Pct change
turnover_rate	Turnover rate (%)
amount	Turnover (k CNY)
l_sell	L sell
l_buy	L buy
l_amount	L amount

GET /v1/market/top-inst PRO

Dragon-Tiger list (institutional seats)

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (10)

Field	Description
trade_date	Trading date YYYYMMDD
symbol	Security code (with exchange suffix)
exalter	Exalter
buy	Buy
buy_rate	Buy rate
sell	Sell
sell_rate	Sell rate
net_buy	Net buy
side	Side
reason	Reason

GET /v1/market/shareholders PRO

Shareholder count

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
enddate	Cut-off date YYYYMMDD
ann_date	Announcement date YYYYMMDD

Response fields (4)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
holder_num	Number of shareholders

GET /v1/market/holder-trade PRO

Major shareholder trades

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_type	Direction: IN increase / DE decrease
holder_type	Holder type: G executive / P individual / C company

Response fields (13)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
holder_name	Holder name
holder_type	Holder type
in_de	In de
change_vol	Change vol
change_ratio	Change ratio
after_share	After share
after_ratio	After ratio
avg_price	Avg price
total_share	Total shares (10k)
begin_date	Begin date
close_date	Close date

GET /v1/market/limit-list PRO

Limit-up/down list

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
limit_type	Limit type: U limit-up / D limit-down / Z failed board
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (18)

Field	Description
trade_date	Trading date YYYYMMDD
symbol	Security code (with exchange suffix)
industry	Industry
name	Security short name
close	Close price
pct_chg	Change (%)
amount	Turnover (k CNY)
limit_amount	Limit amount
float_mv	Float mv
total_mv	Total market cap (10k CNY)
turnover_ratio	Turnover ratio
fd_amount	Fd amount
first_time	First time
last_time	Last time
open_times	Open times
up_stat	Up stat
limit_times	Limit times
limit	Limit

GET /v1/market/concepts PRO

Concept sector indices

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)
name	Exact name match
idx_type	Sector type

Response fields (13)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
name	Security short name
leading	Leading
leading_code	Leading code
pct_change	Pct change
leading_pct	Leading pct
total_mv	Total market cap (10k CNY)
turnover_rate	Turnover rate (%)
up_num	Up num
down_num	Down num
idx_type	Idx type
level	Level

GET /v1/market/concept-members PRO

Concept sector constituents

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
con_symbol	Constituent code with suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (4)

Field	Description
trade_date	Trading date YYYYMMDD
symbol	Security code (with exchange suffix)
con_symbol	Constituent code (with suffix)
name	Security short name

Money Flow

GET /v1/flows/moneyflow PRO

Stock money flow

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (20)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
buy_sm_vol	Buy volume (lots), small orders
buy_sm_amount	Buy amount (10k CNY), small orders
sell_sm_vol	Sell volume (lots), small orders
sell_sm_amount	Sell amount (10k CNY), small orders
buy_md_vol	Buy volume (lots), medium orders
buy_md_amount	Buy amount (10k CNY), medium orders
sell_md_vol	Sell volume (lots), medium orders
sell_md_amount	Sell amount (10k CNY), medium orders
buy_lg_vol	Buy volume (lots), large orders
buy_lg_amount	Buy amount (10k CNY), large orders
sell_lg_vol	Sell volume (lots), large orders
sell_lg_amount	Sell amount (10k CNY), large orders
buy_elg_vol	Buy volume (lots), extra-large orders
buy_elg_amount	Buy amount (10k CNY), extra-large orders
sell_elg_vol	Sell volume (lots), extra-large orders
sell_elg_amount	Sell amount (10k CNY), extra-large orders
net_mf_vol	Net inflow volume (lots)
net_mf_amount	Net inflow amount (10k CNY)

GET /v1/flows/moneyflow-hsgt PRO

Stock Connect money flow (market-wide)

Parameter	Description
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (7)

Field	Description
trade_date	Trading date YYYYMMDD
ggt_ss	Ggt ss
ggt_sz	Ggt sz
hgt_ss	Hgt ss
hgt_sz	Hgt sz
north_money	North money
south_money	South money

GET /v1/flows/northbound-holdings PRO

Northbound holdings detail

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (6)

Field	Description
trade_date	Trading date YYYYMMDD
symbol	Security code (with exchange suffix)
name	Security short name
vol	Volume (lots)
ratio	Ratio
exchange	Exchange (SSE/SZSE)

GET /v1/flows/southbound-holdings PRO

Southbound holdings detail

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (6)

Field	Description
trade_date	Trading date YYYYMMDD
symbol	Security code (with exchange suffix)
name	Security short name
vol	Volume (lots)
ratio	Ratio
exchange	Exchange (SSE/SZSE)

Chip Distribution

GET /v1/chips/distribution EXPERT

Chip distribution & win rate

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (11)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
his_low	His low
his_high	His high
cost_5pct	Cost 5pct
cost_15pct	Cost 15pct
cost_50pct	Cost 50pct
cost_85pct	Cost 85pct
cost_95pct	Cost 95pct
weight_avg	Weight avg
winner_rate	Winner rate

Indices

GET /v1/indices/daily FREE

Index daily bars (default SSE Composite)

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (11)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
close	Close price
open	Open price
high	High price
low	Low price
pre_close	Previous close
change	Price change
pct_chg	Change (%)
vol	Volume (lots)
amount	Turnover (k CNY)

GET /v1/indices/index-weight STARTER

Index constituents & weights

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (5)

Field	Description
symbol	Index code (with suffix)
trade_date	Trading date YYYYMMDD
con_symbol	Constituent code (with suffix)
con_name	Con name
weight	Weight in index (%)

Financials

GET /v1/financials/indicators STARTER

Financial indicators

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
period	Report period YYYYMMDD (e.g. 20251231 = FY2025)
ann_date	Announcement date YYYYMMDD

Response fields (29)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
eps	Basic EPS (CNY)
dt_eps	Diluted EPS (CNY)
total_revenue_ps	Total revenue per share (CNY)
revenue_ps	Revenue per share (CNY)
bps	Book value per share (CNY)
ocfps	Operating cash flow per share (CNY)
roe	Return on equity (%)
roe_waa	Weighted average ROE (%)
roe_dt	ROE excl. non-recurring items (%)
roa	Return on assets (%)
gross_margin	Gross profit (10k CNY)
netprofit_margin	Net profit margin (%)
grossprofit_margin	Gross profit margin (%)
debt_to_assets	Debt-to-assets ratio (%)
current_ratio	Current ratio
quick_ratio	Quick ratio
cash_ratio	Cash ratio
assets_turn	Asset turnover
inv_turn	Inventory turnover
ar_turn	Receivables turnover
roic	Return on invested capital (%)
basic_eps_yoy	Basic EPS YoY growth (%)
dt_eps_yoy	Diluted EPS YoY growth (%)
netprofit_yoy	Net profit YoY growth (%)
dt_netprofit_yoy	Net profit YoY excl. non-recurring (%)
rd_exp	R&D expense (10k CNY)

GET /v1/financials/income STARTER

Income statements

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
period	Report period YYYYMMDD (e.g. 20251231 = FY2025)
ann_date	Announcement date YYYYMMDD
f_ann_date	Actual announcement date YYYYMMDD
report_type	Report type: 1 consolidated / 6 parent company …
comp_type	Company type: 1 general / 2 bank / 3 insurance / 4 securities

Response fields (26)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
f_ann_date	Actual announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
report_type	Report type
comp_type	Comp type
basic_eps	Basic eps
diluted_eps	Diluted eps
total_revenue	Total revenue
revenue	Revenue
total_cogs	Total cogs
oper_cost	Oper cost
sell_exp	Sell exp
admin_exp	Admin exp
fin_exp	Fin exp
rd_exp	R&D expense (10k CNY)
operate_profit	Operate profit
non_oper_income	Non oper income
non_oper_exp	Non oper exp
total_profit	Total profit
income_tax	Income tax
n_income	N income
n_income_attr_p	N income attr p
ebit	Ebit
ebitda	Ebitda
update_flag	Update flag

GET /v1/financials/balance-sheet STARTER

Balance sheets

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
period	Report period YYYYMMDD (e.g. 20251231 = FY2025)
ann_date	Announcement date YYYYMMDD
report_type	Report type: 1 consolidated / 6 parent company …
comp_type	Company type: 1 general / 2 bank / 3 insurance / 4 securities

Response fields (31)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
f_ann_date	Actual announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
report_type	Report type
comp_type	Comp type
total_cur_assets	Total cur assets
money_cap	Money cap
notes_receiv	Notes receiv
accounts_receiv	Accounts receiv
inventories	Inventories
total_nca	Total nca
fa_avail_for_sale	Fa avail for sale
lt_eqt_invest	Lt eqt invest
fix_assets	Fix assets
cip	Cip
intan_assets	Intan assets
goodwill	Goodwill
total_assets	Total assets
total_cur_liab	Total cur liab
st_borr	St borr
notes_payable	Notes payable
acct_payable	Acct payable
total_ncl	Total ncl
lt_borr	Lt borr
bond_payable	Bond payable
total_liab	Total liab
total_hldr_eqy_exc_min_int	Total hldr eqy exc min int
total_hldr_eqy_inc_min_int	Total hldr eqy inc min int
minority_int	Minority int
update_flag	Update flag

GET /v1/financials/cash-flow STARTER

Cash flow statements

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
period	Report period YYYYMMDD (e.g. 20251231 = FY2025)
ann_date	Announcement date YYYYMMDD
f_ann_date	Actual announcement date YYYYMMDD
report_type	Report type: 1 consolidated / 6 parent company …
comp_type	Company type: 1 general / 2 bank / 3 insurance / 4 securities

Response fields (21)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
f_ann_date	Actual announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
report_type	Report type
comp_type	Comp type
net_profit	Net profit
c_fr_sale_sg	C fr sale sg
c_pay_goods_purch_serv_rec	C pay goods purch serv rec
n_cashflow_act	N cashflow act
c_pay_acq_const_fix_intang_oasset	C pay acq const fix intang oasset
c_fr_disp_fix_intang_oasset	C fr disp fix intang oasset
n_cashflow_inv_act	N cashflow inv act
c_fr_borr	C fr borr
c_pay_dist_dpcp_int_exp	C pay dist dpcp int exp
n_cash_flows_fnc_act	N cash flows fnc act
n_incr_cash_cash_equ	N incr cash cash equ
c_cash_equ_beg_period	C cash equ beg period
c_cash_equ_end_period	C cash equ end period
free_cashflow	Free cashflow
update_flag	Update flag

GET /v1/financials/forecast STARTER

Earnings forecasts

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
period	Report period YYYYMMDD (e.g. 20251231 = FY2025)
type	Forecast type (increase/decrease/turn-loss etc.)

Response fields (12)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
type	Type
p_change_min	P change min
p_change_max	P change max
net_profit_min	Net profit min
net_profit_max	Net profit max
last_parent_net	Last parent net
first_ann_date	First ann date
summary	Summary
change_reason	Change reason

GET /v1/financials/express STARTER

Earnings flash reports

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
period	Report period YYYYMMDD (e.g. 20251231 = FY2025)

Response fields (15)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
revenue	Revenue
operate_profit	Operate profit
total_profit	Total profit
n_income	N income
total_assets	Total assets
total_hldr_eqy_exc_min_int	Total hldr eqy exc min int
diluted_eps	Diluted eps
diluted_roe	Diluted roe
yoy_net_profit	Yoy net profit
bps	Book value per share (CNY)
perf_summary	Perf summary
update_flag	Update flag

GET /v1/financials/analyst-reports PRO

Analyst earnings estimates

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD

Response fields (23)

Field	Description
symbol	Security code (with exchange suffix)
name	Security short name
report_date	Report date YYYYMMDD
report_title	Report title
report_type	Report type
classify	Classify
org_name	Org name
author_name	Author name
quarter	Quarter
op_rt	Op rt
op_pr	Op pr
tp	Tp
np	Np
eps	Basic EPS (CNY)
pe	P/E ratio
rd	Rd
roe	Return on equity (%)
ev_ebitda	Ev ebitda
rating	Rating
max_price	Max price
min_price	Min price
imp_dg	Imp dg
create_time	Create time

GET /v1/financials/audit PRO

Audit opinions

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
period	Report period YYYYMMDD (e.g. 20251231 = FY2025)
ann_date	Announcement date YYYYMMDD

Response fields (7)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
audit_result	Audit result
audit_fees	Audit fees
audit_agency	Audit agency
audit_sign	Audit sign

GET /v1/financials/main-business PRO

Main business composition

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
period	Report period YYYYMMDD (e.g. 20251231 = FY2025)

Response fields (7)

Field	Description
symbol	Security code (with exchange suffix)
end_date	Report period end date YYYYMMDD
bz_item	Bz item
bz_sales	Bz sales
bz_profit	Bz profit
bz_cost	Bz cost
curr_type	Curr type

GET /v1/financials/disclosure-date PRO

Disclosure calendar

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
pre_date	Scheduled disclosure date YYYYMMDD
actual_date	Actual disclosure date YYYYMMDD

Response fields (6)

Field	Description
symbol	Security code (with exchange suffix)
ann_date	Announcement date YYYYMMDD
end_date	Report period end date YYYYMMDD
pre_date	Pre date
actual_date	Actual date
modify_date	Modify date

Dividends

GET /v1/shareholders/dividend STARTER

Dividends & splits

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
record_date	Record date YYYYMMDD
ex_date	Ex-dividend date YYYYMMDD
imp_ann_date	Implementation announcement date YYYYMMDD

Response fields (14)

Field	Description
symbol	Security code (with exchange suffix)
end_date	Report period end date YYYYMMDD
ann_date	Announcement date YYYYMMDD
div_proc	Div proc
stk_div	Stk div
stk_bo_rate	Stk bo rate
stk_co_rate	Stk co rate
cash_div	Cash div
cash_div_tax	Cash div tax
record_date	Record date
ex_date	Ex date
pay_date	Pay date
div_listdate	Div listdate
imp_ann_date	Imp ann date

FX

GET /v1/fx/daily FREE

FX daily bars (default USDCNH)

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
trade_date	Single trading date YYYYMMDD (alternative to start/end)

Response fields (11)

Field	Description
symbol	Security code (with exchange suffix)
trade_date	Trading date YYYYMMDD
bid_open	Bid open
bid_close	Bid close
bid_high	Bid high
bid_low	Bid low
ask_open	Ask open
ask_close	Ask close
ask_high	Ask high
ask_low	Ask low
tick_qty	Tick qty

Reference

GET /v1/reference/stocks FREE

Stock list

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ
name	Exact name match
market	Market segment (main/GEM/STAR/BSE)
list_status	Listing status: L listed / D delisted / P suspended
exchange	Exchange: SSE / SZSE
is_hs	Stock Connect eligible: N no / H SH-Connect / S SZ-Connect

Response fields (15)

Field	Description
symbol	Security code (with exchange suffix)
symbol	Symbol
name	Security short name
area	Region
industry	Industry
fullname	Fullname
enname	Enname
cnspell	Cnspell
market	Market segment
exchange	Exchange (SSE/SZSE)
curr_type	Curr type
list_status	Listing status (L/D/P)
list_date	Listing date YYYYMMDD
delist_date	Delist date
is_hs	Stock Connect eligible (N/H/S)

GET /v1/reference/industries FREE

SW industry classification

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ

Response fields (8)

Field	Description
symbol	Security code (with exchange suffix)
name	Security short name
l1_code	L1 code
l1_name	L1 name
l2_code	L2 code
l2_name	L2 name
l3_code	L3 code
l3_name	L3 name

GET /v1/reference/trade-calendar FREE

Trading calendar (default SSE)

Parameter	Description
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
exchange	Exchange: SSE / SZSE
is_open	Trading day: 1 yes / 0 no

Response fields (4)

Field	Description
exchange	Exchange (SSE/SZSE)
cal_date	Calendar date YYYYMMDD
is_open	Trading day flag (1 yes / 0 no)
pretrade_date	Pretrade date

Realtime & News

GET /v1/market/realtime STARTER

Realtime quotes snapshot

Parameter	Description
symbol	Security code with exchange suffix, e.g. 000001.SZ

Response fields (11)

Field	Description
symbol	Symbol
name	Security short name
price	Latest price
open	Open price
high	High price
low	Low price
pre_close	Previous close
volume	Cumulative volume (shares)
amount	Turnover (k CNY)
trade_time	Quote timestamp
pct_chg	Change (%)

GET /v1/news/flash STARTER

News flash (realtime)

Parameter	Description
source *	News source: cls / jin10 / sina
start_date	Start date YYYYMMDD
end_date	End date YYYYMMDD
importance	Only items with importance ≥ this value (1 = important only)

Response fields (6)

Field	Description
source	News source: cls / jin10 / sina
publish_time	Publish time
content_cn	News content (Chinese)
tags	Tags
importance	Importance level
url	Original link