查询标的信息
目前不支持通过 Webull OpenAPI 请求行情数据,请保持关注。接口说明
功能说明:根据证券symbol列表及证券类型查询标的信息。
请求URL:/instrument/list
请求方式:接口提供HTTP和gRPC两种协议供查询。HTTP和gRPC接口查询的数据,暂时没有区别。HTTP接口只需要通过普通GET请求即可获取数据,gRPC需要使用Webull SDK进行建立gRPC连接才能使用。
频次限制:每个App ID调用频次限制为60次每分钟。
请求参数
参数 | 类型 | 必传 | 描述 |
---|---|---|---|
symbols | String | 是 | 证券symbol, 如:AAPL,GOOG,多个用","隔开;单次查询最多支持100个symbol; |
category | String | 是 | 证券类型。 参考:Category,当前只支持US_STOCK、US_ETF。 |
响应参数
字段 | 类型 | 描述 |
---|---|---|
name | String | 名称 |
symbol | String | 证券symbol, 如 AAPL |
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.US.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.us.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.US.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.us.name())
.build()) {
List<Instrument> instruments = quotesApiClient.getInstruments(symbols, category);
}
响应示例
[
{
"name": "APPLE INC",
"symbol": "AAPL",
"instrument_id": "913256135",
"exchange_code": "NSQ",
"currency": "USD"
}
]