Sign in
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'FOK' | 'GTC' required

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

marketSlugstring required

Market identifier slug

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.

Example request

{
  "order": {
    "salt": 1234567890,
    "maker": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "signer": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "taker": "0x0000000000000000000000000000000000000000",
    "tokenId": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
    "makerAmount": 1000000000000000000,
    "takerAmount": 750000000000000000,
    "expiration": "2025-04-30T23:59:59Z",
    "nonce": 42,
    "price": 0.75,
    "signature": "0x123abc456def789ghi0123abc456def789ghi0123abc456def789ghi0123456789012345678901",
    "signatureType": 2
  },
  "ownerId": 12345,
  "orderType": "GTC",
  "marketSlug": "biden-vs-trump-2024",
  "clientOrderId": "client-order-001",
  "onBehalfOf": 12345
}

Response

Order successfully created and matched

makerMatchesMakerMatch[]

Maker matches if order was matched immediately

Example response

{
  "order": {
    "salt": 1234567890,
    "maker": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "signer": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "taker": "0x0000000000000000000000000000000000000000",
    "tokenId": "19633204485790857949828516737993423758628930235371629943999544859324645414627",
    "makerAmount": 1000000000000000000,
    "takerAmount": 750000000000000000,
    "expiration": "2025-04-30T23:59:59Z",
    "nonce": 42,
    "price": 0.75,
    "signature": "0x123abc456def789ghi0123abc456def789ghi0123abc456def789ghi0123456789012345678901",
    "signatureType": 2
  },
  "execution": {
    "matched": true,
    "settlementStatus": "MINED",
    "tradeEventId": "4aa706dd-6c57-4f3c-945a-99818dfd95f1",
    "txHash": "0xabc123",
    "clientOrderId": "client-order-001",
    "feeRateBps": 25,
    "effectiveFeeBps": 26,
    "totalsRaw": {
      "contractsGross": "1000000",
      "contractsFee": "1000",
      "contractsNet": "999000",
      "usdGross": "500000",
      "usdFee": "500",
      "usdNet": "499500"
    }
  }
}

Changes