Get Historical Orders

GET /api/v1.0/accounts/{acc_id}/orders_history

Query the historical order list of the specified trading business account.

Path Parameters

Parameter	Type	Required	Description
acc_id	string	Yes	Trading business account ID.

Request Parameters

Parameter	Type	Position	Required	Description
trd_market	string	Query	Yes	Trading market. See Naming Dictionary
code	string	Query	No	Code filtering. Return the data of the specified code. By default, return all data.
start	uint64	Query	No	Start time of create time. Timestamp, in microseconds.
end	uint64	Query	No	End time of create time, which should be after start time. Timestamp, in microseconds.
page_flag	string	Query	No	Optional on the first request. Omit it (or send an empty string) to start from the beginning; afterwards pass the page_flag returned by the server.
page_size	uint32	Query	No	Page size. Defaults to 50 if omitted; when set, must be 10–100.

The combination of start and end:

start	end	Description
>0	>0	start and end are microsecond timestamps, not calendar dates.
0	>0	start is 90 days before end.
>0	0	end is 90 days after start.
0	0	start is 90 days before the current time, and end is the current time.

Response Parameters

Field	Type	Description
orders	list[order]	Order list
page_flag	string	Page flag for the next request
completed	bool	True means that all orders have been returned, and client should stop the request for this batch.

Response Example

{
  "s": "ok",
  "d": {
    "orders": [
      {
        "side": "BUY",
        "order_type": "LIMIT",
        "order_status": "FILLED_ALL",
        "order_id": "2024030100000001",
        "code": "US.AAPL",
        "exchange": "US",
        "stock_name": "Apple Inc.",
        "security_type": "STOCK",
        "qty": "100",
        "price": "180.000",
        "currency": "USD",
        "create_time": 1709251200000000,
        "updated_time": 1709251210000000,
        "dealt_qty": "100",
        "dealt_avg_price": "180.000",
        "last_err_msg": "",
        "remark": "",
        "time_in_force": "DAY",
        "session": "RTH",
        "aux_price": "0.000",
        "trail_type": "NONE",
        "trail_value": "0.000",
        "trail_spread": "0.000",
        "position_open_type": "",
        "algo_info": null
      }
    ],
    "page_flag": "",
    "completed": true
  }
}