查詢標的信息
接口說明
功能說明：根據證券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
- Java
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()
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
- Java
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()
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);
}