取消訂閱

接口說明

注意

取消訂閱必须建立MQTT长连接后，才能使用。长连接建立可参照行情推送。

• 功能說明：

  • 實時行情取消訂閱接口，根據symbol和數據類型訂閱實時行情推送。

  • 取消訂閱接口，成功後無返回結果，失敗後返回Error。

• 請求URL：/market-data/streaming/unsubscribe

• 請求方式：通過Webull SDK建立gRPC長連接，然後調用接口獲取。

• 頻次限制：每個AppId調用頻次限制為10次每分鐘。

請求參數

參數	類型	必填	說明
token	String	是	訂閱預請求返回的token，且token需要是已經創建過連接的token；
symbols	[]String	否	如: [00700,00981]，單次最多支持50個symbol
category	String	否	證券類型，枚舉，參考： Category,當unsubscribe_all為空或不為true時必填。
sub_types	String	否	取消訂閱數據類型，如：[SNAPSHOT]、SubType當unsubscribe_all為空或不為true時必填。
unsubscribe_all	Boolean	否	boolean false (true表示取消所有實時行情訂閱；當unsubscribe_all為true時，symbols，category，sub_types可以為空)

請求示例

Python

from webullsdktrade.grpc_api import API
from webullsdkquotescore.grpc.grpc_client import GrpcApiClient
from webullsdkcore.common.region import Region

grpc_client = GrpcApiClient(your_app_key, your_app_secret, Region.HK.value)
api = API(grpc_client)
response = api.market_data.remove_subscription_rel(token, symbols, category, sub_types)
if response.status_code == 200:
    print('unsubscribe successful')

Java

try (QuotesApiClient quotesApiClient = QuotesApiClient.builder()
        .appKey(Env.APP_KEY)
        .appSecret(Env.APP_SECRET)
        .regionId(Region.hk.name())
        .build()) {
    quotesApiClient.unsubscribe(token, symbols, category, subTypes);
}

響應示例

無返回值