get_etf_info - 获取ETF信息

get_etf_info(etf_code)

使用场景

该函数仅支持Ptrade客户端可用、仅在股票交易模块可用

接口说明

该接口用于获取单支或者多支ETF的信息。

注意事项：

无

参数

etf_code : 单支ETF代码或者一个ETF代码的list，必传参数(list[str]/str)

返回

正常返回一个dict类型字段，包含每只ETF信息，key为ETF代码，values为包含etf信息的dict。异常返回空dict，如{}(dict[str:dict[...]])

返回结果字段介绍：

• etf_redemption_code -- 申赎代码(str:str)；
• publish -- 是否需要发布IOPV(str:int)；
• report_unit -- 最小申购、赎回单位(str:int)；
• cash_balance -- 现金差额(str:float)；
• max_cash_ratio -- 现金替代比例上限(str:float)；
• pre_cash_component -- T-1日申购基准单位现金余额(str:float)；
• nav_percu -- T-1日申购基准单位净值(str:float)；
• nav_pre -- T-1日基金单位净值(str:float)；
• allot_max -- 申购上限(str:float)；
• redeem_max -- 赎回上限(str:float)；

字段备注:

• publish -- 是否需要发布IOPV，1是需要发布，0是不需要发布；

返回如下:

{'510020.SS': {'nav_percu': 206601.39, 'redeem_max': 0.0, 'nav_pre': 0.207, 'report_unit': 1000000, 'max_cash_ratio': 0.4,

'cash_balance': -813.75, 'etf_redemption_code': '510021', 'pre_cash_component': 598.39, 'allot_max': 0.0, 'publish': 1}}

示例

get_etf_stock_info - 获取ETF成分券信息

get_etf_stock_info(etf_code,security)

使用场景

该函数仅支持Ptrade客户端可用、仅在股票交易模块可用

接口说明

该接口用于获取ETF成分券信息。

注意事项：

无

参数

etf_code : 单支ETF代码，必传参数(str)

security : 单只股票代码或者一个由多只股票代码组成的列表，必传参数(list[str]/str)

返回

正常返回一个dict类型字段，包含每只etf代码中成分股的信息。异常返回空dict，如{}(dict[str:dict[...]])

返回结果字段介绍：

• code_num -- 成分券数量(str:float)；
• cash_replace_flag -- 现金替代标志(str:str)；
• '0' -- 禁止替代；
• '1' -- 允许替代；
• '2' -- 必须替代；
• '3' -- 非沪市退补现金替代；
• '4' -- 非沪市必须现金替代；
• '5' -- 非沪深退补现金替代；
• '6' -- 非沪深必须现金替代；
• replace_ratio -- 保证金率（溢价比率），允许现金替代标的此字段有效(str:float)；
• replace_balance -- 替代金额,必须现金替代标的此字段有效(str:float)；
• is_open -- 停牌标志，0-停牌，1-非停牌(str:int)；

返回如下:

{'600000.SS': {'cash_replace_flag': '1', 'replace_ratio': 0.1, 'is_open': 1, 'code_num': 4700.0, 'replace_balance': 0.0}}

示例

get_gear_price – 获取指定代码的档位行情价格

get_gear_price(sids)

使用场景

该函数仅在交易模块可用

接口说明

该接口用于获取指定代码的档位行情价格。

注意事项：

获取实时行情快照失败时返回档位内容为空dict({"bid_grp": {}, "offer_grp": {}})

若无L2行情时，委托笔数字段返回0。

参数

sids：股票代码(list[str]/str)；

返回

包含以下信息(dict[str:dict[int:list[float,int,int],...],...])：

• bid_grp:委买档位(str:dict[int:list[float,int,int],...])；
• offer_grp:委卖档位(str:dict[int:list[float,int,int],...])；

单只代码返回：

{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

多只代码返回：

{代码：{'bid_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]},

'offer_grp': {1: [价格, 委托量,委托笔数], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}}

}

示例

get_snapshot - 取行情快照

get_snapshot(security)

使用场景

该函数仅在交易模块可用

接口说明

该接口用于获取实时行情快照。

注意事项：

无

参数

security： 单只股票代码或者多只股票代码组成的列表，必填字段(list[str]/str)；

返回

正常返回一个dict类型数据，包含每只股票代码的行情快照信息，其中key为股票代码，value为对应的快照信息。异常返回空dict，如{}(dict[str:dict[...]])

快照包含以下信息：

• amount:持仓量(str:int)；
• avg_px:均价
• bid_grp:委买档位(第一档包含委托队列（仅L2支持）)(str:dict[int:list[float,int,int,{int:int,...}],int:list[float,int,int]...])；
• business_amount:总成交量(str:int)；
• business_amount_in:内盘成交量(str:int)；
• business_amount_out:外盘成交量(str:int)；
• business_balance:总成交额(str:float)；
• business_count:成交笔数(str:int)
• circulation_amount:流通股本(str:int)；
• close_px:今收价(str:float)
• current_amount:最近成交量(现手)(str:int)；
• down_px:跌停价格(str:float)；
• end_trade_date:最后交易日(str:str)
• entrust_diff:委差(str:float)；
• entrust_rate:委比(str:float)；
• high_px:最高价(str:float)；
• hsTimeStamp:时间戳(str:float)；
• issue_date:上市日期(str:int)；
• last_px:最新成交价(str:float)；
• low_px:最低价(str:float)；
• offer_grp:委卖档位(第一档包含委托队列（仅L2支持）)(str:dict[int:list[float,int,int,{int:int,...}],int:list[float,int,int]...])；
• open_px:今开盘价(str:float)；
• pb_rate:市净率(str:float)；
• pe_rate:动态市盈率(str:float)；
• preclose_px:昨收价(str:float)；
• prev_settlement:昨结算(str:float)；
• px_change_rate:涨跌幅(str:float)；
• settlement:结算价(str:float)
• start_trade_date:首个交易日(str:float)
• tick_size:最小报价单位(str:float)
• total_bid_turnover:委买金额(str:int)；
• total_bidqty:委买量(str:int)；
• total_offer_turnover:委卖金额(str:int)
• total_offerqty:委卖量(str:int)；
• trade_mins:交易分钟数(str:int)
• trade_status:交易状态(str:str)；
• turnover_ratio:换手率(str:int)；
• up_px:涨停价格(str:float)；
• vol_ratio:量比(str:float)；
• wavg_px:加权平均价(str:float)；

字段备注:

• bid_grp -- 委买档位，{'bid_grp': {1: [价格, 委托量,委托笔数,委托对列{}], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}} ；
• offer_grp -- 委卖档位，{'offer_grp': {1: [价格, 委托量,委托笔数,委托对列{}], 2: [价格, 委托量,委托笔数], 3: [价格, 委托量,委托笔数], 4: [价格, 委托量,委托笔数], 5: [价格, 委托量,委托笔数]}} ；
• total_bid_turnover/total_offer_turnover,委买金额/委卖金额主推数据(tick数据中)不支持(值为0)，仅在线请求中支持；
• trade_status -- 交易状态；
• START -- 市场启动(初始化之后，集合竞价前)
• PRETR -- 盘前
• OCALL -- 开始集合竞价
• TRADE -- 交易(连续撮合)
• HALT -- 暂停交易
• SUSP -- 停盘
• BREAK -- 休市
• POSTR -- 盘后
• ENDTR -- 交易结束
• STOPT -- 长期停盘，停盘n天，n>=1
• DELISTED -- 退市
• POSMT -- 盘后交易
• PCALL -- 盘后集合竞价
• INIT -- 盘后固定价格启动前
• ENDPT -- 盘后固定价格闭市阶段
• POSSP -- 盘后固定价格停牌

返回如下:

{'600570.SS': {'offer_grp': {1: [44.47, 3300, 0, {}], 2: [44.48, 2800, 0], 3: [44.49, 3900, 0], 4: [44.5, 17300, 0], 5: [44.51, 1600, 0]}, 'open_px': 44.91, 'pe_rate': 4294573.83, 'pb_rate': 11.42, 'entrust_diff': -100.0, 'entrust_rate': -0.2092, 'total_bidqty': 18900, 'preclose_px': 45.2, 'total_offer_turnover': 0, 'issue_date': 0, 'business_amount_out': 2600706, 'px_change_rate': -1.62, 'turnover_ratio': 0.0042, 'total_bid_turnover': 0, 'vol_ratio': 1.12, 'hsTimeStamp': 20220622102358580, 'amount': 0, 'prev_settlement': 0.0, 'circulation_amount': 1461560480, 'low_px': 44.31, 'down_px': 40.68, 'bid_grp': {1: [44.45, 600, 0, {}], 2: [44.44, 600, 0], 3: [44.43, 8300, 0], 4: [44.42, 9200, 0], 5: [44.41, 200, 0]}, 'business_balance': 274847503.0, 'business_amount': 6161800, 'business_amount_in': 3561094, 'last_px': 44.47, 'total_offerqty': 28900, 'up_px': 49.72, 'wavg_px': 44.6, 'high_px': 45.05, 'trade_status': 'TRADE'}}

示例

get_cb_info – 获取可转债基础信息

get_cb_info()

使用场景

该函数仅在研究、交易模块可用

接口说明

获取可转债基础信息。

注意事项：

1. 获取失败时返回空DataFrame。
2. 此API依靠可转债基础数据权限，使用前请与券商确认是否有此权限，无权限时调用返回空DataFrame。

参数

无

返回

正常返回一个DataFrame类型数据，包含每只可转债的信息

包含以下信息：

• bond_code:可转债代码(str)；
• bond_name:可转债名称(str)；
• stock_code:股票代码(str)；
• stock_name:股票名称(str)；
• list_date:上市日期(str)；
• premium_rate:溢价率(float)；
• convert_date:转股起始日(str)；
• maturity_date:到期日(str)；
• convert_rate:转股比例(float)；
• convert_price:转股价格(float)；
• convert_value:转股价值(float)；

示例

后续小编会持续更新关于ptrade使用的内容，关于ptrade开通的问题可以随时私信评论或者留言哦！小编会第一时间回复的！