Fills

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=2016
-02-26T00:00:00.000Z

Sample Return if Successful

{  
   "result":"success",
   "serverTime":"2016-02-25T09:45:53.818Z",
   "fills":[  
      {  
         "fillTime":"2016-02-25T09:47:01.000Z",
         "order_id":"c18f0c17-9971-40e6-8e5b-10df05d422f0",
         "fill_id":"522d4e08-96e7-4b44-9694-bfaea8fe215e",
         "cliOrdId":"d427f920-ec55-4c18-ba95-5fe241513b30",
         "symbol":"fi_xbtusd_180615",

         "side":"buy",
         "size":2000,
         "price":4255,
         "fillType":"maker"

      },
      {  
         "fillTime":"2016-02-25T09:47:01.000Z",
         "order_id":"c18f0c17-9971-40e6-8e5b-10df05d422f0",
         "fill_id":"865cc3d0-12ee-4ac5-8418-233ea40e6b39",
         "symbol":"fi_xbtusd_180615",
         "side":"buy",
         "size":3000,
         "price":4255,
         "fillType":"taker"

      }, ...,
   ]
}

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 Crypto Facilities 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