k线

接口说明

• 功能说明：

  • 返回Instrument的窗口聚合数据。

  • 根据股票代码最近N条k线，支持m1，m5等各个粒度k线；目前日k及以上的只提供前复权的k线，分钟K只提供不复权k线。

• 请求URL：/market-data/bars

• 请求方式：接口提供HTTP和GRPC两种协议供查询。

  • HTTP支持A股（中华通）、港股BMP 查询。

  • GRPC可支持所有行情获取，只要用户拥有对应的行情权限。

• 频次限制：每个AppId调用频次限制为60次每分钟。

请求参数

参数	类型	必填	说明
symbol	String	是	证券代码
category	String	是	证券类型，枚举，参考：证券类型
timespan	String	是	k线时间粒度，参考：k线时间粒度
count	Integer	否	条数，默认200条，最大限制1200条

响应参数

字段	类型	说明
time	String	UTC时间，例如: "2021-12-28T09:00:09.945+0000"
open	String	开盘价
close	String	收盘价
high	String	最高价
low	String	最低价
volume	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_history_bar(symbols, category, timespan)
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<Bar> bars = quotesApiClient.getBars(symbols, category, timespan);
}

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

Java

try (QuotesApiClient quotesApiClient = QuotesApiClient.builder()
        .appKey(Env.APP_KEY)
        .appSecret(Env.APP_SECRET)
        .regionId(Region.hk.name())
        .build()) {
    List<Bar> bars = quotesApiClient.getBars(symbols, category, timespan);
}

响应示例