下单
接口说明
功能说明:该接口供香港地区的客户调用下单,支持下美股、港股、A股(中华通)三个市场的订单。
适用对象:通过OpenApi开发平台对接webull的客户。
请求URL:/trade/order/place
请求方式:POST
频次限制:每个AppId调用频次限制为1秒1次。
请求参数
参数 | 类型 | 是否必填 | 描述 | 示例值 |
---|---|---|---|---|
account_id | String | 是 | 账户id | 20150320010101001 |
stock_order | {}stock_order | 是 | 股票下单参数 | 见示例代码 |
stock_order:
参数 | 类型 | 是否必填 | 描述 | 示例值 |
---|---|---|---|---|
client_order_id | String | 是 | 第三方订单ID,此字段入参长度最长为40 | 2022021819071234 |
side | String | 是 | 买卖方向,参考字典值 OrderSide,支持BUY、SELL | BUY |
tif | String | 是 | 订单有效期,参考字典值OrderTIF,支持 DAY | DAY |
extended_hours_trading | Boolean | 是 | 是否允许盘前盘后交易。 市价单只能是false; 限价单可以是true或者false | false |
instrument_id | String | 是 | 资产标的id,调用者通过调用Get Instruments获取 | 12064446 |
order_type | String | 是 | 订单类型,参考字典值OrderType | MARKET |
limit_price | String | 否 | order_type为 LIMIT、STOP_LOSS_LIMIT、ENHANCED_LIMIT、AT_AUCTION_LIMIT(竞价限价盘)需要传 | 100.49 |
qty | String | 是 | 下单的标的数量,整数,支持的最大值为1000000股 | 100 |
stop_price | String | 否 | order_type为 STOP_LOSS(止损单)、STOP_LOSS_LIMIT(止损限价)时,需要传 | 100.49 |
trailing_type | String | 否 | 跟踪止损单的价差类型,跟踪止损单要传,参考 TrailingType | AMOUNT |
trailing_stop_step | String | 否 | 跟踪止损单的价差数值,跟踪止损单要传 | 100.49 |
响应参数
参数 | 类型 | 描述 | 示例值 |
---|---|---|---|
client_order_id | String | 第三方订单ID | 2022021819071234 |
请求示例
- Python
- Java
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.order.place_order(account_id, qty, instrument_id, side, client_order_id, order_type,
extended_hours_trading, tif, limit_price, stop_price,
trailing_type, trailing_stop_step)
if response.status_code == 200:
order_res = response.json()
HttpApiConfig apiConfig = HttpApiConfig.builder()
.appKey(Env.APP_KEY)
.appSecret(Env.APP_SECRET)
.regionId(Region.hk.name())
.build();
TradeApiService apiService = new TradeHttpApiService(apiConfig);
StockOrder stockOrder = new StockOrder();
stockOrder.setClientOrderId(clientOrderId);
stockOrder.setSide(side);
stockOrder.setTif(tif);
stockOrder.setExtendedHoursTrading(extendedHoursTrading);
stockOrder.setInstrumentId(instrumentId);
stockOrder.setOrderType(orderType);
stockOrder.setLimitPrice(limitPrice);
stockOrder.setQty(qty);
stockOrder.setStopPrice(stopPrice);
stockOrder.setTrailingType(trailingType);
stockOrder.setTrailingStopStep(trailingStopStep);
OrderResponse orderResponse = apiService.placeOrder(accountId, stockOrder);