跳到主要内容

查询当日订单

接口说明​

  • 功能说明：分页查询当天的所有订单，每次返回的数据条数可以指定，最大值100。

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

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

  • 请求方式：GET

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

请求参数​

参数类型是否必填描述示例值
account_idString是账户id20150320010101001
page_sizeint是每页条数。 默认值:10;最大值:100，可填整数。10
last_client_order_idString否第三方订单ID，不传默认查第一页2022021819071234

响应参数​

参数类型是否必填描述示例值
hasNextBooleantrue是否还有下一页true
orders[ ]Order否订单列表参考示例代码

Order:

字段类型说明
account_idString账户ID
categoryString品类, Category数据字典
currencyString币种, 取值参考字典值：Currency，如：HKD
client_order_idString客户下单传入的ID
extended_hours_tradingBoolean是否支持盘前盘后
filled_priceString平均成交价格
filled_qtyString成交数量
instrument_idString标的ID
last_filled_timeString最后一次成交时间, UTC时间，时间格式：yyyy-MM-ddTHH:mm:ss.SSSZ只有成交的订单才有值
limit_priceString限价, 订单类型如果是限价单、止损限价时，才有值
order_idString订单ID
order_statusString订单状态, OrderStatus数据字典
order_typeString订单类型, OrderType数据字典
place_timeString下单时间, UTC时间，时间格式：yyyy-MM-ddTHH:mm:ss.SSSZ
qtyString数量
sideString买卖方向, OrderSide数据字典
stop_priceString止损价, 订单类型为止损单、止损限价的时候，才有值
symbolString股票代码, 如：01810
short_nameString股票名称, 如：小米集团-W
tifString订单有效期, OrderTIF数据字典
trailing_stop_stepString跟踪差价, 订单类型为跟踪止损单时，才有值
trailing_typeString跟踪类型, TrailingType 订单类型为跟踪止损单时，才有值

请求示例​

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()

响应示例​

{
    "hasNext": false,
    "pageSize": 10,
    "orders": [
        {
            "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": "腾讯控股"
        },
        {
            "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]"
}