标的池

标的池功能，通过调用标的池API接口，实现策略标的池和掘金终端界面【交易工具】-【标的池】联动。在不停止策略运行的情况下，在界面导入标的池，策略可调用标的池API获取标的池成分代码；或者策略通过API创建/修改标的池，在终端界面可查看标的池成分的可视化行情。

• 实时模式（仿真交易和实盘交易）标的池应用：在终端【交易工具】-【标的池】进行增删查改操作，策略实时查询指定标的池成分代码进行交易。
  • 例1：在多个策略之间传递选股标的池（策略A选股 -> 标的池 -> 策略B择时交易） 第一步（策略A）：使用概念板块数据/选股条件产生选股symbol，通过标的池API创建标的池 第二步（终端界面）：人工盯盘，实时手动调整标的池成分股（可选） 第三步（策略B）：通过标的池API获取标的池最新成分股，根据择时逻辑自动交易
  • 例2：手动选股+策略择时（手动选股 -> 标的池 -> 策略择时交易） 第一步（终端界面）：创建标的池（手动自选/文件导入/持仓导入/板块导入） 第二步（终端界面）：人工盯盘，实时手动调整标的池成分股（可选） 第三步（策略）：通过标的池API获取标的池最新成分股，根据择时逻辑自动交易
  • 例3：策略选股+手动交易（策略选股 -> 标的池 -> 手动交易） 第一步（策略）：使用概念板块数据/选股条件产生选股symbol，通过标的池API创建标的池、定时任务更新标的池成分股 第二步（终端界面）：人工盯盘，实时手动调整标的池成分股（可选） 第三步（终端界面）：人工盯盘，手动择时交易
• 回测模式标的池应用：先手动选股，通过终端界面【交易工具】-【标的池】导入标的池，策略调用标的池API获取成分代码进行回测。
  • 例4：手动选股+策略回测（手动选股 -> 标的池 -> 策略历史回测） 第一步（终端界面）：创建标的池（手动自选/文件导入/持仓导入/板块导入） 第二步（终端界面）：手动调整修改标的池成分股（可选） 第三步（策略）：调用标的池API获取标的池成分股，根据策略实现逻辑进行历史回测

universe_set - 设置标的池

创建一个新标的池，或者重置已有标的池成分标的

函数原型：

int universe_set(const char *universe_name, const char *universe_symbols)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
universe_name	str	标的池名称	Y	无	指定标的池名称
universe_symbols	str	成分标的代码	Y	无	单个标的示例："SZSE.000002",多个标的示例："SHSE.600008, SZSE.000002"

返回值：0表示成功，否则返回非0值错误码

示例：

universe_set("妖股", "SZSE.002137,SHSE.603421")

注意：

1. 创建/重置标的池失败会报错。

2. 传入的标的池名称universe_name已存在，会根据universe_symbols重置当前标的池成分。

3. 传入的标的池名称universe_name不存在，会创建一个新标的池。

4. 当universe_symbols为空列表或NULL时，会创建/重置为成分数量为0的一个空标的池。

5. 若已存在重名标的池，会随机选取其中一个标的池进行重置。

universe_get_symbols - 获取标的池成分

获取单个标的池的成分标的代码

函数原型：

DataArray<Symbol>* universe_get_symbols(const char *universe_name)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
universe_name	str	标的池名称	Y	无	指定标的池名称

返回值：列表

类型	说明
DataArray<Symbol>*	成分标的代码 列表

示例：

universe_get_symbols("持仓标的")

注意：

1. 不存在的标的池，返回错误。

2. 成分标的数量为0，返回空列表。

3. 若存在重名标的池，随机返回其中一个标的池的成分代码。

universe_get_names - 获取全部标的池名称

获取全部已创建标的池名称

函数原型：

DataArray<GmName>* universe_get_names()

返回值：列表

类型	说明
DataArray<GmName>*	标的池名称 列表

注意：

1. 只返回已创建的标的池名称列表。

2. 没有已创建标的池，返回空列表。

universe_delete - 删除标的池

删除一个已创建标的池

函数原型：

int universe_delete(const char *universe_name)

参数：

参数名	类型	中文名称	必填	默认值	参数用法说明
universe_name	str	标的池名称	Y	无	指定要删除的标的池

返回值：0表示成功，否则返回非0值错误码

示例：

universe_delete("龙头1")