行情快照

接口說明

• 功能說明：

  • 根據證券代碼列表批量查詢證券最新行情快照。

• 請求URL：/market-data/snapshot

• 請求方式：接口提供HTTP和GRPC兩種協議供查詢。

  • HTTP支持A股（中華通）、港股BMP 查詢。

  • GRPC可支持所有行情獲取，只要用戶擁有對應的行情權限。

• 頻次限制：每個AppId調用頻次限制為1次每秒。

請求參數

參數	類型	必填	說明
symbols	String	是	證券代碼列表；例如：單個：00700多個：00700，00981;單次請求最多支持100個symbol；港股 BMP 權限下，單次請求最多支持 20 個symbol
category	String	是	證券類型，枚舉，參考：證券類型，如： HK_STOCK

響應參數

字段	類型	說明
symbol	String	證券代碼
price	String	當前價格
open	String	開盤價，美股為盤中開盤價，不包含盤前盤後數據。當天沒有成交，則無返回值
high	String	今日最高價，美股為盤中最高，不包含盤前盤後數據。當天沒有成交，則無返回值
low	String	今日最低價，美股為盤中最低，不包含盤前盤後數據。當天沒有成交，則無返回值
pre_close	String	昨日收盤價
volume	String	成交量。當天沒有成交，則無返回值
change	String	漲跌額。當天沒有成交，則無返回值
change_ratio	String	漲跌幅。當天沒有成交，則無返回值

請求示例

HTTP

Python

from webullsdktrade.api import API
from webullsdkcore.client import ApiClient
from webullsdkcore.common.region import Region

api_client = ApiClient(your_app_key, your_app_secret, Region.HK.value)
api = API(api_client)
response = api.market_data.get_snapshot(symbols, category)
if response.status_code == 200:
  bars = response.json()

Java

HttpApiConfig apiConfig = HttpApiConfig.builder()
        .appKey(Env.APP_KEY)
        .appSecret(Env.APP_SECRET)
        .regionId(Region.hk.name())
        .build();
try (QuotesApiClient quotesApiClient = new HttpQuotesApiClient(apiConfig)) {
    List<Snapshot> quotes = quotesApiClient.getSnapshots(symbols, category);
}

GRPC

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.get_snapshot(symbols, category)
if response.status_code == 200:
  result = response.json()

Java

try (QuotesApiClient quotesApiClient = QuotesApiClient.builder()
        .appKey(Env.APP_KEY)
        .appSecret(Env.APP_SECRET)
        .regionId(Region.hk.name())
        .build()) {
    List<Snapshot> quotes = quotesApiClient.getSnapshots(symbols, category);
}

響應示例