# 标的池
标的池功能，通过调用标的池API接口，实现策略标的池和掘金终端界面【交易工具】-【标的池】联动。在不停止策略运行的情况下，在界面导入标的池，策略可调用标的池API获取标的池成分代码；或者策略通过API创建/修改标的池，在终端界面可查看标的池成分的可视化行情。
- 实时模式（仿真交易和实盘交易）标的池应用：在终端【交易工具】-【标的池】进行增删查改操作，策略实时查询指定标的池成分代码进行交易。
- 例1：在多个策略之间传递选股标的池（策略A选股 -> 标的池 -> 策略B择时交易） 第一步（策略A）：调用标的池API创建标的池 第二步（终端界面）：手动实时修改标的池成分股（可选） 第三步（策略B）：调用标的池API获取标的池成分股，根据择时逻辑交易
- 例2：手动选股+策略择时（手动选股 -> 标的池 -> 策略C择时交易） 第一步（终端界面）：创建标的池（手动自选/文件导入/持仓导入/板块导入） 第二步（终端界面）：手动实时修改标的池成分股（可选） 第三步（策略C）：调用标的池API获取标的池成分股，根据择时逻辑交易
- 回测模式标的池应用：先手动选股，通过终端界面【交易工具】-【标的池】导入标的池，策略调用标的池api获取成分代码进行回测。
# universe_set - 设置标的池
创建一个新标的池，或者重置已有标的池成分标的
函数原型：
universe_set(universe_name, universe_symbols=None)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| universe_name | str | 标的池名称 | Y | 无 | 指定标的池名称 |
| universe_symbols | list[str] | 成分标的代码 | N | None | 单个标的示例：['SZSE.000002'],多个标的示例：['SHSE.600008', 'SZSE.000002'] |
返回值：None
示例：
universe_set(universe_name='妖股', universe_symbols=['SZSE.002137', 'SHSE.603421'])
注意：
1. 创建/重置标的池失败会报错。
2. 传入的标的池名称universe_name已存在，会根据universe_symbols重置当前标的池成分。
3. 传入的标的池名称universe_name不存在，会创建一个新标的池。
4. 当universe_symbols为空列表或None时，会创建/重置为成分数量为0的一个空标的池。
5. 若已存在重名标的池，会随机选取其中一个标的池进行重置。
# universe_get_symbols - 获取标的池成分
获取单个标的池的成分标的代码
函数原型：
universe_get_symbols(universe_name)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| universe_name | str | 标的池名称 | Y | 无 | 指定标的池名称 |
返回值：list[str]
| 类型 | 说明 |
|---|---|
| list[str] | 成分标的代码 列表 |
示例：
universe_get_symbols(universe_name='持仓标的')
输出：
['SZSE.300403', 'SZSE.002167', 'SHSE.605098', 'SZSE.002478', 'SZSE.000026', 'SZSE.000065', 'SHSE.601611', 'SZSE.000766', 'SHSE.601988', 'SZSE.300660', 'SZSE.300696', 'SHSE.603319']
注意：
1. 不存在的标的池，返回None。
2. 成分标的数量为0，返回空列表。
3. 若存在重名标的池，随机返回其中一个标的池的成分代码。
# universe_get_names - 获取全部标的池名称
获取全部已创建标的池名称
函数原型：
universe_get_names()
返回值：list[str]
| 类型 | 说明 |
|---|---|
| list[str] | 标的池名称 列表 |
示例：
universe_get_names()
输出：
['持仓标的', '龙头', '龙头1']
注意：
1. 只返回已创建的标的池名称列表。
2. 没有已创建标的池，返回空列表。
# universe_delete - 删除标的池
删除一个已创建标的池
函数原型：
universe_delete(universe_name)
参数：
| 参数名 | 类型 | 中文名称 | 必填 | 默认值 | 参数用法说明 |
|---|---|---|---|---|---|
| universe_name | str | 标的池名称 | Y | 无 | 指定要删除的标的池 |
返回值：None
示例：
universe_delete(universe_name='龙头1')
注意：
1. 删除标的池失败会报错