> ## Documentation Index > Fetch the complete documentation index at: https://docs.kraken.com/llms.txt > Use this file to discover all available pages before exploring further. # Cancel order > This endpoint allows cancelling an open order for a Futures contract. ## OpenAPI ````yaml /openapi/futures-rest.yaml post /cancelorder openapi: 3.1.0 info: title: Kraken Futures Trading API version: v3 description: Market data and order management endpoints. servers: - url: https://futures.kraken.com/derivatives/api/v3 description: Kraken Futures security: [] tags: - name: Market Data - name: Instrument Details description: >- - The `/instruments/status` endpoint provides a list of statuses for all instruments. - The `/instruments/{symbol}/status` endpoint provides the status of a single instrument. - name: Order Management - name: Multi-Collateral description: Endpoints pertaining to the multi-collateral (MC) futures markets. - name: Account Information - name: Assignment Program - name: Fee Schedules description: >- **DEPRECATED** — Effective 2026-06-22, the fee values returned by these endpoints no longer reflect the fees actually charged on Futures trades. Futures fee calculation has been migrated to a centralised Kraken fee service. To determine the fee rate applied to your trades, use the Spot [`GetTradeVolume`](https://docs.kraken.com/api/docs/rest-api/get-trade-volume) endpoint authenticated with a Spot API key. - name: General - name: Historical Data - name: Historical Funding Rates - name: Trading Settings - name: Subaccounts - name: Transfers - name: RFQs paths: /cancelorder: post: tags: - Order Management summary: Cancel order description: This endpoint allows cancelling an open order for a Futures contract. operationId: cancelOrder parameters: - $ref: '#/components/parameters/ProcessBefore' - name: order_id in: query schema: type: string description: The unique identifier of the order to be cancelled. description: The unique identifier of the order to be cancelled. - name: cliOrdId in: query schema: type: string description: The client unique identifier of the order to be cancelled. description: The client unique identifier of the order to be cancelled. responses: '200': description: '' content: application/json: schema: oneOf: - title: Success Response allOf: - type: object properties: cancelStatus: $ref: '#/components/schemas/CancelOrderStatusJson' description: >- A structure containing information on the cancellation request. required: - cancelStatus - $ref: '#/components/schemas/SuccessResponse' - $ref: '#/components/schemas/ErrorResponse' examples: success: $ref: '#/components/examples/CancelOrderExample' security: - general-api-key: [] authent: [] components: parameters: ProcessBefore: description: >- The time before which the request should be processed, otherwise it is rejected. name: processBefore in: query required: false schema: type: string format: date-time example: '2023-11-08T19:56:35.441899Z' schemas: CancelOrderStatusJson: type: object properties: cliOrdId: type: string description: The client order ID. Shown only if client specified one. nullable: true orderEvents: type: array items: $ref: '#/components/schemas/OrderEvent' order_id: type: string format: uuid description: The cancelled order UID receivedTime: type: string description: The date and time the order cancellation was received. status: type: string enum: - cancelled - filled - notFound description: >- The status of the order cancellation: - `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 required: - status SuccessResponse: title: Success Response allOf: - $ref: '#/components/schemas/ResultSuccess' - $ref: '#/components/schemas/ServerTime' ErrorResponse: allOf: - title: Errors type: object properties: errors: type: array items: $ref: '#/components/schemas/Error' error: $ref: '#/components/schemas/Error' required: - error - $ref: '#/components/schemas/ResultError' - $ref: '#/components/schemas/ServerTime' OrderEvent: oneOf: - $ref: '#/components/schemas/PlaceEvent' - $ref: '#/components/schemas/CancelEvent' - $ref: '#/components/schemas/EditEvent' - $ref: '#/components/schemas/RejectEvent' - $ref: '#/components/schemas/ExecuteEvent' - $ref: '#/components/schemas/PlaceTriggerEvent' - $ref: '#/components/schemas/CancelTriggerEvent' - $ref: '#/components/schemas/RejectTriggerEvent' ResultSuccess: type: object properties: result: type: string enum: - success example: success required: - result ServerTime: type: object properties: serverTime: description: Server time in Coordinated Universal Time (UTC) type: string format: date-time example: '2020-08-27T17:03:33.196Z' required: - serverTime Error: type: string description: |- Error description. - `accountInactive`: The Futures account the request refers to is inactive - `apiLimitExceeded`: The API limit for the calling IP address has been exceeded - `authenticationError`: The request could not be authenticated - `insufficientFunds`: The amount requested for transfer is below the amount of funds available - `invalidAccount`: The Futures account the transfer request refers to is invalid - `invalidAmount`: The amount the transfer request refers to is invalid - `invalidArgument`: One or more arguments provided are invalid - `invalidUnit`: The unit the transfer request refers to is invalid - `Json Parse Error`: The request failed to pass valid JSON as an argument - `marketUnavailable`: The market is currently unavailable - `nonceBelowThreshold`: The provided nonce is below the threshold - `nonceDuplicate`: The provided nonce is a duplicate as it has been used in a previous request - `notFound`: The requested information could not be found - `requiredArgumentMissing`: One or more required arguments are missing - `Server Error`: There was an error processing the request - `Unavailable`: The endpoint being called is unavailable - `unknownError`: An unknown error has occurred enum: - accountInactive - apiLimitExceeded - authenticationError - insufficientFunds - invalidAccount - invalidAmount - invalidArgument - invalidUnit - Json Parse Error - marketUnavailable - nonceBelowThreshold - nonceDuplicate - notFound - requiredArgumentMissing - Server Error - Unavailable - unknownError ResultError: type: object properties: result: type: string enum: - error example: error required: - result PlaceEvent: title: PlaceEvent type: object properties: type: description: Always `PLACE`. type: string enum: - PLACE order: $ref: '#/components/schemas/OrderJson' description: The placed order. reducedQuantity: type: number description: >- The amount of quantity that was removed before placement or null if the order is not a reduce only. nullable: true required: - type - order - reducedQuantity CancelEvent: title: CancelEvent type: object properties: type: description: Always `CANCEL`. type: string enum: - CANCEL uid: type: string description: The UID associated with the order. order: nullable: true allOf: - $ref: '#/components/schemas/OrderJson' description: The cancelled order. required: - type - uid - order EditEvent: title: EditEvent type: object properties: type: description: Always `EDIT`. type: string enum: - EDIT old: $ref: '#/components/schemas/OrderJson' description: The order before the edit was applied. new: $ref: '#/components/schemas/OrderJson' description: The order after the edit was applied. reducedQuantity: type: number description: >- The amount of quantity that was removed from the edited order or null if the order is not a reduce only. nullable: true required: - type - old - new - reducedQuantity RejectEvent: title: RejectEvent type: object properties: type: description: Always `REJECT`. type: string enum: - REJECT uid: type: string description: The UID associated with the order. order: nullable: true allOf: - $ref: '#/components/schemas/OrderJson' description: The rejected order. reason: type: string enum: - POST_WOULD_EXECUTE - IOC_WOULD_NOT_EXECUTE description: >- The rejection reason: - `POST_WOULD_EXECUTE` - The post-only order would be filled upon placement, thus is cancelled. - `IOC_WOULD_NOT_EXECUTE` - The immediate-or-cancel order would not execute. x-codeReference: OrderError.toApiString() required: - type - uid - order - reason ExecuteEvent: title: ExecuteEvent type: object properties: type: description: Always `EXECUTION`. type: string enum: - EXECUTION executionId: type: string format: uuid description: The UID associated with the execution. price: type: number description: The price of the execution. amount: type: number description: The executed amount. orderPriorEdit: nullable: true allOf: - $ref: '#/components/schemas/OrderJson' description: >- The order before the edit was applied (if the execution is a result of an order edit). orderPriorExecution: $ref: '#/components/schemas/OrderJson' description: The order before it executes. takerReducedQuantity: type: number description: >- The amount of quantity that was removed from the order before execution or null if the order is not a reduce only. nullable: true required: - type - executionId - price - amount - orderPriorEdit - orderPriorExecution - takerReducedQuantity PlaceTriggerEvent: title: PlaceTriggerEvent type: object properties: type: description: Always `PLACE`. type: string enum: - PLACE orderTrigger: $ref: '#/components/schemas/OrderTriggerJson' required: - type - orderTrigger CancelTriggerEvent: title: CancelTriggerEvent type: object properties: type: description: Always `CANCEL`. type: string enum: - CANCEL uid: type: string orderTrigger: nullable: true allOf: - $ref: '#/components/schemas/OrderTriggerJson' required: - type - uid - orderTrigger RejectTriggerEvent: title: RejectTriggerEvent type: object properties: type: description: Always `REJECT`. type: string enum: - REJECT uid: type: string orderTrigger: nullable: true allOf: - $ref: '#/components/schemas/OrderTriggerJson' reason: $ref: '#/components/schemas/OrderError' required: - type - uid - orderTrigger - reason OrderJson: type: object properties: orderId: type: string description: The UID associated with the order. cliOrdId: type: string description: The client order id or null if order does not have one. nullable: true type: type: string enum: - lmt - ioc - post - liquidation - assignment - stp - unwind - block - fok description: The order type symbol: type: string description: The symbol of the Futures. side: type: string enum: - buy - sell description: The side associated with the order quantity: type: number description: The quantity (size) associated with the order. filled: type: number description: The total amount of the order that has been filled. limitPrice: type: number description: The limit price associated with a limit order. reduceOnly: type: boolean description: Is the order a reduce only order or not. timestamp: type: string description: The date and time the order was placed. lastUpdateTimestamp: type: string description: The date and time the order was edited. required: - orderId - cliOrdId - type - symbol - side - quantity - filled - limitPrice - reduceOnly - timestamp - lastUpdateTimestamp OrderTriggerJson: type: object properties: uid: type: string description: The UID associated with the order. clientId: type: string description: The client order id or null if order does not have one. nullable: true type: type: string enum: - lmt - ioc - post - liquidation - assignment - stp - unwind - fok description: The order type symbol: type: string description: The symbol of the Futures. side: type: string enum: - buy - sell - unknown description: >- The side associated with the order `unknown` is returned when the source value couldn't be decoded; this will be replaced with a real value as soon as possible. quantity: type: number description: The quantity (size) associated with the order. nullable: true limitPrice: type: number description: The limit price associated with a limit order. nullable: true triggerPrice: type: number nullable: true triggerSide: type: string enum: - trigger_above - trigger_below - unknown description: >- `unknown` is returned when the source value couldn't be decoded; this will be replaced with a real value as soon as possible. nullable: true triggerSignal: type: string enum: - mark_price - last_price - spot_price - unknown description: >- `unknown` is returned when the source value couldn't be decoded; this will be replaced with a real value as soon as possible. nullable: true reduceOnly: type: boolean description: Is the order a reduce only order or not. timestamp: type: string description: The date and time the order was placed. lastUpdateTimestamp: type: string description: The date and time the order was edited. startTime: type: string nullable: true required: - uid - clientId - type - symbol - side - quantity - limitPrice - triggerPrice - triggerSide - triggerSignal - reduceOnly - timestamp - lastUpdateTimestamp OrderError: type: string enum: - MARKET_SUSPENDED - MARKET_NOT_FOUND - INVALID_PRICE - INVALID_QUANTITY - SMALL_ORDER_LIMIT_EXCEEDED - INSUFFICIENT_MARGIN - WOULD_CAUSE_LIQUIDATION - CLIENT_ORDER_ID_IN_USE - CLIENT_ORDER_ID_TOO_LONG - MAX_POSITION_EXCEEDED - PRICE_COLLAR - PRICE_DISLOCATION - EDIT_HAS_NO_EFFECT - ORDER_FOR_CANCELLATION_NOT_FOUND - ORDER_FOR_EDIT_NOT_FOUND - ORDER_CANNOT_HAVE_TRIGGER_PRICE - POST_WOULD_EXECUTE - IOC_WOULD_NOT_EXECUTE - WOULD_EXECUTE_SELF - WOULD_NOT_REDUCE_POSITION - REJECTED_AFTER_EXECUTION - MARKET_IS_POST_ONLY - ORDER_LIMIT_EXCEEDED - FIXED_LEVERAGE_TOO_HIGH - CANNOT_EDIT_TRIGGER_PRICE_OF_TRAILING_STOP - CANNOT_EDIT_LIMIT_PRICE_OF_TRAILING_STOP - TRAILING_STOP_ORDER_LIMIT_EXCEEDED - TRAILING_STOP_PERCENT_DEVIATION_EXCEEDS_MAX_DECIMAL_PLACES - TRAILING_STOP_QUOTE_DEVIATION_NOT_MULTIPLE_OF_TICK_SIZE - TRAILING_STOP_MAX_DEVIATION_TOO_LARGE - TRAILING_STOP_MAX_DEVIATION_TOO_SMALL - INSUFFICIENT_HEADROOM_AROUND_CURRENT_PRICE_TO_EDIT_TRAILING_STOP - >- NO_REFERENCE_PRICE_AVAILABLE_FOR_CALCULATING_TRAILING_STOP_TRIGGER_PRICE - INSUFFICIENT_CLOSING_MARGIN - LIMIT_PRICE_SET_AS_ABSOLUTE_AND_RELATIVE - LIMIT_PRICE_OFFSET_VALUE_INVALID - LIMIT_PRICE_OFFSET_UNIT_INVALID - LIMIT_PRICE_OFFSET_MUST_HAVE_VALUE_AND_UNIT - LIMIT_PRICE_OFFSET_QUOTE_CURRENCY_VALUE_MUST_BE_MULTIPLE_OF_TICK_SIZE - LIMIT_PRICE_OFFSET_PERCENT_VALUE_TOO_MANY_DECIMAL_PLACES - LIMIT_PRICE_OFFSET_TOO_HIGH - LIMIT_PRICE_OFFSET_TOO_LOW examples: CancelOrderExample: value: result: success cancelStatus: status: cancelled order_id: cb4e34f6-4eb3-4d4b-9724-4c3035b99d47 receivedTime: '2020-07-22T13:26:20.806Z' orderEvents: - type: CANCEL uid: cb4e34f6-4eb3-4d4b-9724-4c3035b99d47 order: orderId: cb4e34f6-4eb3-4d4b-9724-4c3035b99d47 cliOrdId: '1234568' type: lmt symbol: PF_XBTUSD side: buy quantity: 5500 filled: 0 limitPrice: 8000 reduceOnly: false timestamp: '2020-07-22T13:25:56.366Z' lastUpdateTimestamp: '2020-07-22T13:25:56.366Z' serverTime: '2020-07-22T13:26:20.806Z' securitySchemes: general-api-key: type: apiKey description: General API key with **full** access in: header name: APIKey x-inlineDescription: true authent: type: apiKey description: Authentication string in: header name: Authent x-inlineDescription: true ````