取消订阅
目前不支持通过 Webull OpenAPI 请求行情数据,请保持关注。接口说明
注意
取消订阅接口必须建立MQTT长连接后,才能使用。长连接建立可参照行情推送。
功能说明:
实时行情取消订阅接口,根据symbol和数据类型订阅实时行情推送。
取消订阅接口,成功后无返回结果,失败后返回Error。
请求URL:/market-data/streaming/unsubscribe
请求方式:通过Webull SDK建立gRPC长连接,然后调用接口获取。
频次限制:每个App ID调用频次限制为10次每分钟。
请求参数
参数 | 类型 | 必填 | 说明 |
---|---|---|---|
token | String | 是 | 订阅预请求返回的token,且token需要是已经创建过连接的token |
symbols | []String | 否 | 如: [AAPL,TSLA],单次最多支持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
- Java
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.US.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')
try (QuotesApiClient quotesApiClient = QuotesApiClient.builder()
.appKey(Env.APP_KEY)
.appSecret(Env.APP_SECRET)
.regionId(Region.us.name())
.build()) {
quotesApiClient.unsubscribe(token, symbols, category, subTypes);
}
响应示例
无返回值