跳到主要内容

订阅

目前不支持通过 Webull OpenAPI 请求行情数据,请保持关注。

接口说明

注意

订阅接口必须建立MQTT长连接后,才能使用。长连接建立可参照行情推送

  • 功能说明:

    • 实时行情订阅接口, 根据symbol和数据类型订阅实时行情推送。

    • 每个App ID最多1个推送连接, 订阅topic数限制为100个, 一个symbol的一个sub_type为1个topic;

      • 如下参数发起订阅, 则产生6个topic:

        • symbol: AAPL,TSLA

        • sub_types: QUOTE,SNAPSHOT,TICK

  • 请求URL:/market-data/streaming/subscribe

  • 请求方式:通过Webull SDK建立gRPC长连接,然后调用接口获取。

  • 频次限制:每个App ID调用频次限制为10次每分钟。

请求参数

参数类型必填说明
tokenString订阅预请求返回的token,且token需要是已经创建过连接的token;如:2d29ea02-8a35-11ec-8356-020017000b7b
symbols[]String证券代码,例如: [AAPL,TSLA],单次最多50个symbol
categoryString证券类型,枚举,参考:  证券类型
sub_types[]String订阅数据类型,多个用逗号","分隔,枚举,参考: 订阅数据类型,如: [SNAPSHOT]

请求示例

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.create_subscription_rel(token, symbols, category, sub_types)
if response.status_code == 200:
print('subscribe successful')

响应示例

无返回值