python量化交易入门教程，ptrade量化交易快速入门教程
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()
使用场景
该函数仅在研究、交易模块可用
接口说明
获取可转债基础信息。
注意事项：
参数
无
返回
正常返回一个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开通的问题可以随时私信评论或者留言哦！小编会第一时间回复的！
评论