Historical executions – Cryptocurrency Guide - Crypto Facilities

This endpoint returns allows historical executions made on an account.

Note:

This endpoint uses the ‘history’ path instead of ‘derivatives’ and uses the v2 versioning
The maximum amount of records per response is 1000

Authentication is required.

Endpoint	Request Type	Permissible API Keys
/api/history/v2/executions	GET	Read-write, Master

Arguments

Argument	Type	Required	Description
since	integer	Yes	Unix timestamp in millisecond
before	integer	No	Unix timestamp in millisecond, must have since parameter included
sort	string	No	asc for results in ascending order desc for results in descending Default is desc
continuationToken	string <base64>	No	Continuation token provided from a prior response which can be used in call to return the next set of available results

Sample Call

https://www.cryptofacilities.com/api/history/v2/executions?since=1606449104000&before=1604937700000&sort=desc

Sample Return if Successful

{
"accountUid": "e695bf7c-c17c-4f82-80e3-3c577b8b5662",
"len": 0,
"serverTime": "2021-01-24T14:15:22Z",
"elements": [
{
'uid': 'd0e710d9-317f-41fd-8a78-9861ac8a8e05',
'timestamp': 1606449104276,
'event': {
'execution': {
'execution': {
'uid': '07cc67f4-45d6-494b-adac-09b5cbc7e2b5',
'order': {
'uid': '07cc67f4-45d6-494b-adac-09b5cbc7e2b5',
'accountUid': 'e695bf7c-c17c-4f82-80e3-3c577b8b5662',
'tradeable': 'FI_ETHUSD_210326',
'direction': 'Buy',
'quantity': '9700',
'filled': '300',
'timestamp': 1606448073963,
'limitPrice': '535',
'orderType': 'Limit',
'clientId': '',
'reduceOnly': False,
'lastUpdateTimestamp': 1606448073963,
'spotData': None
},
'timestamp': 1606449104276,
quantity': '700',
'price': '535',
'markPrice': '535.20000000000',
'limitFilled': False,
'executionType': 'maker',
'usdValue': '700.00',
'orderData': {

'positionSize': '1000',
'fee': '0.00026168225'
}
},
'takerReducedQuantity': ''
}
}
}
]
}

Field	Type	Description
accountUid	string	UID for the futures account
len	positive integer	Character length of response
serverTime	ISO 8601 datetime	Server time upon request
elements	structure
uid	string	The UID associated with the event
timestamp	positive integer	Unix timestamp in milliseconds
event	structure
execution	structure
execution	structure	Structure containing order and execution data
uid	string	The UID associated with the execution.
order	structure	Structure of order details
accountUid	string	UID for the futures account
tradeable	string	The symbol of the Futures
direction	string	The side associated with the order - buy or sell
quantity	positive float	The quantity (size) associated with the order
filled	positive float	The amount of the order that has been filled prior to the execution
timestamp	positive integer	Unix timestamp in milliseconds
limitPrice	positive float	The limit price associated with a limit order
orderType	string	The order type, one of: Limit Post IoC
clientId	string	The client order id or nothing returned if order does not have one
reduceOnly	boolean	Is the order a reduce only order or not
lastUpdateTimestamp	positive integer	Unix timestamp in milliseconds
spotData	string	Always None
timestamp		Unix timestamp in milliseconds
quantity	positive float	The quantity (size) associated with the execution
price	positive float	Price at which the execution was filled
markPrice	positive float	Mark price at the time of execution
limitFilled	Boolean	If the limit order was filled completely or not
executionType	string	Type of execution: maker or taker
usdValue	positive float	USD value of the execution
orderData	structure
positionSize	float	Size of the position after the execution
fee	positive float	Fee associated with the execution
takerReducedQuantity	positive integer	The amount of quantity that was removed from the order before execution or no value returned if the order is not reduce only.

Articles in this section