查詢交易標的

接口說明

• 功能說明：查詢交易標的信息。

• 適用對象：通過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"
}