get_instruments - 查询最新交易标的信息

查询最新交易标的信息,有基本数据及最新日频数据

函数原型:

 

1. get_instruments(symbols=None, exchanges=None, sec_types=None, names=None, skip_suspended=True, skip_st=True, fields=None, df=False)

参数：

 

参数名	类型	说明
symbols	str or list or None	标的代码 多个代码可用 ,(英文逗号)分割, 也支持 ['symbol1', 'symbol2'] 这种列表格式,默认None表示所有，使用时参考symbol
exchanges	str or list or None	见交易所代码, 多个交易所代码可用 ,(英文逗号)分割, 也支持 ['exchange1', 'exchange2'] 这种列表格式,默认None表示所有
sec_types	list	指定类别, 默认所有, 其他类型见sec_type 类型
names	str or None	查询代码, 默认None 表示所有
skip_suspended	bool	是否跳过停牌, 默认True 跳过停牌
skip_st	bool	是否跳过ST, 默认True 跳过ST
fields	str or None	查询字段 默认None 表示所有,参考返回值。
df	bool	是否返回dataframe格式, 默认False, 返回list[dict]

返回值:

 

key	类型	说明
symbol	str	标的代码
sec_type	int	1: 股票, 2: 基金, 3: 指数, 4: 期货, 5: 期权, 8:可转债，10: 虚拟合约
exchange	str	见交易所代码
sec_id	str	代码
sec_name	str	名称
sec_abbr	str	拼音简称
price_tick	float	最小变动单位
listed_date	datetime.datetime	上市日期
delisted_date	datetime.datetime	退市日期
trade_date	datetime.datetime	交易日期
sec_level	int	1-正常,2-ST 股票,3-*ST 股票,4-股份转让,5-处于退市整理期的证券,6-上市开放基金LOF,7-交易型开放式指数基金(ETF),8-非交易型开放式基金(暂不交易,仅揭示基金净值及开放申购赎回业务),9-仅提供净值揭示服务的开放式基金;,10-仅在协议交易平台挂牌交易的证券,11-仅在固定收益平台挂牌交易的证券,12-风险警示产品,13-退市整理产品,99-其它
is_suspended	int	是否停牌. 1: 是, 0: 否
multiplier	float	合约乘数
margin_ratio	float	保证金比率
settle_price	float	结算价
position	int	持仓量
pre_close	float	昨收价
upper_limit	float	涨停价 （可转债没有涨停价）
lower_limit	float	跌停价 （可转债没有跌停价）
adj_factor	float	复权因子.基金跟股票才有
conversion_price	float	可转债转股价
conversion_start_date	datetime.datetime	可转债开始转股时间
underlying_symbol	str	可转债正股标的

示例：

 

1. get_instruments(exchanges='SZSE', df=True)

输出:

 

1. adj_factor is_st upper_limit sec_name pre_close symbol price_tick delisted_date exchange listed_date sec_type settle_price lower_limit multiplier sec_abbr position trade_date sec_id is_suspended margin_ratio
2. 115.338 0 12.38 平安银行 11.25 SZSE.000001 0.01 2038-01-01 00:00:00 SZSE 1991-04-03 00:00:00 1 0 10.13 1 payx 0 2017-09-19 00:00:00 000001 0 1
3. 127.812 0 30.84 万科A 28.04 SZSE.000002 0.01 2038-01-01 00:00:00 SZSE 1991-01-29 00:00:00 1 0 25.24 1 wkA 0 2017-09-19 00:00:00 000002 0 1
4. 7.44538 0 27.24 国农科技 24.76 SZSE.000004 0.01 2038-01-01 00:00:00 SZSE 1991-01-14 00:00:00 1 0 22.28 1 gnkj 0 2017-09-19 00:00:00 000004 0 1
5. ······

注意：

1.停牌时且股票发生除权除息, 涨停价和跌停价可能有误差

2.预上市股票以1900-01-01为虚拟发布日期，未退市股票以2038-01-01为虚拟退市日期。

3.对于检索所需标的信息的4种手段symbols,exchanges,sec_types,names,若输入参数之间出现任何矛盾（换句话说，所有的参数限制出满足要求的交集为空),则返回
空list/空DataFrame
例如get_instruments(exchanges='SZSE',sec_types=[4])返回的是空值
4.获取全A股票代码示例get_instruments(exchanges='SZSE,SHSE', sec_types=1, fields='symbol',df=1)['symbol'].tolist()
5.若查询字段包含无效字段，返回的列表/DataFrame只包含有效字段数据
6.关于可转债的到期日(退市日期)为delisted_date，转股价值为转股价值 = 转股数*股价=（100/可转债转股价）*股价