ptrade 平台调用 get_etf_info 返回空字典 {} 怎么办？

在 ptrade 量化交易平台中，调用 get_etf_info 接口获取 ETF 信息时，如果返回空字典 {}，通常代表接口调用出现了异常。即使您认为代码和参数正确，也可能忽略了平台的一些特定限制。以下是导致该问题的常见原因及排查方法：

1. 运行环境不匹配（最常见原因）

根据 ptrade API 文档规定，get_etf_info 函数仅支持 Ptrade 客户端可用，且仅在股票交易模块可用。

• 错误场景：如果您在回测模块或研究模块中调用此函数，系统无法获取实时的柜台 ETF 数据，因此会直接返回空字典 {}。
• 解决方法：请确保您的策略代码是在实盘/模拟盘的交易环境中运行。

2. ETF 代码格式不规范

ptrade 对证券代码的格式有严格要求，必须包含正确的市场后缀。

• 错误场景：传入了纯数字代码，如 '510050'。
• 解决方法：确保代码带有 .SS（上交所）或 .SZ（深交所）后缀。例如：'510050.SS'。

3. 传入的 ETF 代码不存在或已退市

如果您查询的 ETF 代码在当前市场中不存在、尚未上市或已经退市，柜台无法返回有效信息。

• 解决方法：可以通过 get_etf_list() 接口先获取当前市场支持的 ETF 代码列表，确认您要查询的代码是否在该列表中。

4. 柜台连接或底层数据异常

由于该接口直接依赖于券商柜台的数据返回，如果当前网络拥堵、柜台系统维护或行情快照未就绪（例如在非交易时间段的某些时刻），也可能导致获取失败从而返回空字典。

• 解决方法：在代码中增加异常处理和重试机制，避免因单次获取失败导致策略中断。

正确的调用示例

请确保在交易模块中按如下方式调用：

def initialize(context):
    g.security = '510050.SS'
    set_universe(g.security)

def handle_data(context, data):
    # 确保在交易模块中运行
    etf_info = get_etf_info(g.security)
    
    if not etf_info:
        log.warning(f"未能获取到 {g.security} 的 ETF 信息，请检查运行环境或代码格式。")
    else:
        log.info(f"成功获取 ETF 信息: {etf_info}")

总结：遇到 get_etf_info 返回 {} 时，首先检查当前是否处于回测环境，其次核对代码后缀是否正确。如果确认在交易环境中且代码无误，建议联系券商确认当前环境的 ETF 数据权限是否正常开通。