查询交易标的

接口说明

• 功能说明：查询交易标的信息。

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

• 请求URL：/trade/instrument

• 请求方式：GET

• 频次限制：每个AppId调用频次限制为30秒10次。

请求参数

参数	类型	是否必填	描述	示例值
instrument_id	String	是	标的id	13467788

响应参数

参数	类型	描述	示例值
instrument_id	String	标的id	913257048
symbol	String	标的代码	00831
instrument_type	String	标的类型： STOCK 股票	STOCK
short_name	String	标的缩写
buy_unit	String	下单购买最小单位	2000
trade_policy	String	交易策略,  TradePolicy数据字典	ALL
margin_ratio	String	融资比例	0

请求示例

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_instrument_detail(instrument_id)
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 instrumentInfo = apiService.getTradeInstrument(instrumentId);

响应示例

{
    "instrument_id": "913256409",
    "symbol": "00700",
    "instrument_type": "STOCK",
    "short_name": "腾讯控股",
    "buy_unit": "100",
    "trade_policy": "ALL",
    "margin_ratio": "0.7500000000"
}

异常示例

{
    "error_code": "SYSTEM_ERROR",
    "message": "Required Integer parameter 'instrument_id' is not present"
}