Get Historical Deals

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

Query the historical transaction 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 update time. Timestamp, in microseconds.
end	uint64	Query	No	End time of update time, which should be after start time. Timestamp, in microseconds.
page_flag	string	Query	Yes	Empty string, which means starting from the beginning, otherwise using the page_flag returned by the server.
page_size	uint32	Query	No	Page size. Default is 50. Range: 10-50.

The combination of start and end:

start	end	Description
>0	>0	start and end are the specified dates respectively.
0	>0	start is 90 days before end.
>0	0	end is 90 days after start.
0	0	start is 90 days before, end is the current date.

Response Parameters

Field	Type	Description
order_fills	list[OrderFill]	By default, 50 deals are returned every time, with the latest deal first.
page_flag	string	Page flag for the next request.
completed	bool	True means that all deals have been returned, and client should stop the request for this batch.

Response Example

{
  "s": "ok",
  "d": {
    "order_fills": [
      {
        "trd_side": "BUY",
        "deal_id": "F2024030100000001",
        "order_id": "2024030100000001",
        "code": "US.AAPL",
        "stock_name": "Apple Inc.",
        "qty": "100",
        "price": "180.000",
        "create_time": 1709251210000000,
        "updated_time": 1709251210000000,
        "counter_broker_id": 9999,
        "counter_broker_name": "Goldman Sachs",
        "status": "OK"
      }
    ],
    "page_flag": "",
    "completed": true
  }
}

Error Response:

{
  "s": "error",
  "errcode": -1200,
  "errmsg": "Error message."
}