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 |
{ |
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:
|