Get Order Amends
POST/private/OrderAmends
Retrieves an audit trail of amend transactions on the specified order. The list is ordered by ascending amend timestamp.
API Key Permissions Required: Orders and trades - Query open orders & trades
or Orders and trades - Query closed orders & trades
, depending on status of order.
Request
- application/json
Body
required
Nonce used in construction of API-Sign
header
The Kraken order identifier for the amended order.
Responses
- 200
The first entry contains the original order parameters and has amend_type of original
.
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- •
original
: original order values on order entry. - •
user
: user requested amendment. - •
restated
: engine order maintenance amendment. - ]
result object
The amend transaction history.
The total count of new and amend transactions (i.e. includes the original order).
amends object[]
Kraken amend identifier
Possible values: [original
, user
, restated
]
The type of amend transaction:
Order quantity in terms of the base asset.
The quantity show in the book for iceberg orders.
Remaining un-traded quantity on the order.
The limit price restriction on the order.
The trigger price on trigger order types.
Description of the reason for this amend.
Indicates if the transaction was restricted from taking liquidity.
The UNIX timestamp for the amend transaction.
{
"response": {
"error": [],
"result": {
"amends": [
{
"amend_id": "TSUN4B-EX2XN-WQ6GKG",
"amend_type": "original",
"order_qty": "0.01000000",
"remaining_qty": "0.01000000",
"limit_price": "61032.8",
"timestamp": 1724158070287558000
},
{
"amend_id": "TF6VAW-VUWMX-6SXTCH",
"amend_type": "user",
"order_qty": "0.01000000",
"remaining_qty": "0.01000000",
"limit_price": "61032.7",
"timestamp": 1724158076936755700
},
{
"amend_id": "TUMY4K-E4MPE-CSL2N3",
"amend_type": "user",
"order_qty": "0.01000000",
"remaining_qty": "0.01000000",
"limit_price": "61032.6",
"timestamp": 1724158214879660000
}
],
"count": 3
}
}
}