查詢當日訂單

接口說明

• 功能說明：分頁查詢當天的所有訂單，每次返回的數據條數可以指定，最大值100。

• 適用對象：通過OpenApi開發平台對接webull的客戶。

• 請求URL：/trade/orders/list-today

• 請求方式：GET

• 頻次限制：每個AppId調用頻次限制為2秒2次

請求參數

參數	類型	是否必填	描述	示例值
account_id	String	是	賬戶id	20150320010101001
page_size	int	是	每頁條數。 默認值:10;最大值:100，可填整數。	10
last_client_order_id	String	否	第三方訂單ID，不傳默認查第一頁	2022021819071234

響應參數

參數	類型	是否必填	描述	示例值
hasNext	Boolean	true	是否還有下一頁	true
orders	[ ]Order	否	訂單列表	參考示例代碼

Order:

字段	類型	說明
account_id	String	賬戶ID
category	String	品類，Category數據字典
currency	String	幣種，取值參考字典值：Currency，如：HKD
client_order_id	String	客戶下單傳入的ID
extended_hours_trading	Boolean	是否支持盤前盤後
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_id	String	訂單ID
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	股票代碼，如：01810
short_name	String	股票名稱，如：小米集團-W
tif	String	訂單有效期, OrderTIF數據字典
trailing_stop_step	String	跟踪差價，訂單類型為跟踪止損單時，才有值
trailing_type	String	跟踪類型, TrailingType 訂單類型為跟踪止損單時，才有值

請求示例

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.order.list_today_orders(account_id, page_size, last_client_order_id)
if response.status_code == 200:
    today_orders = 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);
Orders dayOrders = apiService.getDayOrders(accountId, pageSize, lastClientOrderId);

響應示例

{

"hasNext":

false

"pageSize":

10

"orders":[

0:{

"account_id":

"ULGALPNJ7QMN0MP38UFM2PMN9A"

"category":

"HK_STOCK"

"currency":

"HKD"

"place_time":

"2022-03-14T01:42:13.000+0000"

"order_id":

"2EJERSV8SCVU53OLSL5B5M24OB"

"instrument_id":

"913256409"

"client_order_id":

"019164611754190"

"side":

"BUY"

"tif":

"DAY"

"order_type":

"AT_AUCTION_LIMIT"

"limit_price":

"385.0000000000"

"qty":

"100.0000000000"

"extended_hours_trading":

false

"order_status":

"FILLED"

"filled_qty":

"100.0000000000"

"filled_price":

"385.0000000000"

"last_filled_time":

"2022-03-14T01:42:16.000+0000"

"symbol":

"00700"

"short_name":

"腾讯控股"

}

1:{

"account_id":

"ULGALPNJ7QMN0MP38UFM2PMN9A"

"category":

"HK_STOCK"

"currency":

"HKD"

"place_time":

"2022-03-14T01:37:30.000+0000"

"order_id":

"M8H68LS2493O1PMVDSUCCS3P19"

"instrument_id":

"913256409"

"client_order_id":

"01916462123512190"

"side":

"BUY"

"tif":

"DAY"

"order_type":

"ENHANCED_LIMIT"

"limit_price":

"385.0000000000"

"qty":

"100.0000000000"

"extended_hours_trading":

false

"order_status":

"FILLED"

"filled_qty":

"100.0000000000"

"filled_price":

"385.0000000000"

"last_filled_time":

"2022-03-14T01:37:31.000+0000"

"symbol":

"00700"

"short_name":

"腾讯控股"

}

]

}

異常示例

{

"error_code":

"INVALID_PARAMETER"

"message":

"page_size range must be [10,100]"

}