行情快照

接口说明

• 功能说明：

  • 根据证券代码列表批量查询证券最新行情快照。

• 请求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);
}

响应示例