跳到主要內容

取消訂閱行情數據

該接口用於取消訂閱標的行情數據。

信息

業務指令：7

Request​

Parameters​

NameTypeRequiredDescription
symbolstring[]是訂閱的標的代碼，例如：[700.HK]

校驗規則：
每次請求支持傳入的標的數量上限是 500 個
sub_typeint32[]是訂閱的數據類型，例如：[1,2]，詳見 SubType
unsub_allbool是是否全部取消。
- symbol 為空時，取消所有標的的訂閱。
- symbol 不為空時，取消這些標的的所有類型訂閱。

Protobuf​

message UnsubscribeRequest {
  repeated string symbol = 1;
  repeated SubType sub_type = 2;
  bool unsub_all = 3;
}

Request Example​

# 取消訂閱行情數據
# https://open.longportapp.com/docs/quote/subscribe/unsubscribe
# 訂閱行情數據請檢查“開發者中心“ - “行情權限”是否正確
# https://open.longportapp.com/account
#
# - 港股 - BMP 基礎報價，無實時行情推送，無法用 WebSocket 訂閱
# - 美股 - LV1 納斯達克最優報價 (只限 Open API）
#
# 運行前請訪問“開發者中心“確保賬戶有正確的行情權限。
# 如沒有開通行情權限，可以通過“LongPort”手機客戶端，並進入“我的 - 我的行情 - 行情商城”購買開通行情權限。
from longport.openapi import QuoteContext, Config, SubType
config = Config.from_env()
ctx = QuoteContext(config)

ctx.subscribe(["700.HK", "AAPL.US"], [SubType.Quote])
ctx.unsubscribe(["AAPL.US"], [SubType.Quote])

Response​

Protobuf​

message UnsubscribeResponse{
}

錯誤碼​

協議錯誤碼業務錯誤碼描述排查建議
3301600無效的請求請求參數有誤或解包失敗
3301606限流降低請求頻次
7301602服務端內部錯誤請重試或聯繫技術人員處理
7301600請求參數有誤檢查請求的 sub_type