查询标的信息

接口说明

• 功能说明：根据证券symbol列表及证券类型查询标的信息。

• 请求URL：/instrument/list

• 请求方式：接口提供HTTP和gRPC两种协议供查询。HTTP和gRPC接口查询的数据，暂时没有区别。HTTP接口只需要通过普通GET请求即可获取数据，gRPC需要使用Webull SDK进行建立gRPC连接才能使用。

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

请求参数

参数	类型	必传	描述
symbols	String	是	证券symbol， 如：00700,00981，多个用","隔开；单次查询最多支持100个symbol；
category	String	是	证券类型，枚举。 参考：Category

响应参数

字段	类型	描述
name	String	名称
symbol	String	证券symbol， 如 00700
instrument_id	String	证券的唯一标识
exchange_code	String	交易所code，参考：ExchangeCode
currency	String	货币，参考： Currency

请求示例

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.instrument.get_instrument(symbols, category)
if response.status_code == 200:
    instruments = 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<Instrument> instruments = quotesApiClient.getInstruments(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.instrument.get_instrument(symbols, category)
if response.status_code == 200:
    instruments = response.json()

Java

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

响应示例