Skip to main content
DELETE
/
v1
/
trade
/
orders-coid
Cancel Orders COID
curl --request DELETE \
  --url https://api.perpetuals.polymarket.com/v1/trade/orders-coid \
  --header 'Content-Type: application/json' \
  --data '
{
  "op": {
    "type": "cancelOrdersCOID",
    "args": [
      "550e8400e29b41d4a716446655440000"
    ]
  },
  "sig": "0x1234567890...",
  "salt": 1234567890,
  "ts": 1767225600000,
  "exp": 1767225600000
}
'
[
  {
    "status": "ok",
    "oid": 1234567890,
    "coid": "550e8400e29b41d4a716446655440000"
  }
]
Request Weight: 1 + floor(n / 20) Action Weight: 0

Body

application/json

Cancel by coid request.

op
object
required
sig
string
required

Signature in hex format

Example:

"0x1234567890..."

salt
integer
required

Salt

Example:

1234567890

ts
integer
required

Request timestamp. Unix milliseconds for most operations; Unix seconds for withdrawals (must match the on-chain EIP-712 struct verified against block.timestamp).

Example:

1767225600000

exp
integer

Command expiry timestamp in Unix milliseconds. If provided, it must be in the future and within the gateway's default command timeout. It can shorten request validity but cannot extend it. This is not an order auto-cancel time.

Example:

1767225600000

Response

Cancel response.

status
enum<string>
required
Available options:
ok
oid
integer
required

Order ID

Example:

1234567890

coid
string

Echoed only when the request carried a client_order_id.

Required string length: 32
Pattern: ^[0-9a-f]{32}$
Example:

"550e8400e29b41d4a716446655440000"