跳到主要內容

更新自選股分組

更新自選股分組

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