Fills – Kraken

This endpoint returns information on filled orders for all futures contracts.

Authentication is required.

Endpoint	Request Type	Permissible API Keys
/api/v3/fills	GET	Read-only, Read-write, Master

Argument	Type	Required	Description
lastFillTime	ISO8601 datetime	No	If not provided, returns the last 100 fills in any futures contract. If provided, returns the 100 entries before lastFillTime.

Sample Call

https://futures.kraken.com/derivatives/api/v3/fills?lastFillTime=2020-07-22T13:45:00.000Z

Sample Return if Successful

{
"result":"success",
"fills":[
{
"fill_id":"3d57ed09-fbd6-44f1-8e8b-b10e551c5e73",
"symbol":"pi_xbtusd",
"side":"buy",
"order_id":"693af756-055e-47ef-99d5-bcf4c456ebc5",
"size":5490,
"price":9400,
"fillTime":"2020-07-22T13:37:27.077Z",
"fillType":"maker"
},
{
"fill_id":"56b86ada-73b0-454d-a95a-e29e3e85b349",
"symbol":"pi_xbtusd",
"side":"buy","order_id":"3f513c4c-683d-44ab-a73b-d296abbea201",
"size":5000,
"price":9456,
"fillTime":"2020-07-21T12:41:52.790Z",
"fillType":"taker"
}
],
"serverTime":"2020-07-22T13:44:24.311Z"
}

Field	Type	Description
result	string	Always success
serverTime	ISO8601 datetime	The server date and time
fills	list of structures	A list containing structures with information on filled orders, see below. The list is sorted descending by fillTime.
fillTime	ISO8601 datetime	The date and time the order was filled
order_id	UUID	The unique identifier of the order
fill_id	UUID	The unique identifier of the fill. Note that several fill_id can pertain to one order_id (but not vice versa)
cliOrdId	UUID	The unique client order identifier. This field is returned only if the order has a client order ID
symbol	string	The symbol of the futures the fill occurred in
side	string	The direction of the order, either buy for a buy order or sell for a sell order
size	positive integer	The size of the fill
price	positive float	The price of the fill
fillType	string	The classification of the fill: "maker" if user has a limit order that gets filled, "taker" if the user makes an execution that crosses the spread, "liquidation" if execution is result of a liquidation, "assignee" if execution is a result of a counterparty receiving an Assignment in PAS, "assignor" if execution is a result of user assigning their position due to failed liquidation.

Sample Return if Unsuccessful

{
   "result":"error",
   "serverTime":"2016-02-25T09:45:53.818Z",
"error":"apiLimitExceeded",
}

Field	Type	Description
result	string	Always error
serverTime	ISO8601 datetime	The server date and time
error	string	The reason the API call failed, either of: apiLimitExceeded: the API limit for the calling IP address has been exceeded authenticationError: the request could not be authenticated accountInactive: the Kraken Futures account the request refers to is inactive nonceBelowThreshold: <threshold> the provided nonce is below the <threshold> nonceDuplicate: <duplicate> the provided nonce is a duplicate as it has been used in a previous request

Related articles