取消订阅

接口说明

注意

取消订阅接口必须建立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);
}

响应示例

无返回值