Modify Orders COID

Changed on

Modify the price and total quantity of existing orders by client order ID. Requires proxy signature, see proxy signing.

patch/v1/trade/orders-coid

Request

  • Base URL: https://api.perpetuals.polymarket.com
  • URL: https://api.perpetuals.polymarket.com/v1/trade/orders-coid
  • Auth: none required

Request body

sigstring required

Signature in hex format

saltinteger required

Salt

tsinteger required

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

expinteger

Command-processing deadline in Unix milliseconds, not an order auto-cancel time; the server caps it at now + 5 s, clamps larger values to that cap, and uses that 5 s default when omitted. Values at or before the server's clock are rejected with HTTP 400 (command expired).

Example request

{
  "op": {
    "args": [
      {
        "coid": "550e8400e29b41d4a716446655440000",
        "p": "100.00",
        "qty": "10.00"
      }
    ]
  },
  "sig": "0x1234567890...",
  "salt": 1234567890,
  "ts": 1767225600000,
  "exp": 1767225600000
}

Response

One modify result per requested order, in request order.

Example response

[
  {
    "order": {
      "oid": 1234567890,
      "iid": 1,
      "buy": true,
      "p": "100.00",
      "qty": "10.00",
      "rest": "9.00",
      "fill": "1.00",
      "cts": 1767225600000,
      "uts": 1767225600000,
      "status": "open",
      "coid": "550e8400e29b41d4a716446655440000"
    }
  }
]

Changes