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);
}

響應示例