根據代碼(symbol)等信息查詢交易標的

接口說明

• 功能說明：根據symbol（代碼）、markets（市場）、instrument_super_type（標的大類）等條件查詢交易標的信息。

• 適用對象：通過OpenApi開發平台對接webull的客戶。

• 請求URL：/trade/instrument

• 請求方式：GET

• 頻次限制：每個AppId調用頻次限制為30秒10次。

請求參數

參數	類型	是否必填	描述	示例值
symbol	String	是	標的代碼	SPX
market	String	是	市場，Markets	HK
instrument_super_type	String	是	標的大類	EQUITY；OPTION
instrument_type	String	否	標的二級分類，查詢期權信息時必傳。	CALL_OPTION-看漲期權；PUT_OPTION-看跌期權
strike_price	String	否	期權行使價，查詢期權信息時必傳。	3400
init_exp_date	String	否	期權到期日，格式:yyyy-MM-dd，查詢期權信息時必傳。	2024-12-20

響應參數

參數	類型	描述	示例值
instrument_id	String	標的id	913256135
symbol	String	標的代碼	AAPL
instrument_super_type	String	標的大類	EQUITY
instrument_type	String	標的類型：STOCK 股票	STOCK
short_name	String	標的縮寫	APPLE INC
buy_unit	String	下單購買最小單位	2000
trade_policy	String	交易策略， TradePolicy數據字典	ALL
margin_ratio	String	融資比例	0
market	String	市場, 取值参考字典值Markets	US
cusip	String	Cusip碼	037833100
exchange_code	String	交易所code，参考：ExchangeCode	NSQ
listStatus	String	上市狀態	LISTING-上市；DELISTING-已退市；OTHER-其他
currency	String	貨幣種類, reference: Currency	HKD
marginable	String	是否可供融資	Y-可融資；N-不可融資
shortable	String	是否可做空	Y-可做空；N-不可做空
fractionalTrading	String	是否支持碎股交易	Y-支持碎股交易；N-不支持碎股交易

請求示例

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.trade_instrument.get_trade_security_detail(symbol, market, instrument_super_type, instrument_type, strike_price, init_exp_date)
if response.status_code == 200:
    trade_instrument_detail = response.json()

Java

HttpApiConfig apiConfig = HttpApiConfig.builder()
        .appKey(Env.APP_KEY)
        .appSecret(Env.APP_SECRET)
        .regionId(Region.hk.name())
        .build();
        TradeApiService apiService = new TradeHttpApiService(apiConfig);
        InstrumentInfo securityInfo = apiService.getSecurityInfo(symbol, market, instrumentSuperType, instrumentType, strikePrice, initExpDate);

響應示例

異常示例