Get Historical Deals

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

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

Note

Querying historical deals for forex orders is not supported.

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	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 not exceed 50.

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
order_fills	list[order_fill]	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,
        "update_time": 1709251210000000,
        "counter_broker_id": "9999",
        "counter_broker_name": "Goldman Sachs",
        "status": "OK"
      }
    ],
    "page_flag": "",
    "completed": true
  }
}