跳到主要内容

查询标的信息

目前不支持通过 Webull OpenAPI 请求行情数据,请保持关注。

接口说明

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

  • 请求URL:/instrument/list

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

  • 频次限制:每个App ID调用频次限制为60次每分钟。

请求参数

参数类型必传描述
symbolsString证券symbol, 如:AAPL,GOOG,多个用","隔开;单次查询最多支持100个symbol;
categoryString证券类型。 参考:Category,当前只支持US_STOCK、US_ETF。

响应参数

字段类型描述
nameString名称
symbolString证券symbol, 如 AAPL
instrument_idString证券的唯一标识
exchange_codeString交易所code,参考:ExchangeCode
currencyString货币,参考: Currency

请求示例

HTTP

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()

gRPC

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()

响应示例

[
{
"name": "APPLE INC",
"symbol": "AAPL",
"instrument_id": "913256135",
"exchange_code": "NSQ",
"currency": "USD"
}
]