Question

基础数据

目前，掘金量化支持上交所和深交所的交易标的查询。

交易所名称	市场代码
上交所	SHSE
深交所	SZSE

Python 数据接口

• get_symbol_infos - 查询标的基本信息，获取指定(范围)交易标的基本信息，与时间无关。

• get_symbols - 查询指定交易日多标的交易信息，获取指定交易日多个标的交易信息，包括基本信息及日度数据。

• get_history_symbol - 查询指定标的多日交易信息，获取指定标的多个历史交易日的交易信息，包括基本信息及日度数据.

• get_trading_dates_by_year - 查询年度交易日历，按年份查询从1991-01-01以来的交易日历。

• get_trading_session - 查询交易时段，查询基金交易时间段。

• fnd_get_adj_factor - 查询基金复权因子，查询某只基金在一段时间内的复权因子。

示例 1

获取“SHSE.510300”的基本信息：

get_symbol_infos(sec_type1=1020, symbols='SHSE.510300')

返回结果：

[{'symbol': 'SHSE.510300', 'sec_type1': 1020, 'sec_type2': 102001, 'board': 10200101, 'exchange': 'SHSE', 'sec_id': '510300', 'sec_name': '华泰柏瑞沪深300ETF', 'sec_abbr': 'HTBRHS300ETF', 'price_tick': 0.001, 'trade_n': 1, 'listed_date': datetime.datetime(2012, 5, 28, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None}]

示例 2

获取“SHSE.510300”的基本数据及最新日频数据：

get_symbols(sec_type1=1020, symbols='SHSE.510300', trade_date='2022-01-13')

返回结果：

[{'trade_date': datetime.datetime(2022, 1, 13, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'pre_close': 4.919, 'upper_limit': 5.411, 'lower_limit': 4.427, 'turn_rate': 4.1024, 'adj_factor': 1.146326449, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'SHSE.510300', 'sec_type1': 1020, 'sec_type2': 102001, 'board': 10200101, 'exchange': 'SHSE', 'sec_id': '510300', 'sec_name': '华泰柏瑞沪深300ETF', 'sec_abbr': 'HTBRHS300ETF', 'price_tick': 0.001, 'trade_n': 1, 'listed_date': datetime.datetime(2012, 5, 28, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None}]

示例 3

获取“SHSE.510300”在 2021-03-01 -- 2021-3-3 的历史信息数据：

get_history_symbol(symbol='SHSE.510300', start_date='2021-03-01', end_date='2021-03-03', df=False)

返回结果：

[{'trade_date': datetime.datetime(2021, 3, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'pre_close': 5.329, 'upper_limit': 5.862, 'lower_limit': 4.796, 'turn_rate': 6.9226, 'adj_factor': 1.146326449, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'SHSE.510300', 'sec_type1': 1020, 'sec_type2': 102001, 'board': 10200101, 'exchange': 'SHSE', 'sec_id': '510300', 'sec_name': '华泰柏瑞沪深300ETF', 'sec_abbr': 'HTBRHS300ETF', 'price_tick': 0.001, 'trade_n': 1, 'listed_date': datetime.datetime(2012, 5, 28, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None},
 {'trade_date': datetime.datetime(2021, 3, 2, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'pre_close': 5.418, 'upper_limit': 5.96, 'lower_limit': 4.876, 'turn_rate': 5.5579, 'adj_factor': 1.146326449, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'SHSE.510300', 'sec_type1': 1020, 'sec_type2': 102001, 'board': 10200101, 'exchange': 'SHSE', 'sec_id': '510300', 'sec_name': '华泰柏瑞沪深300ETF', 'sec_abbr': 'HTBRHS300ETF', 'price_tick': 0.001, 'trade_n': 1, 'listed_date': datetime.datetime(2012, 5, 28, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None},
 {'trade_date': datetime.datetime(2021, 3, 3, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'pre_close': 5.349, 'upper_limit': 5.884, 'lower_limit': 4.814, 'turn_rate': 4.7013, 'adj_factor': 1.146326449, 'margin_ratio': 1.0, 'multiplier': 1, 'is_adjusted': False, 'is_suspended': False, 'position': 0, 'settle_price': 0.0, 'pre_settle': 0.0, 'conversion_price': 0.0, 'exercise_price': 0.0, 'is_st': False, 'symbol': 'SHSE.510300', 'sec_type1': 1020, 'sec_type2': 102001, 'board': 10200101, 'exchange': 'SHSE', 'sec_id': '510300', 'sec_name': '华泰柏瑞沪深300ETF', 'sec_abbr': 'HTBRHS300ETF', 'price_tick': 0.001, 'trade_n': 1, 'listed_date': datetime.datetime(2012, 5, 28, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'delisted_date': datetime.datetime(2038, 1, 1, 0, 0, tzinfo=datetime.timezone(datetime.timedelta(seconds=28800), 'Asia/Shanghai')), 'underlying_symbol': '', 'option_type': '', 'option_margin_ratio1': 0.0, 'option_margin_ratio2': 0.0, 'call_or_put': '', 'conversion_start_date': None}]

其他语言数据接口

C#

• GetSymbolInfos - 查询标的基本信息
• GetSymbols - 查询指定交易日多标的交易信息
• GetHistorySymbol - 查询指定标的多日交易信息
• GetTradingDatesByYear - 查询年度交易日历
• GetTradingSession - 查询交易时段

C++

• get_symbol_infos - 查询标的基本信息
• get_symbols_by_date - 查询指定交易日多标的交易信息
• get_history_symbol - 查询指定标的多日交易信息
• get_trading_dates_by_year - 查询年度交易日历
• get_trading_session - 查询交易时段

MATLAB

• get_instrumentinfos - 查询交易标的基本信息
• get_instruments - 查询最新交易标的最新基本信息
• get_history_instruments - 查询交易标的历史基本信息
• get_trading_dates - 查询交易日历表
• get_previous_trading_date - 查询上一个交易日
• get_next_trading_date - 查询下一个交易日

---

行情数据

实时行情数据

掘金量化目前支持获取国内两个市场的基金实时行情数据。

包含 Tick 行情和 Bar 行情。

交易所名称	市场代码
上交所	SHSE
深交所	SZSE

Tick - Tick 行情

快照行情, 包含以下内容：

参数名	类型	说明
symbol	str	标的代码
open	float	开盘价
high	float	最高价
low	float	最低价
price	float	最新价
cum_volume	int	成交总量/最新成交量,累计值
cum_amount	float	成交总金额/最新成交额,累计值
trade_type	int	交易类型 1: ‘双开’, 2: ‘双平’, 3: ‘多开’, 4: ‘空开’, 5: ‘空平’, 6: ‘多平’, 7: ‘多换’, 8: ‘空换’
last_volume	int	瞬时成交量
cum_position	int	合约持仓量(期),累计值（股票此值为 0）
last_amount	float	瞬时成交额 (郑商所 last_amount 为 0)
created_at	datetime.datetime	创建时间
quotes	list[quote]	股票提供买卖 1-5 档,list[0]~list[4]分别对应买卖一档到五档；跌停时无买方报价，涨停时无卖方报价
iopv	float	基金份额参考净值，(只适用于基金)

Quote - 报价(dict)

参数名	类型	说明
bid_p	float	买价
bid_v	int	买量
ask_p	float	卖价
ask_v	int	卖量

Bar - Bar 行情

支持以下多种频率的基金实时行情数据：

交易所名称	市场代码	数据频率
上交所	SHSE	60s, 300s, 900s, 1800s, 3600s
深交所	SZSE	60s, 300s, 900s, 1800s, 3600s

注：s 表示“秒”。

行情包含以下数据:

参数名	类型	说明
symbol	str	标的代码
frequency	str	频率
open	float	开盘价
close	float	收盘价
high	float	最高价
low	float	最低价
amount	float	成交额
volume	int	成交量
bob	datetime.datetime	bar 开始时间
eob	datetime.datetime	bar 结束时间

历史行情数据

掘金量化目前支持获取国内两个市场的基金历史行情数据。

包含 Tick 行情和 Bar 行情。

交易所名称	市场代码
上交所	SHSE
深交所	SZSE

Tick - Tick 行情

时间范围：最早支持2022.8.10，点击[https://www.myquant.cn/terminal]了解更多体验版/专业版/券商版/机构版的Tick时间范围权限。

快照行情，包含以下内容：

参数名	类型	说明
symbol	str	标的代码
open	float	开盘价
high	float	最高价
low	float	最低价
price	float	最新价
cum_volume	int	成交总量/最新成交量,累计值
cum_amount	float	成交总金额/最新成交额,累计值
trade_type	int	交易类型 1：‘双开’, 2：‘双平’, 3：‘多开’, 4：‘空开’, 5：‘空平’, 6：‘多平’, 7：‘多换’, 8：‘空换’
last_volume	int	瞬时成交量
cum_position	int	合约持仓量(期),累计值(股票该值为 0)
last_amount	float	瞬时成交额（郑商所 last_amount 为 0）
created_at	datetime.datetime	创建时间
quotes	list[quote]	股票提供买卖 1-5 档,list[0]~list[4]分别对应买卖一档到五档；跌停时无买方报价，涨停时无卖方报价
iopv	float	基金份额参考净值，(只适用于基金)

Quote - 报价(dict)

参数名	类型	说明
bid_p	float	买价
bid_v	int	买量
ask_p	float	卖价
ask_v	int	卖量

Bar - Bar 行情

支持以下多种频率的基金历史行情数据：

交易所名称	市场代码	频率以及数据范围
上交所	SHSE	60s 以及 60s 的整数倍(2017-1-1 - 至今), 1d(2005-1-1 - 至今), 不提供 60s 以下数据
深交所	SZSE	60s 以及 60s 的整数倍(2017-1-1 - 至今), 1d(2005-1-1 - 至今), 不提供 60s 以下数据

注：s 表示“秒”, d 表示“天”。

行情包含以下数据:

参数名	类型	说明
symbol	str	标的代码
frequency	str	频率
open	float	开盘价
close	float	收盘价
high	float	最高价
low	float	最低价
amount	float	成交额
volume	int	成交量
bob	datetime.datetime	bar 开始时间
eob	datetime.datetime	bar 结束时间

---

成分持仓

Python 数据接口

• fnd_get_etf_constituents - 查询 ETF 最新成分股，查询指定 ETF 在最新交易日的成分股持有情况和现金替代信息。

• fnd_get_portfolio - 查询基金资产组合，查询某只基金在指定日期的基金资产组合（股票持仓、债券持仓等）。

其他语言数据接口

C#

• BndGetCallInfo - 查询可转债赎回信息
• BndGetPutInfo - 查询可转债回售信息

C++

• bnd_get_call_info - 查询可转债赎回信息
• bnd_get_put_info - 查询可转债回售信息

---

场内净值

Python 数据接口

• fnd_get_net_value - 查询基金净值数据，查询某只基金在指定时间段的基金净值数据。

其他语言数据接口

C#

• FndGetNetValue - 查询基金净值数据

C++

• fnd_get_net_value - 查询基金净值数据

---

分红折算

Python 数据接口

• fnd_get_dividend - 查询基金分红信息，查询指定基金在一段时间内的分红信息。

• fnd_get_split - 查询基金拆分折算信息，查询指定基金在一段时间内的拆分折算信息。

其他语言数据接口

C#

• FndGetDividend - 查询基金分红信息
• FndGetSplit - 查询基金拆分折算信息

C++

• fnd_get_dividend - 查询基金分红信息
• fnd_get_split - 查询基金拆分折算信息