跳到主要內容

更新自选股分组

更新自选股分组

Request

HTTP MethodPUT
HTTP URL/v1/watchlist/groups

Parameters

Content-Type: application/json; charset=utf-8

NameTypeRequiredDescription
idintegerYES分组 ID,例如 10086
namestringNO分组名称,例如 信息产业组
如果不传递此参数,则分组名称不会更新
securitiesstring[]NO股票列表,例如 ["BABA.US","AAPL.US"]
配合下面的 mode 参数,可完成添加股票、移除股票、对关注列表进行排序等操作
modestringNO操作方法
可选值:
add - 添加
remove - 移除
replace - 替换

add 时,将上面列表中的股票依序添加到此分组中

remove 时,将上面列表中的股票从此分组中移除

replace 时,将上面列表中的股票全量覆盖此分组下的股票
假如原来分组中的股票为 APPL.US, BABA.US, TSLA.US,使用 ["BABA.US","AAPL.US","MSFT.US"] 更新后变为 ["BABA.US","AAPL.US","MSFT.US"], 对比之前,移除了 TSLA.US,添加了 MSFT.USBABA.US,AAPL.US 调整了顺序

Request Example

from longport.openapi import QuoteContext, Config, SecuritiesUpdateMode

config = Config.from_env()
ctx = QuoteContext(config)
ctx.update_watchlist_group(10086, name = "WatchList2", securities = ["700.HK", "AAPL.US"], SecuritiesUpdateMode.Replace)

Response

Response Headers

  • Content-Type: application/json

Response Example

{
"code": 0
}

Response Status

StatusDescriptionSchema
200返回成功None
500内部错误None