訂閱

接口說明

注意

訂閱接口必須建立MQTT長連接後，才能使用。長連接建立可參照行情推送。

• 功能說明：

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

  • 每個AppId最多1個推送連接，訂閱topic數限制為100個，一個symbol的一個sub_type為1個topic；

    • 如下參數發起訂閱，則產生4個topic：

      • symbol： AAPL,TSLA

      • sub_types： QUOTE,SNAPSHOT,TICK

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

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

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

請求參數

參數	類型	必填	說明
token	String	是	訂閱預請求返回的token，且token需要是已經創建過連接的token；如：2d29ea02-8a35-11ec-8356-020017000b7b
symbols	[]String	是	證券代碼，例如： [00700,00981]，單次最多50個symbol
category	String	是	證券類型，枚舉，參考：  Category
sub_types	[]String	是	訂閱數據類型，多個用逗號","分隔，枚舉，參考： SubType，如： [SNAPSHOT]

請求示例

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

Java

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

響應示例

無返回值