Cancel Order

This endpoint allows cancelling an open order for a Futures contract.

Authentication is required.

Endpoint

Request Type Permissible API Keys
/api/v3/cancelorder
POST Read-write, Master
Argument Type Required Description
order_id
UUID No The unique identifier of the order to be cancelled
cliOrdId
UUID No The client unique identifier of the order to be cancelled
Sample Call

https://futures.kraken.com/derivatives/api/v3/cancelorder?cliOrdId=b3106925-65a4-421f-aa9c-c813c219662d

https://futures.kraken.com/derivatives/api/v3/cancelorder?order_id=c18f0c17-9971-40e6-8e5b-10df05d422f0

Sample Return if Successful

{  
    "result":"success",
    "serverTime":"2016-02-25T09:45:53.818Z",
    "cancelStatus":{  
        "receivedTime":"2016-02-25T09:45:53.601Z",
        "status":"cancelled",
        "order_id":"4cb7318d-eb74-405e-8e64-a7d412f100a0",
        "cliOrdId":"b3106925-65a4-421f-aa9c-c813c219662d"

    }
}

{  
    "result":"success",
    "serverTime":"2016-02-25T09:45:54.818Z",
    "cancelStatus":{  
        "receivedTime":"2016-02-25T09:45:54.601Z",
        "status":"cancelled",
        "order_id":"c18f0c17-9971-40e6-8e5b-10df05d422f0"

    }
}

Field

Type Description
result
String Always success
serverTime
ISO8601 datetime The server date and time
cancelStatus
structure  A structure containing information on the cancellation request, see below
receivedTime ISO8601 datetime The date and time the order cancellation was received
status string The status of the order cancellation, either of:
  • cancelled: the order has been cancelled. This may only be part of the order as part may have been filled. Check open_orders websocket feed for status of the order.
  • filled: the order was found completely filled and could not be cancelled
  • notFound: the order was not found, either because it had already been cancelled or it never existed
order_id string The cancelled order id
cliOrdId string The client order id. Shown only if client specified one

 

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 
  • requiredArgumentMissing: a required argument was missing
  • 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