Create Orders

Create new orders. Requires proxy signature, see proxy signing.

post/v1/trade/orders

Request

  • Base URL: https://api.perpetuals.polymarket.com
  • URL: https://api.perpetuals.polymarket.com/v1/trade/orders
  • 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": [
      {
        "iid": 1,
        "buy": true,
        "p": "100.00",
        "qty": "10.00",
        "c": "550e8400e29b41d4a716446655440000",
        "tr": {
          "trp": "110.00"
        }
      }
    ]
  },
  "sig": "0x1234567890...",
  "salt": 1234567890,
  "ts": 1767225600000,
  "exp": 1767225600000
}

Response

Order ACK response. Order result should be fetched using the get orders endpoint.

Example response

[
  {
    "oid": 1234567890,
    "coid": "550e8400e29b41d4a716446655440000"
  }
]

Changes

No operation changes recorded.