Cancel Order

Cancel an open order on an on-chain order book

DELETE /orderbooks/stocks/api/orders/{orderId}

{
  "userAddress": "0x1111111111111111111111111111111111111111"
}

{
  "success": true,
  "data": {
    "id": "ord_xyz789",
    "status": "CANCELLED",
    "cancelledAt": "2025-01-15T10:35:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:35:00.000Z",
    "instanceId": "inst_abc"
  }
}

Cancels an open order. Only the original submitter (identified by userAddress) can cancel their own orders.

Authentication

Requires an instance API key with the trading service enabled.

Path Parameters

orderId · string · required

The order identifier. Max 100 characters.

Request Body

userAddress · string · required

EVM address of the user who placed the order. Must match the original order’s userAddress. Format: 0x[a-fA-F0-9]{40}.

{
  "userAddress": "0x1111111111111111111111111111111111111111"
}

{
  "success": true,
  "data": {
    "id": "ord_xyz789",
    "status": "CANCELLED",
    "cancelledAt": "2025-01-15T10:35:00.000Z"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-01-15T10:35:00.000Z",
    "instanceId": "inst_abc"
  }
}

Error Codes

Code	Status	Description
ORDER_NOT_FOUND	404	Order does not exist or does not belong to this instance