Historical Order Inquiry (历史订单查询)

该接口用于分页查询指定证券账号的历史订单记录。通过传入证券账号 account_no，支持按股票代码 symbol、订单状态 status、买卖方向 side、市场 market 及时间范围（start_at / end_at）等条件进行筛选，结合分页参数 page 和 size 返回对应的历史订单列表及是否存在更多数据的标识 has_more。返回字段涵盖订单 ID、订单状态、股票名称、委托价格、委托数量、成交价格、成交数量、订单类型、有效期类型、触发状态、结算货币等完整订单信息。

This interface is used to query the historical order records for a specified securities account with pagination support. By providing the account number account_no and optional filter conditions such as stock symbol symbol, order status status, trade direction side, market market, and time range (start_at / end_at), combined with pagination parameters page and size, it returns the matching historical order list and a flag has_more indicating whether more data exists. The returned fields cover complete order information including order ID, order status, stock name, submitted price, submitted quantity, executed price, executed quantity, order type, time-in-force, trigger status, and settlement currency.

Request

Authorization

Query Params

symbol

string

optional

Stock Symbol, in ticker.region format (股票代码，使用 ticker.region 格式)

Example:

AAPL.US

status

enum<string>

optional

Order Status (订单状态)

Allowed values:

NotReportedReplacedNotReportedProtectedNotReportedVarietiesNotReportedFilledStatusWaitToNewNewStatusWaitToReplacePendingReplaceStatusReplacedStatusPartialFilledStatusWaitToCancelPendingCancelStatusRejectedStatusCanceledStatusExpiredStatusPartialWithdrawal

Example:

status=FilledStatus&status=NewStatus

side

enum<string>

optional

Side (买卖方向)

Allowed values:

BuySell

Example:

Buy

market

enum<string>

optional

Market (市场)

Allowed values:

USHKSGSHSZHASOSL

start_at

string

optional

Start Time (开始时间，格式为时间戳 (秒))

Example:

1650410999

end_at

string

optional

End Time (结束时间，格式为时间戳 (秒))

Example:

1650410999

account_no

string

required

Account Number（证券账号）

Example:

L6VQEU00121996

page

string

optional

Page number (分页页码)

size

string

optional

The Number Of Page Size（每页大小）

Responses

🟢200OK

*/*

success

Body

code

integer <int32>

required

Error Code (错误码)

message

string

required

Reponse Data (请求信息)

Example:

success

data

object (Order inquiry response)

required

has_more

boolean

required

More Data (是否还有更多数据)

orders

array [object {26}]

optional

Example

{
  "code": 0,
  "message": "success",
  "data": {
    "has_more": true,
    "orders": [
      {
        "order_id": "string",
        "status": "NotReported",
        "stock_name": "string",
        "quantity": "string",
        "executed_quantity": "string",
        "price": "string",
        "executed_price": "string",
        "submitted_at": "string",
        "side": "Unknow",
        "symbol": "string",
        "order_type": "string",
        "last_done": "string",
        "trigger_price": "string",
        "msg": "string",
        "tag": "Unknown",
        "time_in_force": "string",
        "expire_date": "2023-04-02",
        "updated_at": "string",
        "trigger_at": "string",
        "trailing_amount": "string",
        "trailing_percent": "string",
        "limit_offset": "string",
        "trigger_status": "Unknown",
        "currency": "string",
        "outside_rth": "string",
        "remark": "string"
      }
    ]
  }
}

🟠400Bad Request