Agara

Cancel an order by hash

DELETE/order/v1/orders/by-hash/{hash}

Required token scope: orders:cancel.

Cancel the unfilled remainder of this order. No new order signature or request body is required. Completed fills remain valid. Retry an uncertain cancellation using the same hash. If cancellation returns NOT_FOUND, look up the hash and cancel using the returned order ID when available.

After ORDER_NOT_OPEN or NOT_FOUND, read the final order state. For PLACE_PENDING or PLACE_OUTCOME_UNKNOWN, resolve the original placement before retrying cancellation. See cancellation strategies.

Authorization

bearerAuth
AuthorizationBearer <token>

Use an agt_ API token with the scope listed on the operation, or a supported browser access token. HTTP authentication is separate from the EIP-712 order signature.

In: header

Path Parameters

hash*string

Full 0x-prefixed EIP-712 signed order hash.

Match^0x[0-9a-fA-F]{64}$

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/problem+json

application/json

curl -X DELETE "https://example.com/order/v1/orders/by-hash/string"
{  "order_id": "f6179e34-1b64-5a10-a662-32f25759da1a",  "source": "AGARA",  "status": "CANCELLED",  "pending_operation": "NONE",  "as_of": "2026-11-04T12:00:00Z",  "engine_reference": "12345",  "remaining_engine_size": "0"}