> ## 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. # Batch order management > This endpoint allows sending limit or stop order(s) and/or cancelling open order(s) and/or editing open order(s) for a currently listed Futures contract in batch. When editing an order, if the `trailingStopMaxDeviation` and `trailingStopDeviationUnit` parameters are sent unchanged, the system will recalculate a new stop price upon successful order modification. ## OpenAPI ````yaml /openapi/futures-rest.yaml post /batchorder 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: /batchorder: post: tags: - Order Management summary: Batch order management description: >- This endpoint allows sending limit or stop order(s) and/or cancelling open order(s) and/or editing open order(s) for a currently listed Futures contract in batch. When editing an order, if the `trailingStopMaxDeviation` and `trailingStopDeviationUnit` parameters are sent unchanged, the system will recalculate a new stop price upon successful order modification. operationId: sendBatchOrder parameters: [] requestBody: required: true content: application/x-www-form-urlencoded: schema: type: object properties: ProcessBefore: $ref: '#/components/parameters/ProcessBefore' json: title: Batch Order type: object additionalProperties: false required: - batchOrder properties: batchOrder: type: array items: discriminator: propertyName: order mapping: send: $ref: '#/components/schemas/BatchOrderSend' edit: $ref: '#/components/schemas/BatchOrderEdit' cancel: $ref: '#/components/schemas/BatchOrderCancel' oneOf: - $ref: '#/components/schemas/BatchOrderSend' - $ref: '#/components/schemas/BatchOrderEdit' - $ref: '#/components/schemas/BatchOrderCancel' description: >- A list containing structures of order sending and order cancellation instructions. The list is in no particular order. examples: - batchOrder: - order: send order_tag: '1' orderType: lmt symbol: PF_XBTUSD side: buy size: 1 limitPrice: 1 cliOrdId: my_another_client_id - order: send order_tag: '2' orderType: stp symbol: PF_XBTUSD side: buy size: 1 limitPrice: 2 stopPrice: 3 - order: cancel order_id: e35d61dd-8a30-4d5f-a574-b5593ef0c050 - order: cancel cliOrdId: my_client_id description: This parameter is required to be encoded as a JSON string. required: - json responses: '200': description: '' content: application/json: schema: oneOf: - title: Success Response allOf: - type: object required: - batchStatus properties: batchStatus: type: array items: $ref: '#/components/schemas/BatchInstructionResult' description: >- A structure containing information on the send order request. - $ref: '#/components/schemas/SuccessResponse' - $ref: '#/components/schemas/ErrorResponse' examples: success: $ref: '#/components/examples/BatchOrderExample' 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: BatchOrderSend: title: BatchOrderSend type: object required: - symbol - order_tag - side - size - orderType properties: order: type: string description: Always `send`. enum: - send order_tag: type: string description: >- An arbitrary string provided client-side to tag the order for the purpose of mapping order sending instructions to the API's response. orderType: $ref: '#/components/schemas/OrderType' symbol: type: string description: The symbol of the Futures. side: $ref: '#/components/schemas/OrderDirection' size: type: number description: The size associated with the order. limitPrice: type: number description: >- The limit price associated with the order. If placing a `trailing_stop` order then leave undefined. stopPrice: type: number description: >- The stop price associated with a stop order. Required if `orderType` is `stp`. Note that for `stp` orders, `limitPrice` is also required and denotes the worst price at which the `stp` order can get filled cliOrdId: type: string description: >- The order identity that is specified from the user. It must be globally unique. maxLength: 100 triggerSignal: type: string enum: - mark - index - last - 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. reduceOnly: type: boolean description: >- Set as 'true' if you wish the order to only reduce an existing position. Any order which increases an existing position will be rejected. Default 'false'. default: false trailingStopMaxDeviation: type: number description: >- Required if the order type is `trailing_stop`. Is the maximum distance the trailing stop's trigger price may trail behind the requested trigger signal. It defines the threshold at which the trigger price updates. trailingStopDeviationUnit: type: string enum: - PERCENT - QUOTE_CURRENCY - unknown description: >- Required if the order type is `trailing_stop`. This defines how the trailing trigger price is calculated from the requested trigger signal. For example, if the max deviation is set to 10, the unit is 'PERCENT', and the underlying order is a sell, then the trigger price will never be more then 10% below the trigger signal. Similarly, if the deviation is 100, the unit is 'QUOTE_CURRENCY', the underlying order is a sell, and the contract is quoted in USD, then the trigger price will never be more than $100 below the trigger signal. `unknown` is returned when the source value couldn't be decoded; this will be replaced with a real value as soon as possible. example: order: send order_tag: '1' orderType: lmt symbol: PF_XBTUSD side: buy size: 1 limitPrice: 1 cliOrdId: my_another_client_id BatchOrderEdit: title: BatchOrderEdit allOf: - $ref: '#/components/schemas/OrderIdElement' - type: object properties: order: type: string description: Always `edit`. enum: - edit size: type: number description: The size associated with the order. limitPrice: type: number description: The limit price associated with the order. stopPrice: type: number description: >- The stop price associated with a stop order. Required if old orderType is stp. Note that for `stp` orders, `limitPrice` is also required and denotes the worst price at which the stp order can get filled. trailingStopMaxDeviation: type: number description: >- Only relevant for trailing stop orders. Maximum value of 50%, minimum value of 0.1% for 'PERCENT' 'maxDeviationUnit'. Is the maximum distance the trailing stop's trigger price may trail behind the requested trigger signal. It defines the threshold at which the trigger price updates. minimum: 0.1 maximum: 50 trailingStopDeviationUnit: type: string enum: - PERCENT - QUOTE_CURRENCY - unknown description: >- Only relevant for trailing stop orders. This defines how the trailing trigger price is calculated from the requested trigger signal. For example, if the max deviation is set to 10, the unit is 'PERCENT', and the underlying order is a sell, then the trigger price will never be more then 10% below the trigger signal. Similarly, if the deviation is 100, the unit is 'QUOTE_CURRENCY', the underlying order is a sell, and the contract is quoted in USD, then the trigger price will never be more than $100 below the trigger signal. `unknown` is returned when the source value couldn't be decoded; this will be replaced with a real value as soon as possible. qtyMode: type: string enum: - ABSOLUTE - RELATIVE description: >- Determines how the updated size is interpreted, defaulting to 'RELATIVE'. 'ABSOLUTE' means that the total order size, including past fills, is set to `size`. 'RELATIVE' means that the current open order size is set to `size`. BatchOrderCancel: title: BatchOrderCancel example: order: cancel order_id: e35d61dd-8a30-4d5f-a574-b5593ef0c050 allOf: - type: object properties: order: description: Always `cancel`. type: string enum: - cancel required: - order - $ref: '#/components/schemas/CancelInstruction' BatchInstructionResult: title: BatchInstructionResult type: object properties: cliOrdId: type: string description: >- The unique client order identifier. This field is returned only if the order has a client order ID. dateTimeReceived: type: string description: The date and time the order was received. nullable: true orderEvents: type: array items: $ref: '#/components/schemas/OrderEvent' order_id: type: string description: The unique identifier of the order. nullable: true order_tag: type: string description: >- The arbitrary string provided client-side when the order was sent for the purpose of mapping order sending instructions to the API's response. nullable: true status: type: string enum: - placed - edited - cancelled - invalidOrderType - invalidSide - invalidSize - invalidPrice - insufficientAvailableFunds - selfFill - tooManySmallOrders - marketSuspended - marketInactive - clientOrderIdAlreadyExist - clientOrderIdTooLong - outsidePriceCollar - postWouldExecute - iocWouldNotExecute - orderForEditNotFound - notFound description: >- The status of the order. Success statuses: - `placed` - order placed successfully - `edited` - order edited successfully - `cancelled` - order cancelled successfully Error statuses: - `invalidOrderType` - invalid order type - `invalidSide` - invalid side - `invalidSize` - invalid size - `invalidPrice` - invalid limitPrice and/or stopPrice - `insufficientAvailableFunds` - insufficient available funds - `selfFill` - would fill against the same account's order - `tooManySmallOrders` - too many small orders already open - `marketSuspended` - market is suspended - `marketInactive` - market is inactive - `clientOrderIdAlreadyExist` - client order ID already exists - `clientOrderIdTooLong` - client order ID exceeds the permissible limit - `outsidePriceCollar` - limit price is too far from mark price (fat-finger protection) - `postWouldExecute` - post-only order would execute immediately on placement - `iocWouldNotExecute` - immediate-or-cancel order would not execute - `orderForEditNotFound` - order to be edited was not found - `notFound` - order to be cancelled was not found required: - status - orderEvents 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' OrderType: description: >- The order type: - `lmt` - a limit order - `post` - a post-only limit order - `mkt` - an immediate-or-cancel order with 1% price protection - `stp` - a stop order - `take_profit` - a take profit order - `ioc` - an immediate-or-cancel order - `trailing_stop` - a trailing stop order - `fok` - fill-or-kill order `unknown` is returned when the source value couldn't be decoded; this will be replaced with a real value as soon as possible. type: string enum: - lmt - post - ioc - mkt - stp - take_profit - trailing_stop - fok - unknown OrderDirection: description: >- The direction of 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. type: string enum: - buy - sell - unknown OrderIdElement: type: object description: Provide either `order_id` or `cliOrdId`. properties: cliOrdId: type: string description: Unique client order identifier. maxLength: 100 nullable: true order_id: description: Order ID. type: string format: uuid required: - order_id CancelInstruction: type: object description: Provide either `order_id` or `cliOrdId`. properties: order_id: description: Order ID. type: string format: uuid cliOrdId: description: Unique client order identifier. type: string maxLength: 100 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: BatchOrderExample: value: result: success batchStatus: - status: placed order_tag: '1' order_id: 022774bc-2c4a-4f26-9317-436c8d85746d dateTimeReceived: '2019-09-05T16:41:35.173Z' orderEvents: - type: PLACE order: orderId: 022774bc-2c4a-4f26-9317-436c8d85746d type: lmt symbol: PF_XBTUSD side: buy quantity: 1000 filled: 0 limitPrice: 9400 reduceOnly: false timestamp: '2019-09-05T16:41:35.173Z' lastUpdateTimestamp: '2019-09-05T16:41:35.173Z' - status: edited order_id: 9c2cbcc8-14f6-42fe-a020-6e395babafd1 orderEvents: - type: EDIT old: orderId: 9c2cbcc8-14f6-42fe-a020-6e395babafd1 type: lmt symbol: PF_XBTUSD side: buy quantity: 102 filled: 0 limitPrice: 8500 reduceOnly: false timestamp: '2019-09-04T11:45:48.884Z' lastUpdateTimestamp: '2019-09-04T11:45:48.884Z' new: orderId: 9c2cbcc8-14f6-42fe-a020-6e395babafd1 type: lmt symbol: PF_XBTUSD side: buy quantity: 1000 filled: 0 limitPrice: 9400 reduceOnly: false timestamp: '2019-09-04T11:45:48.884Z' lastUpdateTimestamp: '2019-09-05T16:41:40.996Z' - status: cancelled order_id: 566942c8-a3b5-4184-a451-622b09493129 orderEvents: - type: CANCEL uid: 566942c8-a3b5-4184-a451-622b09493129 order: orderId: 566942c8-a3b5-4184-a451-622b09493129 type: lmt symbol: PF_XBTUSD side: buy quantity: 100 filled: 0 limitPrice: 8500 reduceOnly: false timestamp: '2019-09-02T12:54:08.005Z' lastUpdateTimestamp: '2019-09-02T12:54:08.005Z' serverTime: '2019-09-05T16:41:40.996Z' 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 ````