问题描述
ETF 申购时如何查询哪些成分股允许现金替代？
解决方案
在 PTrade 中，查询 ETF 申购时哪些成分股允许现金替代，主要使用 get_etf_stock_info 接口。
该接口返回的字典中包含 cash_replace_flag 字段，用于标识现金替代的状态。
核心步骤
- 获取成分股列表：使用
get_etf_stock_list(etf_code)获取 ETF 的所有成分股代码。 - 查询成分股信息：使用
get_etf_stock_info(etf_code, security_list)获取详细信息。 - 判断替代标志：检查返回信息中的
cash_replace_flag字段。
现金替代标志 (cash_replace_flag) 说明
'0'：禁止替代'1'：允许替代 (通常指可以股票缴款，也可以现金替代)'2'：必须替代 (必须使用现金)'3'：非沪市退补现金替代'4'：非沪市必须现金替代'5'：非沪深退补现金替代'6'：非沪深必须现金替代
策略代码示例
以下代码展示了如何获取 510050.SS (上证50ETF) 中所有允许现金替代（标志为 '1'）的成分股。
def initialize(context):
# 设置要查询的ETF代码，例如上证50ETF
g.etf_code = '510050.SS'
set_universe([g.etf_code])
# 在初始化时直接运行一次查询逻辑（也可以放在 before_trading_start）
check_etf_cash_substitution(context)
def check_etf_cash_substitution(context):
# 1. 获取ETF的所有成分股列表
stock_list = get_etf_stock_list(g.etf_code)
if not stock_list:
log.info("未获取到ETF成分股列表，请检查ETF代码或数据权限。")
return
# 2. 获取成分股的详细申赎信息
# 注意：get_etf_stock_info 第二个参数支持列表，一次性获取所有成分股信息
stocks_info = get_etf_stock_info(g.etf_code, stock_list)
if not stocks_info:
log.info("未获取到成分股详细信息。")
return
allow_cash_list = []
must_cash_list = []
# 3. 遍历结果，筛选允许现金替代的股票
for stock_code, info in stocks_info.items():
# 获取现金替代标志
flag = info.get('cash_replace_flag')
# 标志为 '1' 表示允许替代
if flag == '1':
allow_cash_list.append(stock_code)
# 标志为 '2' 表示必须替代
elif flag == '2':
must_cash_list.append(stock_code)
# 4. 打印结果
log.info("ETF代码: %s" % g.etf_code)
log.info("允许现金替代(Flag=1)的成分股数量: %d" % len(allow_cash_list))
log.info("允许现金替代的成分股列表: %s" % allow_cash_list)
log.info("必须现金替代(Flag=2)的成分股数量: %d" % len(must_cash_list))
log.info("必须现金替代的成分股列表: %s" % must_cash_list)
def handle_data(context, data):
pass
注意事项
- 交易模块专用：
get_etf_stock_info和get_etf_stock_list函数通常仅在股票交易模块（实盘或仿真交易）中可用，回测环境可能不支持或返回空数据（具体取决于券商服务器配置）。 - 替代比例：如果
cash_replace_flag为'1'（允许替代），返回的字典中通常还会包含replace_ratio（替代溢价比例），在计算申购成本时需要考虑该比例。 - 必须替代：在实际业务中，停牌股票通常会被设置为“必须现金替代”（Flag='2'），在申购时也需要准备相应的现金。
Q&A
Q: get_etf_stock_info 接口返回的 replace_ratio 是什么意思？
A: replace_ratio 代表现金替代的溢价比例（保证金率）。当成分股允许现金替代时，券商为了防范补券成本波动，通常会多收一定比例的现金。例如 0.1 代表需要多缴纳 10% 的现金作为保证金。
Q: 回测模式下报错 get_etf_stock_info 未定义或返回空怎么办？
A: 该接口是交易专用接口，依赖柜台数据。在纯回测模式下，PTrade 通常不提供实时的 ETF 申赎清单数据。如果需要在回测中模拟 ETF 申赎，通常需要自己通过 get_history 获取成分股价格来估算 IOPV，并假设所有股票均可买入，或者手动构建历史的申赎清单数据。
Q: 如何判断一只成分股是否因为停牌而必须使用现金替代？
A: 可以结合 get_etf_stock_info 返回的 is_open 字段（0-停牌，1-非停牌）以及 cash_replace_flag（通常停牌股该标志为 '2'）来综合判断。