{ "success": true, "data": { "action": "SIGN_TRANSACTION", "transaction": { "to": "0x489aee4ae9546081d55848f157e03192e826988c", "data": "0x..." }, "functionName": "cancelOrders", "description": "Invalidate 1 signed order on chain" }}
{ "success": false, "data": null, "error": { "code": "ORDER_NOT_FOUND", "message": "No matching orders for this wallet" }}
Returns unsigned calldata for cancelOrders, which permanently invalidates one or more signed orders on the custody contract. Once mined, no venue can settle those signatures, whatever it still holds.This is the trader’s own escape hatch, and it is deliberately not blockable: a trader does not need the venue’s cooperation to retire an authorization they signed. It is the counterpart to Cancel Order, which only removes the order from this venue’s book.The transaction is signed by the trader, not by the venue operator. The contract records the cancellation against the calling address, so it only ever affects that trader’s own orders.
After it is mined
There is no confirm endpoint. The venue reads liveness from the chain rather than from a hash you report: the next time an incoming order could match one of these, it is found retired, cancelled with the reason recorded, and its reservation released.To free the reservation immediately, call Cancel Order as well.
Body Parameters
string
required
The trader’s wallet. Only orders belonging to this wallet are included.
array
required
Order IDs to invalidate, 1 to 50 entries. IDs that do not belong to this wallet, or that another instance submitted, are silently dropped; if none match, the request returns ORDER_NOT_FOUND.
Response Fields
object
Show child attributes
string
SIGN_TRANSACTION when every order sits on one custody contract, SIGN_TRANSACTIONS when they span two.
array
SIGN_TRANSACTIONS only. One cancelOrders transaction per custody contract, each shaped like the single answer below. Sign every step.
object
Show child attributes
string
The custody contract.
string
Encoded cancelOrders calldata.
string
cancelOrders.
string
How many signed orders the transaction invalidates.
A cancelOrders transaction invalidates orders on the one custody contract it targets. When the orders you name sit on two contracts, which happens once a network moves to a new custody generation and older books keep trading on the previous one, the answer carries one transaction per contract in steps. An order stays executable until the transaction for its own contract is mined.