Skip to main content
DELETE
Cancel Order

Headers

PX-Key-Id
string
required

The key id issued for your signing keypair.

PX-Timestamp
string
required

Unix seconds at signing, valid within 30 seconds of the server clock.

PX-Signature
string
required

Ed25519 signature of the request

PX-Content-Sha256
string
required

Hex SHA-256 of the request body, or the SHA-256 of the empty string when there is no body.

Path Parameters

orderId
string<uuid>
required

Issued order id.

Example:

"3f8b2c9a-2d18-4f7e-9c2a-1b6e1f0c8a4d"

Response

Cancel request accepted

orderId
string<uuid>
required

Issued order id.

Example:

"3f8b2c9a-2d18-4f7e-9c2a-1b6e1f0c8a4d"

tokenId
string
required

Polymarket outcome-token id that identifies both the market and the outcome.

Minimum string length: 1
Example:

"71321045679252212594626385532706912750332728571942532289631379312455583992563"

side
enum<string>
required

Order direction.

Available options:
BUY,
SELL
Example:

"BUY"

type
enum<string>
required

Order type.

Available options:
LIMIT,
MARKET
Example:

"LIMIT"

size
string | null
required

Limit order size in outcome shares, or null for a market order.

price
string | null
required

Limit price in dollars from 0 to 1, or null for a market order.

amount
string | null
required

Market order size, in dollars for a buy and outcome shares for a sell, or null for a limit order.

postOnly
boolean | null
required

Whether a limit order rests as maker-only, or null for a market order.

status
enum<string>
required

Order lifecycle status.

Available options:
PENDING,
SUBMITTED,
OPEN,
FILLED,
CANCELLED,
REJECTED
Example:

"OPEN"

venueOrderId
string | null
required

Polymarket order id, or null until the venue acknowledges the order.

createdAt
string
required

Time the order was created, in ISO-8601.

updatedAt
string
required

Time the order was last updated, in ISO-8601.

filledShares
string | null
required

Outcome shares filled so far, or null before any fill.

averagePrice
string | null
required

Average price executed, in dollars from 0 to 1, excluding fees, or null before any fill.

feesUsd
string | null
required

Total fees charged in dollars, or null before any fill. Charged on top of the executed notional, so it is additive to cost on a buy and deducted from proceeds on a sell.

closedAt
string | null
required

Time the order reached a terminal state, or null while still open.

error
object | null
required

Why the order failed, or null if it did not.