sfc-selected-sk 自选股管理技能
南方金融终端自选股管理技能,支持查询、添加、删除用户自选股及分组管理。
接口一览
| 功能 | 方法 | 接口路径 | 说明 |
|---|---|---|---|
| 查询自选股分组 | GET | /terminal/quotes/user-stock/group/groupWithStocksTree |
查询用户自选股分组及股票列表 |
| 实时行情 | POST | /terminal/quotes/api/quote |
查询股票实时行情 |
| 添加自选股 | POST | /terminal/quotes/user-stock/group/addStocksIntoGroup |
添加股票到指定分组 |
| 删除自选股 | POST | /terminal/quotes/user-stock/group/deleteStocksFromGroup |
从指定分组删除股票 |
| 添加分组 | POST | /terminal/quotes/user-stock/group |
创建新的自选股分组 |
| 删除分组 | DELETE | /terminal/quotes/user-stock/group?ids={id} |
删除指定分组(支持批量) |
调用方式
命令行
# 查看自选股(文本模式)
python call.py
# 查看自选股(JSON 模式)
python call.py --json
# 添加自选股到分组(支持多只股票,逗号分隔)
python call.py add-stocks --group-id 3187 --sec-ids 600719.XSHG,600519.XSHG
# 从分组中删除自选股
python call.py delete-stocks --group-id 3187 --sec-ids 600719.XSHG
# 添加新分组(--group-id auto 自动生成 UUID)
python call.py add-group --group-id auto --group-name "我的分组"
# 删除分组(支持批量,逗号分隔)
python call.py delete-group --ids 696134
函数调用
from call import (
get_user_stock_groups, print_selected_stocks,
add_stocks_to_group, delete_stocks_from_group,
add_group, delete_group
)
# 查询自选股分组
result = get_user_stock_groups()
print_selected_stocks(result)
# 添加自选股
result = add_stocks_to_group(3187, ["600719.XSHG", "600519.XSHG"])
# 删除自选股
result = delete_stocks_from_group(3187, ["600719.XSHG"])
# 添加分组
import uuid
result = add_group(str(uuid.uuid4()), "我的新分组")
# 删除分组
result = delete_group([696134])
参数说明
添加自选股 / 删除自选股
| 参数 | 类型 | 说明 |
|---|---|---|
groupId |
int | 分组 ID(整数,从查询接口获取) |
secIds |
list | 证券代码列表(格式:600719.XSHG) |
请求示例:
{"groupId": 3187, "secIds": ["600719.XSHG"]}
添加分组
| 参数 | 类型 | 说明 |
|---|---|---|
groupId |
string | 分组 UUID(add-group --group-id auto 自动生成) |
groupName |
string | 分组名称 |
请求示例:
{"groupId": "9addfeca-f15e-4e83-96bb-87c5d432efec", "groupName": "我的分组"}
删除分组
| 参数 | 类型 | 说明 |
|---|---|---|
ids |
string | 分组 ID,多个用逗号分隔(URL query 参数) |
请求示例:
DELETE /terminal/quotes/user-stock/group?ids=696134
触发关键词
- "自选股"
- "我的自选"
- "自选"
- "添加自选" / "加自选"
- "删除自选" / "减自选"
- "新建分组" / "添加分组"
- "删除分组"
- "watchlist"
返回格式
成功
{
"ok": true,
"data": {
"code": 0,
"message": "success"
}
}
失败
{
"ok": false,
"error": "code=-403, message=需要登录",
"raw": { ... }
}
文件输出规则
所有本技能生成的文件统一保存到 ~/.openclaw/workspace/nancai/ 目录下。
文件命名规范:selected_{日期}.md
配置说明
Token 配置(优先级从高到低):
1. 环境变量 SFC_TOKEN
2. ~/.openclaw/identity/sfc_token
3. skills/sfc-selected-sk/config.json 中的 api_key
注意事项
- 需要登录:自选股接口需要有效的 Token,否则会返回登录错误
- 代码格式:证券代码需使用完整格式(如
600719.XSHG),不支持自动转换 - 分组 ID:添加分组时使用 UUID 字符串;添加/删除自选股时使用整数 ID
- 行情延迟:实时行情数据可能有秒级延迟
- 批量操作:
--sec-ids和--ids支持逗号分隔批量操作