Edit Order

Sends a request to edit the order parameters of a live order. When an order has been successfully modified, the original order will be cancelled and a new order will be created with the adjusted parameters a new order_id will be returned in the response.

The new amend_order endpoint resolves the caveats listed below and has additional performance gains.There are a number of caveats for edit_order:

triggered stop loss or profit take profit orders are not supported.
orders with conditional close terms attached are not supported.
orders where the executed volume is greater than the newly supplied volume will be rejected.
cl_ord_id is not supported.
existing executions will are associated with the original order and not copied to the amended order.
queue position will not be maintained.

Request
Response

string

required

Value: edit_order

object

Hide properties

string

Format: RFC3339
Example: 2022-12-25T09:30:59.123ZRange of valid offsets (from current time) is 500 milliseconds to 60 seconds, default is 5 seconds. The precision of this parameter is to the millisecond. The engine will prevent this order from matching after this time, it provides protection against latency on time sensitive orders.

float

Condition: Iceberg orders onlyDefines the quantity to show in the book while the rest of order quantity remains hidden. Minimum value is 1 / 15 of order_qty.

string

One of: base, quoteFee preference base or quote currency. quote is the default for buy orders, base is the default for sell orders.

float

Limit price for order types that support limit price restriction.

boolean

deprecated

One of: true, false
Default: false
Condition: Market orders only
Deprecated: If supplied, the flag is accepted but ignoredDisables Market Price Protection (MPP) if set to true. MPP is a feature that protects market orders from filling at a bad price due to price slippage in an illiquid or volatile market. See MPP support article.

string

required

Example: OFGKYQ-FHPCQ-HUQFEKThe Kraken identifier for the order to be amended.

float

Order quantity in terms of the base asset.

integer

User defined reference to be placed on the amended order. It does not identify the order to be amended, use order_id.

boolean

One of: true, false
Default: false
Condition: Orders with limit price onlyCancels the order if it will take liquidity on arrival. Post only orders will always be posted passively in the book.

boolean

One of: true, false
Default: falseReduces an existing margin position without opening an opposite long or short position worth more than the current value of your leveraged assets.

string

required

Example: "BTC/USD"The original symbol identifier for the pair. Note, the symbol cannot be amended.

object

Condition: Required for triggered order types onlyThe parameters for setting the trigger price conditions.

Hide properties

string

One of: index, last
Default: lastThe reference price to track for triggering orders.

index: the index price in the broader market (for this pair). Note, to keep triggers serviceable during connectivity issues with external index feeds, the last price will be used as the reference price.
last: the last traded price in the Kraken order book (for this pair).

float

Specifies the amount for the trigger price - it supports both static market prices and relative prices. This field is used in combination with the price_type field below to determine the effective trigger price.Examples:

To trigger at 29000.5 BTC/USD, use price=29000.5, price_type=static.
To trigger when price rises by 5%, use price=5, price_type=pct.
To trigger when price drops by 150 USD, use price=-150, price_type=quote.

Note, for trailing-stop and trailing-stop-limit order types, the price represents the reversion from the peak. It is always a positive offset value.

string

One of: static, pct, quote
Default: staticThe units for the trigger price.

static: a static market price for the asset, i.e. 30000 for BTC/USD.
pct: a percentage offset from the reference price, i.e. -10% from index price.
quote: a notional offset from the reference price in the quote currency, i.e, 150 BTC/USD from last price.

boolean

One of: true, false
Default: falseIf set to true the order will be validated only, it will not trade in the matching engine.

float

deprecated

Deprecated: Use limit_price parameter

string

deprecated

Deprecated: Use triggers.reference parameter

float

deprecated

Deprecated: Use triggers.price parameter

string

required

Authentication token. See authentication guide for details.

integer

Optional client originated request identifier sent as acknowledgment in the response.

string

Value: edit_order

object

Condition: if success is true

Hide properties

string

Unique ID of the order

string

ID of the order that have been edited

array of string

Non-fatal warnings about the edit, if any.

string

Error message. Condition: if success is false.

boolean

Indicates if the request was successfully processed by the engine. One of: true, false

integer

Optional client originated request identifier sent as acknowledgment in the response.

string

The timestamp when the request was received on the wire, just prior to parsing data. Format: RFC3339. Example: 2022-12-25T09:30:59.123456Z

string

The timestamp when the response was sent on the wire, just prior to transmitting data. Format: RFC3339. Example: 2022-12-25T09:30:59.123456Z

Public Channels

Trading

Account

System