根据symbol等信息查询交易标的

接口说明

• 功能说明：根据symbol/markets/instrument_super_type等条件查询交易标的信息。

• 适用对象：通过OpenApi开发平台对接webull的客户。

• 请求URL：/trade/security

• 请求方式：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
shortName	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);

响应示例

异常示例