查询订单明细

接口说明

• 功能说明：查询订单详情。

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

• 请求URL：/trade/order/detail

• 请求方式：GET

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

请求参数

参数	类型	是否必填	描述	示例值
account_id	String	是	账户id	20150320010101001
client_order_id	String	是	第三方订单ID	2022021819071234

响应参数

Order:

字段	类型	说明
account_id	String	账户ID
combo_type	String	组合订单类型
combo_ticker_type	String	组合订单标的类型
client_order_id	String	客户下单传入的ID
extended_hours_trading	Boolean	是否支持盘前盘后
order_id	String	订单ID
tif	String	订单有效期, OrderTIF数据字典
items	Item[]	订单项

Item:

字段	类型	说明
category	String	品类, Category数据字典
currency	String	币种, 取值参考字典值：Currency，如：USD
filled_price	String	平均成交价格
filled_qty	String	成交数量
instrument_id	String	标的ID
last_filled_time	String	最后一次成交时间, UTC时间，时间格式：yyyy-MM-ddTHH:mm:ss.SSSZ只有成交的订单才有值
limit_price	String	限价, 订单类型如果是限价单、止损限价时，才有值
order_status	String	订单状态, OrderStatus数据字典
order_type	String	订单类型, OrderType数据字典
place_time	String	下单时间, UTC时间，时间格式：yyyy-MM-ddTHH:mm:ss.SSSZ
qty	String	数量
side	String	买卖方向, OrderSide数据字典
stop_price	String	止损价, 订单类型为止损单、止损限价的时候，才有值
symbol	String	股票代码, 如：AAPL
trailing_stop_step	String	跟踪差价, 订单类型为跟踪止损单时，才有值
trailing_type	String	跟踪类型,  订单类型为跟踪止损单时，才有值

请求示例

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.US.value)
api = API(api_client)
response = api.order.query_order_detail(account_id,client_order_id)
if response.status_code == 200:
    order_detail = response.json()

Java

HttpApiConfig apiConfig = HttpApiConfig.builder()
        .appKey(Env.APP_KEY)
        .appSecret(Env.APP_SECRET)
        .regionId(Region.us.name())
        .build();
TradeApiService apiService = new TradeHttpApiService(apiConfig);
ComboOrder orderDetail = apiService.getOrderDetails(accountId, clientOrderId);

响应示例

{
  "items": [
    {
      "symbol": "AAPL",
      "category": "US_STOCK",
      "filled_price": "10.00",
      "filled_qty": "100",
      "last_filled_time": "2022-12-19 11:29:49.057+0000",
      "order_status": "FILLED",
      "order_type": "MARKET",
      "place_time": "2022-12-19 11:29:48.672+0000",
      "qty": "100",
      "side": "BUY",
      "instrument_id": "913256135",
      "currency": "USD"
    }
  ],
  "combo_ticker_type": "STOCK",
  "client_order_id": "APG63S4F36TM94T4SRQ3K7IE7B",
  "order_id": "658520233254322176",
  "extended_hours_trading": false,
  "tif": "DAY",
  "account_id": "6TGIBSMG28Q35OVA465T99VHPB"
}

异常示例

{
    "error_code": "SYSTEM_ERROR",
    "message": "status 500 reading IOpenApiServiceFacade#getOrder(OpenApiOrderQueryParam)"
}