Trading

Create Order

Creates a buy/sell order for prediction market positions. Requires signed order data.

post/orders

Request body

ownerIdnumber required

Profile ID of the order owner

orderType'FAK' | 'FOK' | 'GTC' required

Order type (GTC=Good Till Cancelled, FAK=Fill And Kill, FOK=Fill Or Kill)

marketSlugstring required

Market identifier slug

postOnlyboolean

Reject the order if it would match immediately. Supported only for GTC orders.

clientOrderIdstring

Client-provided idempotency key for order placement. If a duplicate is submitted, the server returns 409 Conflict.

onBehalfOfnumber

Profile ID to place order on behalf of (partner flow). Requires an API token with trading scope and a partner relationship with the target profile.

timestampnumber

Optional client-stamped order creation time, Unix ms epoch. Top-level request field; not part of the EIP-712 signed order payload.

recvWindownumber

Optional maximum accepted order age in milliseconds. Valid range: 1 to 10000. If omitted, no receive-window check is applied. Top-level request field; not part of the EIP-712 signed order payload.

stpPolicy'cancel_both' | 'cancel_maker' | 'cancel_taker'

Self-trade prevention policy. Top-level request field; not part of the EIP-712 signed order payload. Defaults to cancel_maker when omitted.

Example request

{
  "order": {
    "salt": "1778155025318314496",
    "maker": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "signer": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "taker": "0x0000000000000000000000000000000000000000",
    "tokenId": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
    "makerAmount": 5000000,
    "takerAmount": 10000000,
    "expiration": "0",
    "price": 0.75,
    "signature": "0x123abc456def789ghi0123abc456def789ghi0123abc456def789ghi0123456789012345678901",
    "signatureType": 2
  },
  "ownerId": 12345,
  "orderType": "GTC",
  "marketSlug": "biden-vs-trump-2024",
  "postOnly": true,
  "clientOrderId": "client-order-001",
  "onBehalfOf": 12345,
  "timestamp": 1735689600000,
  "recvWindow": 1500,
  "stpPolicy": "cancel_maker"
}

Response

Order successfully created and matched

makerMatchesMakerMatch[]

Maker matches if order was matched immediately

Example response

{
  "order": {
    "salt": "1778155025318314496",
    "maker": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "signer": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "taker": "0x0000000000000000000000000000000000000000",
    "tokenId": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
    "makerAmount": "5000000",
    "takerAmount": "10000000",
    "expiration": "0",
    "signatureType": 2,
    "nonce": "0",
    "orderType": "GTC",
    "price": "0.75",
    "ownerId": 12345,
    "market": {
      "id": 7348,
      "slug": "btc-up-or-down-1-hour",
      "title": "BTC Up or Down - Hourly"
    }
  },
  "execution": {
    "matched": true,
    "settlementStatus": "MINED",
    "reason": "STP_TAKER_REJECTED",
    "eligibleAt": "2026-06-08T10:15:30.000Z",
    "tradeEventId": "4aa706dd-6c57-4f3c-945a-99818dfd95f1",
    "txHash": "0xabc123",
    "clientOrderId": "client-order-001",
    "stpMakerCancels": [
      "4aa706dd-6c57-4f3c-945a-99818dfd95f1"
    ],
    "feeRateBps": 25,
    "effectiveFeeBps": 26,
    "totalsRaw": {
      "contractsGross": "1000000",
      "contractsFee": "1000",
      "contractsNet": "999000",
      "usdGross": "500000",
      "usdFee": "500",
      "usdNet": "499500"
    }
  }
}

Changes

Changed in 14 of the 32 revisions of this API.13750

Jul 7, 20268af094995f3931See the full diff
- ▲
  added subschema #2 to the response body oneOf list for the response status
  response-body-one-of-added
- ▲
  the response's body type changed from object to no type for status
  response-body-type-changed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ○
  removed the non-success response with the status
  response-non-success-status-removed
Jun 23, 20262dbb5d2241481See the full diff
- ○
  added the non-success response with the status
  response-non-success-status-added
Jun 12, 2026da9b369e16fd2See the full diff
- ○
  the endpoint scheme security HmacAuth was added to the API
  api-security-added
- ○
  the endpoint scheme security ApiKeyAuth was removed from the API
  api-security-removed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 10, 202613f1d7979a9613See the full diff
- ●
  added the new CANCELED enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
Jun 9, 20266591926f3cef1See the full diff
- ▲
  the / response's property format changed from date-time to no format for status
  response-property-type-changed
Jun 9, 20266e8c49700a622See the full diff
- ▲
  added the pattern ^0x[a-fA-F0-9]{40}$ to the request property /////
  request-property-pattern-added
- ▲
  added the pattern ^0x[a-fA-F0-9]{40}$ to the request property /////
  request-property-pattern-added
Jun 8, 202655779d111c8011See the full diff
- ●
  added the new DELAYED enum value to the / response property for the response status
  response-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
May 28, 20260d52548b06a931See the full diff
- ●
  the request property's max was set to 10000.00
  request-property-max-set
- ●
  the request property's min was set to 1.00
  request-property-min-set
- ●
  the request property's min was set to 0.00
  request-property-min-set
- ○
  added the non-success response with the status
  response-non-success-status-added
May 22, 2026fe10b36da379427See the full diff
- ▲
  the request property ///// became required
  request-property-became-required
- ▲
  the request property ///// became required
  request-property-became-required
- ▲
  added the pattern ^0x([a-fA-F0-9]{2})*$ to the request property /////
  request-property-pattern-added
- ▲
  the response's property type changed from no type to object for status
  response-property-type-changed
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new optional request property
  new-optional-request-property
- ○
  added the new FAK enum value to the request property
  request-property-enum-value-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  added the optional property / to the response with the status
  response-optional-property-added
- ○
  removed from the response property allOf list for the response status
  response-property-all-of-removed
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
- ○
  added the required property / to the response with the status
  response-required-property-added
May 21, 20265e9b7db6b0db122See the full diff
- ▲
  response property order/allOf[Order]/salt list-of-types was widened by adding types string to media type application/json of response 201
  response-property-list-of-types-widened
- ●
  removed the request property
  request-property-removed
- ●
  removed the request property
  request-property-removed
- ○
  request property ///// list-of-types was widened by adding types string to media type application/json
  request-property-list-of-types-widened
- ○
  removed the non-success response with the status
  response-non-success-status-removed

Full history (14 revisions)