Skip to content

数据 - DataTypes 介绍

DataTypes 是一个枚举类,每个成员代表一种可以从 JiuHuang API 获取的数据类型。当前有数据维护的全部类型见下文 完整列表,以列表项为准。

数据源

前缀数据源字段命名code 列date 列
ts_tushare 数据源英文标准化ts_codetrade_date
ak_akshare 数据源(东方财富等)英文标准化symboldate
jh_jiuhuang 本地计算(tushare 衍生)英文标准化symboldate

数据统一以英文标准化字段输出,例如 openhighlowclosevolume 等。

枚举名 vs 枚举值

from jh_quant.data import DataTypes
# 枚举名(Python中使用)
DataTypes.TS_DAILY
# 枚举值(API调用中的字符串标识)
DataTypes.TS_DAILY.value # "ts_daily"

Akshare数据

akshare(ak_ 前缀)数据数量较少,统一列在一个列表里,不再按业务分类:

DataType说明
AK_STOCK_ZH_A_SPOTA 股实时行情
AK_STOCK_ZH_A_HISTA 股日线(不复权)
AK_STOCK_ZH_A_HIST_QFQA 股日线(前复权)
AK_STOCK_ZH_A_HIST_HFQA 股日线(后复权)
AK_STOCK_LRB_EM利润表
AK_STOCK_ZCFZ_EM资产负债表
AK_STOCK_XJLL_EM现金流量表
AK_STOCK_INFO_A_CODE_NAME股票代码与名称(仅沪深 A 股)
AK_TOOL_TRADE_DATE_HIST_SINA交易日历(仅交易日)
AK_STOCK_ZH_A_ST_EM风险警示股票(ST/*ST 等)
AK_MACRO_CHINA_MARKET_MARGIN_SH融资融券汇总(上交所)
AK_MACRO_CHINA_MARKET_MARGIN_SZ融资融券汇总(深交所)
AK_STOCK_ZH_INDEX_DAILY_EM指数日线行情(覆盖上证指数等主要指数)
AK_MACRO_CHINA_SHIBOR_ALLShibor 利率
AK_MACRO_CHINA_GDPGDP
AK_MACRO_CHINA_MONEY_SUPPLY货币供应量

复权口径说明AK_STOCK_ZH_A_HIST_QFQ / AK_STOCK_ZH_A_HIST_HFQ 的复权价格基于标准复权因子计算,与 akshare 客户端(东方财富)展示的复权价格在存在除权除息的历史区间存在细微差异(复权基准不同所致)。其中 pct_chgchg 等涨跌幅字段为不复权口径,与 akshare 一致。

使用示例:

from jh_quant.data import JHData, DataTypes
jh = JHData()
# 获取 A 股实时行情(建议 bypass_cache=True)
spot = jh.get_data(DataTypes.AK_STOCK_ZH_A_SPOT, bypass_cache=True)
# 获取 A 股日线(不复权)
df = jh.get_data(
DataTypes.AK_STOCK_ZH_A_HIST,
symbol="600519",
start="2024-01-01",
end="2024-12-31",
)

Tushare数据

以下均为 tushare(ts_ 前缀)数据,按业务分类列出。

行情数据

日线 / 周线 / 月线

DataType说明
TS_DAILYA 股日线(不复权)
TS_DAILY_QFQA 股日线(前复权)
TS_DAILY_HFQA 股日线(后复权)
TS_WEEKLYA 股周线(不复权)
TS_WEEKLY_QFQA 股周线(前复权)
TS_WEEKLY_HFQA 股周线(后复权)
TS_MONTHLYA 股月线(不复权)
TS_MONTHLY_QFQA 股月线(前复权)
TS_MONTHLY_HFQA 股月线(后复权)

使用示例:

from jh_quant.data import JHData, DataTypes
jh = JHData()
# 获取 A 股前复权日线
df = jh.get_data(
DataTypes.TS_DAILY_QFQ,
ts_code="000001.SZ,600519.SH",
start="2024-01-01",
end="2024-12-31",
)
# 获取 A 股月线
df = jh.get_data(
DataTypes.TS_MONTHLY,
ts_code="000001.SZ",
start="2020-01-01",
end="2024-12-31",
)

日线基础指标

DataType说明
TS_DAILY_BASIC日线基础指标(换手率、市盈率、市净率等)
TS_MONTHLY_BASIC月度基础指标(ts_daily_basic 的衍生表:每只股票每月取当月最后一个交易日的记录)

TS_MONTHLY_BASIC 字段与 TS_DAILY_BASIC 完全一致,仅按月份聚合。其 trade_date 为当月最后一个实际交易日(与月线行情 TS_MONTHLY_* 同约定,不是自然月末日期),只包含已结束的完整月份。适合月频因子计算等场景,数据量约为日线的 1/20。

时点数据(point-in-time)说明ts_daily_basic / ts_monthly_basic 的字段(total_sharefloat_sharefree_sharetotal_mvcirc_mvpepb 等)记录的是该交易日当日的实际值,tushare 不会因后续增发、送转、回购或财报披露而回溯重算历史值。因此 TS_MONTHLY_BASIC 采用 append-only 增量派生:每个已结束的月份只写入一次,历史值一经生成即保持不变、不会回刷。对因子选股/回测场景,这恰好是期望的语义(避免引入前视偏差)。

# 获取 2020 年 000001.SZ 与 600000.SH 的月度基础指标
df = jh.get_data(
DataTypes.TS_MONTHLY_BASIC,
ts_code="000001.SZ,600000.SH",
start="2020-01-01",
end="2020-12-31",
)

基本面数据

财务报表

DataType说明
TS_BALANCESHEET资产负债表
TS_INCOME利润表
TS_CASHFLOW现金流量表
TS_FINA_INDICATOR财务指标(ROE、ROA、毛利率等)
TS_FINA_AUDIT财务审计意见
# 获取资产负债表
df = jh.get_data(
DataTypes.TS_BALANCESHEET,
ts_code="000001.SZ",
start="2023-01-01",
end="2024-12-31",
)

股票基础信息

DataType说明
TS_STOCK_BASIC股票基本信息(公司名称、行业、上市日期等)
TS_TRADE_CAL交易日历
TS_ADJ_FACTOR复权因子
# 获取股票基本信息
df = jh.get_data(DataTypes.TS_STOCK_BASIC)
# 获取交易日历
cal = jh.get_data(DataTypes.TS_TRADE_CAL, start="2024-01-01", end="2024-12-31")

新股与风险警示

DataType说明
TS_NEW_SHARE新股列表(IPO 信息)
TS_STOCK_ST风险警示股票(ST/*ST 等)
TS_SUSPEND_D停牌信息
# 获取新股列表
df = jh.get_data(DataTypes.TS_NEW_SHARE)
# 获取风险警示股票
df = jh.get_data(
DataTypes.TS_STOCK_ST,
start="2024-01-01",
end="2024-12-31",
)
# 获取停牌信息
df = jh.get_data(
DataTypes.TS_SUSPEND_D,
start="2024-01-01",
end="2024-12-31",
)

筹码与持仓数据

DataType说明
TS_CYQ_CHIPS筹码分布
TS_CYQ_PERF筹码穿透率
TS_STK_HOLDERTRADE股东增减持
TS_TOP10_HOLDERS十大股东
# 获取筹码分布
df = jh.get_data(DataTypes.TS_CYQ_CHIPS, ts_code="000001.SZ")

资金流向

DataType说明
TS_MONEYFLOW个股资金流向(大单/小单成交,2010年起)
TS_MONEYFLOW_THS同花顺个股资金流向
TS_MONEYFLOW_CNT_THS同花顺板块资金流向
TS_MONEYFLOW_IND_THS同花顺行业资金流向
TS_MONEYFLOW_MKT_DC东方财富大盘资金流向
# 获取个股资金流向
df = jh.get_data(
DataTypes.TS_MONEYFLOW,
ts_code="000001.SZ",
start="2024-01-01",
end="2024-12-31",
)
# 获取同花顺个股资金流向
df = jh.get_data(
DataTypes.TS_MONEYFLOW_THS,
ts_code="000001.SZ",
start="2024-01-01",
end="2024-12-31",
)

融资融券

DataType说明
TS_MARGIN融资融券汇总(按交易所)
TS_MARGIN_DETAIL融资融券明细(按个股)
# 获取融资融券明细
df = jh.get_data(
DataTypes.TS_MARGIN_DETAIL,
ts_code="000001.SZ",
start="2024-01-01",
end="2024-06-30",
)

业绩预告与快报

DataType说明
TS_EXPRESS业绩快报
TS_FORECAST业绩预告
# 获取业绩预告
df = jh.get_data(
DataTypes.TS_FORECAST,
ts_code="000001.SZ",
start="2024-01-01",
end="2024-12-31",
)

分红与股本变化

DataType说明
TS_DIVIDEND分红送股
# 获取分红送股数据
df = jh.get_data(DataTypes.TS_DIVIDEND, ts_code="000001.SZ")

龙虎榜

DataType说明
TS_TOP_LIST龙虎榜每日交易明细
TS_TOP_INST龙虎榜机构成交明细
# 获取龙虎榜交易明细
df = jh.get_data(
DataTypes.TS_TOP_LIST,
ts_code="000001.SZ",
start="2024-01-01",
end="2024-12-31",
)

技术面因子

DataType说明
TS_STK_FACTOR_PRO技术面专业版数据(MACD、KDJ、RSI 等全历史因子)
# 获取技术面因子
df = jh.get_data(
DataTypes.TS_STK_FACTOR_PRO,
ts_code="000001.SZ",
start="2024-01-01",
end="2024-12-31",
)

跨市场比价

DataType说明
TS_STK_AH_COMPARISONAH 股比价
# 获取 AH 股比价数据
df = jh.get_data(
DataTypes.TS_STK_AH_COMPARISON,
ts_code="000001.SZ",
start="2024-01-01",
end="2024-12-31",
)

同花顺概念板块

DataType说明
TS_THS_INDEX同花顺概念板块指数(板块基础信息)
TS_THS_MEMBER同花顺概念板块成分股
TS_THS_DAILY同花顺概念板块日线行情
# 获取同花顺概念板块指数
df = jh.get_data(DataTypes.TS_THS_INDEX)
# 获取概念板块成分股
df = jh.get_data(DataTypes.TS_THS_MEMBER, ts_code="885000.TI")
# 获取概念板块日线行情
df = jh.get_data(
DataTypes.TS_THS_DAILY,
ts_code="885000.TI",
start="2024-01-01",
end="2024-12-31",
)

指数数据

指数基本信息

DataType说明
TS_INDEX_BASIC指数基本信息(名称、市场、发布商、分类、基日、基点、上市日期)
# 获取指数基本信息
df = jh.get_data(DataTypes.TS_INDEX_BASIC)

指数日线行情

DataType说明
TS_INDEX_DAILYA 股指数日线行情(仅覆盖下方 9 个主要指数)
TS_INDEX_GLOBAL国际主要指数日线行情(标普500、道琼斯等)
TS_SW_DAILY申万行业指数日线行情(默认申万2021版)

TS_INDEX_DAILY 目前仅覆盖以下指数:

代码名称
000001.SH上证指数
399001.SZ深证成指
399006.SZ创业板指
000300.SH沪深300
000905.SH中证500
000852.SH中证1000
000016.SH上证50
000688.SH科创50
000903.SH中证100
# 获取 A 股指数日线行情(指定指数)
df = jh.get_data(
DataTypes.TS_INDEX_DAILY,
ts_code="000300.SH,000905.SH",
start="2024-01-01",
end="2024-12-31",
)
# 获取国际主要指数日线行情
df = jh.get_data(
DataTypes.TS_INDEX_GLOBAL,
start="2024-01-01",
end="2024-12-31",
)
# 获取申万行业指数日线行情
df = jh.get_data(
DataTypes.TS_SW_DAILY,
start="2024-01-01",
end="2024-12-31",
)

指数日线指标

DataType说明
TS_INDEX_DAILYBASIC指数日线基础指标(市值、换手率、PE、PB等,覆盖上证综指、深证成指、上证50、中证500、中小板指、创业板指)
# 获取指数日线基础指标
df = jh.get_data(
DataTypes.TS_INDEX_DAILYBASIC,
start="2024-01-01",
end="2024-12-31",
)

交易所统计

DataType说明
TS_DAILY_INFO交易所股票交易统计(各板块明细,含成交额、成交量、换手率等)
# 获取交易所股票交易统计
df = jh.get_data(
DataTypes.TS_DAILY_INFO,
start="2024-01-01",
end="2024-12-31",
)

宏观数据

中国宏观数据

DataType说明
TS_SHIBORShibor 利率
TS_SHIBOR_LPRLPR 贷款基础利率
TS_SHIBOR_QUOTEShibor 报价数据
TS_LIBOR伦敦银行间同业拆借利率(LIBOR)
TS_HIBOR香港银行间同业拆借利率(HIBOR)
TS_CN_GDP国民经济之 GDP 数据
TS_CN_CPI居民消费价格指数(CPI),包括全国、城市和农村的数据
TS_CN_PPI工业生产者出厂价格指数(PPI)
TS_CN_M货币供应量之月度数据
TS_CN_PMI采购经理人指数(PMI)
# 获取 GDP 数据
df = jh.get_data(
DataTypes.TS_CN_GDP,
start="2020-01-01",
end="2024-12-31",
)
# 获取 CPI 数据
df = jh.get_data(
DataTypes.TS_CN_CPI,
start="2024-01-01",
end="2024-12-31",
)
# 获取货币供应量数据
df = jh.get_data(
DataTypes.TS_CN_M,
start="2024-01-01",
end="2024-12-31",
)

美国宏观数据

DataType说明
TS_US_TYCR美国国债收益率曲线利率(日频)
TS_US_TRYCR美国国债实际收益率曲线利率
TS_US_TBR美国短期国债利率
TS_US_TLTR美国国债长期利率
TS_US_TRLTR美国国债实际长期利率平均值
# 获取美国国债收益率曲线利率
df = jh.get_data(
DataTypes.TS_US_TYCR,
start="2024-01-01",
end="2024-12-31",
)
# 获取美国短期国债利率
df = jh.get_data(
DataTypes.TS_US_TBR,
start="2024-01-01",
end="2024-12-31",
)

JH数据

jh_ 前缀数据由 Jiuhuang 基于 tushare 数据本地计算的学术因子模型结果,当前只提供月频数据(对应 *_daily 无数据维护)。

每种模型有两类表:

类别命名粒度字段
因子收益率jh_factor_{model}_returns_monthly每月一行date + 各因子收益率
个股因子暴露jh_factor_{model}_exposure_monthly每股票每月一行date + symbol + 各因子暴露
  • date:当月最后一个实际交易日(与 TS_MONTHLY_* 行情同约定,不是自然月末日期)。
  • symbolts_code 风格(如 000001.SZ),与 tushare 行情 ts_code 一致,可直接与 TS_MONTHLY_* 价格做 join。
  • 因子收益率表唯一键为 date;暴露表唯一键为 (date, symbol)

支持的模型:

模型(枚举值)模型说明因子列
ff3Fama-French三因子模型mkt smb hml
ff5Fama-French五因子模型mkt smb hml rmw cma
carhartCarhart四因子模型mkt smb hml umd
nmNovy-Marx四因子模型(FactorType.NOVY_MARXmkt hml_adj umd gp_a
hxzq-factor模型(FactorType.HOU_XUE_ZHANGmkt me ia roe
dhsDaniel-Hirshleifer-Sun行为三因子模型mkt pead fin
capmCAPM单因子模型mkt
ch3中国三因子模型(CH-3)mkt smb vmg
sy4Stambaugh-Yuan四因子模型mkt smb mgmt perf
reversal短期反转模型mkt smb rev
low_vol低波动模型mkt smb ivol

枚举值 nm 对应 FactorType.NOVY_MARXhxz 对应 FactorType.HOU_XUE_ZHANG,其余枚举值即 FactorTypevalue

使用示例:

from jh_quant.data import JHData, DataTypes
jh = JHData()
# 因子收益率(市场整体,每月一行)
fr = jh.get_data(
DataTypes.JH_FACTOR_FF3_RETURNS_MONTHLY,
start="2020-01-01",
end="2024-12-31",
)
# 个股因子暴露(每股票每月一行)
ex = jh.get_data(
DataTypes.JH_FACTOR_FF3_EXPOSURE_MONTHLY,
start="2020-01-01",
end="2024-12-31",
)

遍历所有月频因子数据:

from jh_quant.data import DataTypes
for dt in DataTypes:
if dt.value.startswith("jh_factor_") and dt.value.endswith("_monthly"):
print(f"{dt.name} = {dt.value}")

完整列表

以下为当前有数据维护的全部 DataTypes(含复权变体共 102 个),表名大写即对应枚举名。

akshare(ak_ 前缀,共 16 个)

枚举名值(API 标识)
AK_STOCK_ZH_A_SPOTak_stock_zh_a_spot
AK_STOCK_ZH_A_HISTak_stock_zh_a_hist
AK_STOCK_ZH_A_HIST_QFQak_stock_zh_a_hist_qfq
AK_STOCK_ZH_A_HIST_HFQak_stock_zh_a_hist_hfq
AK_STOCK_LRB_EMak_stock_lrb_em
AK_STOCK_ZCFZ_EMak_stock_zcfz_em
AK_STOCK_XJLL_EMak_stock_xjll_em
AK_STOCK_INFO_A_CODE_NAMEak_stock_info_a_code_name
AK_TOOL_TRADE_DATE_HIST_SINAak_tool_trade_date_hist_sina
AK_STOCK_ZH_A_ST_EMak_stock_zh_a_st_em
AK_MACRO_CHINA_MARKET_MARGIN_SHak_macro_china_market_margin_sh
AK_MACRO_CHINA_MARKET_MARGIN_SZak_macro_china_market_margin_sz
AK_STOCK_ZH_INDEX_DAILY_EMak_stock_zh_index_daily_em
AK_MACRO_CHINA_SHIBOR_ALLak_macro_china_shibor_all
AK_MACRO_CHINA_GDPak_macro_china_gdp
AK_MACRO_CHINA_MONEY_SUPPLYak_macro_china_money_supply

tushare(ts_ 前缀,共 64 个)

枚举名值(API 标识)分类
TS_DAILYts_daily行情
TS_DAILY_QFQts_daily_qfq行情
TS_DAILY_HFQts_daily_hfq行情
TS_WEEKLYts_weekly行情
TS_WEEKLY_QFQts_weekly_qfq行情
TS_WEEKLY_HFQts_weekly_hfq行情
TS_MONTHLYts_monthly行情
TS_MONTHLY_QFQts_monthly_qfq行情
TS_MONTHLY_HFQts_monthly_hfq行情
TS_DAILY_BASICts_daily_basic行情
TS_MONTHLY_BASICts_monthly_basic行情
TS_BALANCESHEETts_balancesheet基本面
TS_INCOMEts_income基本面
TS_CASHFLOWts_cashflow基本面
TS_FINA_INDICATORts_fina_indicator基本面
TS_FINA_AUDITts_fina_audit基本面
TS_STOCK_BASICts_stock_basic基础信息
TS_TRADE_CALts_trade_cal基础信息
TS_ADJ_FACTORts_adj_factor基础信息
TS_NEW_SHAREts_new_share新股与风险警示
TS_STOCK_STts_stock_st新股与风险警示
TS_SUSPEND_Dts_suspend_d新股与风险警示
TS_CYQ_CHIPSts_cyq_chips筹码持仓
TS_CYQ_PERFts_cyq_perf筹码持仓
TS_STK_HOLDERTRADEts_stk_holdertrade筹码持仓
TS_TOP10_HOLDERSts_top10_holders筹码持仓
TS_MONEYFLOWts_moneyflow资金流向
TS_MONEYFLOW_THSts_moneyflow_ths资金流向
TS_MONEYFLOW_CNT_THSts_moneyflow_cnt_ths资金流向
TS_MONEYFLOW_IND_THSts_moneyflow_ind_ths资金流向
TS_MONEYFLOW_MKT_DCts_moneyflow_mkt_dc资金流向
TS_MARGINts_margin融资融券
TS_MARGIN_DETAILts_margin_detail融资融券
TS_EXPRESSts_express业绩预告
TS_FORECASTts_forecast业绩预告
TS_DIVIDENDts_dividend分红股本
TS_TOP_LISTts_top_list龙虎榜
TS_TOP_INSTts_top_inst龙虎榜
TS_STK_FACTOR_PROts_stk_factor_pro技术面
TS_STK_AH_COMPARISONts_stk_ah_comparison跨市场
TS_THS_INDEXts_ths_index同花顺概念
TS_THS_MEMBERts_ths_member同花顺概念
TS_THS_DAILYts_ths_daily同花顺概念
TS_INDEX_BASICts_index_basic指数
TS_INDEX_DAILYts_index_daily指数
TS_INDEX_GLOBALts_index_global指数
TS_DAILY_INFOts_daily_info指数
TS_SW_DAILYts_sw_daily指数
TS_INDEX_DAILYBASICts_index_dailybasic指数
TS_SHIBORts_shibor宏观-中国
TS_SHIBOR_LPRts_shibor_lpr宏观-中国
TS_SHIBOR_QUOTEts_shibor_quote宏观-中国
TS_LIBORts_libor宏观-中国
TS_HIBORts_hibor宏观-中国
TS_CN_GDPts_cn_gdp宏观-中国
TS_CN_CPIts_cn_cpi宏观-中国
TS_CN_PPIts_cn_ppi宏观-中国
TS_CN_Mts_cn_m宏观-中国
TS_CN_PMIts_cn_pmi宏观-中国
TS_US_TYCRts_us_tycr宏观-美国
TS_US_TRYCRts_us_trycr宏观-美国
TS_US_TBRts_us_tbr宏观-美国
TS_US_TLTRts_us_tltr宏观-美国
TS_US_TRLTRts_us_trltr宏观-美国

jiuhuang(jh_ 前缀,共 22 个)

枚举名值(API 标识)分类
JH_FACTOR_CAPM_EXPOSURE_MONTHLYjh_factor_capm_exposure_monthly因子
JH_FACTOR_CAPM_RETURNS_MONTHLYjh_factor_capm_returns_monthly因子
JH_FACTOR_CARHART_EXPOSURE_MONTHLYjh_factor_carhart_exposure_monthly因子
JH_FACTOR_CARHART_RETURNS_MONTHLYjh_factor_carhart_returns_monthly因子
JH_FACTOR_CH3_EXPOSURE_MONTHLYjh_factor_ch3_exposure_monthly因子
JH_FACTOR_CH3_RETURNS_MONTHLYjh_factor_ch3_returns_monthly因子
JH_FACTOR_DHS_EXPOSURE_MONTHLYjh_factor_dhs_exposure_monthly因子
JH_FACTOR_DHS_RETURNS_MONTHLYjh_factor_dhs_returns_monthly因子
JH_FACTOR_FF3_EXPOSURE_MONTHLYjh_factor_ff3_exposure_monthly因子
JH_FACTOR_FF3_RETURNS_MONTHLYjh_factor_ff3_returns_monthly因子
JH_FACTOR_FF5_EXPOSURE_MONTHLYjh_factor_ff5_exposure_monthly因子
JH_FACTOR_FF5_RETURNS_MONTHLYjh_factor_ff5_returns_monthly因子
JH_FACTOR_HXZ_EXPOSURE_MONTHLYjh_factor_hxz_exposure_monthly因子
JH_FACTOR_HXZ_RETURNS_MONTHLYjh_factor_hxz_returns_monthly因子
JH_FACTOR_LOW_VOL_EXPOSURE_MONTHLYjh_factor_low_vol_exposure_monthly因子
JH_FACTOR_LOW_VOL_RETURNS_MONTHLYjh_factor_low_vol_returns_monthly因子
JH_FACTOR_NM_EXPOSURE_MONTHLYjh_factor_nm_exposure_monthly因子
JH_FACTOR_NM_RETURNS_MONTHLYjh_factor_nm_returns_monthly因子
JH_FACTOR_REVERSAL_EXPOSURE_MONTHLYjh_factor_reversal_exposure_monthly因子
JH_FACTOR_REVERSAL_RETURNS_MONTHLYjh_factor_reversal_returns_monthly因子
JH_FACTOR_SY4_EXPOSURE_MONTHLYjh_factor_sy4_exposure_monthly因子
JH_FACTOR_SY4_RETURNS_MONTHLYjh_factor_sy4_returns_monthly因子

枚举定义中还有其他类型(基金、港股、美股等),但目前它们对应的数据表没有数据维护,不建议在生产中使用。指数相关类型已在上方列出并可用。

也可通过代码查看完整列表:

from jh_quant.data import DataTypes
for dt in DataTypes:
print(f"{dt.name} = {dt.value}")