Order Creation Stream

Messages

{
  "message": "createOrder",
  "content": {
    "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef",
    "market": "BTC-3JUL26-55000-C",
    "price": "6400",
    "quantity": "1",
    "orderType": "buy",
    "tradeType": "limit",
    "postOnly": false
  }
}

{
  "message": "modifyOrder",
  "content": {
    "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7",
    "market": "BTC-3JUL26-55000-C",
    "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
    "price": "6300",
    "quantity": "1"
  }
}

{
  "message": "cancelOrder",
  "content": {
    "clientRequestId": "b56692f8-4322-411d-846f-268c01cd4fa9",
    "market": "BTC-3JUL26-55000-C",
    "cancelBy": "orderId",
    "orderId": "01KWK47RT6A4DD1TCQE662QJ3W"
  }
}

{
  "resultType": "createOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 202,
    "body": "order received",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6400",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "pending",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053411171,
      "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
    },
    "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
  }
}

{
  "resultType": "createOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order placed",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6400",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "open",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053411174,
      "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
    },
    "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
  }
}

{
  "resultType": "createOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 400,
    "body": "self trade not allowed",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWMXCQCSQC1MN9NJ30TYZPKJ",
      "orderType": "sell",
      "tradeType": "limit",
      "price": "6700",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "rejected",
      "postOnly": true,
      "createdAt": 1783113342363,
      "updatedAt": 1783113342365,
      "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
    },
    "error": {
      "code": "6000",
      "slug": "ORDER_REJECTED"
    },
    "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
  }
}

{
  "resultType": "modifyOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 202,
    "body": "order received",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6300",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "pending",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053548624,
      "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
    },
    "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
  }
}

{
  "resultType": "modifyOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order placed",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6300",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "open",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053548626,
      "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
    },
    "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
  }
}

{
  "resultType": "modifyOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 404,
    "body": "order not found",
    "error": {
      "code": "3003",
      "slug": "MODIFY_ORDER_NOT_FOUND_ERROR"
    },
    "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
  }
}

{
  "resultType": "cancelOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order cancelled",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6300",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "cancelled",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053687411,
      "clientRequestId": "b56692f8-4322-411d-846f-268c01cd4fa9"
    },
    "clientRequestId": "b56692f8-4322-411d-846f-268c01cd4fa9"
  }
}

{
  "resultType": "cancelOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 404,
    "body": "order not found",
    "error": {
      "code": "0007",
      "slug": "NOT_FOUND"
    },
    "clientRequestId": "b56692f8-4322-411d-846f-268c01cd4fa9"
  }
}

{
  "resultType": "completeFillOrder",
  "market": "BTC-10JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order filled",
    "order": {
      "market": "BTC-10JUL26-55000-C",
      "orderId": "01KWVNC7T8XWVHGKY00A9TD0YG",
      "orderType": "buy",
      "tradeType": "market",
      "price": "7029.8",
      "quantity": "1",
      "filledQuantity": "1",
      "avgFillPrice": "7029.8",
      "leverage": "0",
      "orderStatus": "completed",
      "postOnly": false,
      "createdAt": 1783339818825,
      "updatedAt": 1783339818882,
      "clientRequestId": "a9716fab-8ac2-47fd-803e-44e2ca22b948"
    },
    "clientRequestId": "a9716fab-8ac2-47fd-803e-44e2ca22b948"
  }
}

{
  "resultType": "partialFillOrder",
  "market": "BTC-10JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order partially filled",
    "order": {
      "market": "BTC-10JUL26-55000-C",
      "orderId": "01KWVN9WSB5H7ZQK2P3M4NR8XA",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "7000",
      "quantity": "2",
      "filledQuantity": "1",
      "avgFillPrice": "7000",
      "leverage": "0",
      "orderStatus": "open",
      "postOnly": false,
      "createdAt": 1783339700000,
      "updatedAt": 1783339750000,
      "clientRequestId": "3d1f9c02-5a77-4c1e-9b6a-2e8d4f0b1c33"
    },
    "clientRequestId": "3d1f9c02-5a77-4c1e-9b6a-2e8d4f0b1c33"
  }
}

{
  "resultType": "sessionBackfill",
  "data": {
    "sessionId": "e4a1c6f0-7b2d-4c8e-9f3a-5d6b8c1e2f4a",
    "resumed": true,
    "from": 1784834389615,
    "to": 1784834449615,
    "events": 6,
    "backfilledMarkets": [
      "BTC-3JUL26-55000-C",
      "ETH-31JUL26-1600-C"
    ],
    "expiredMarkets": []
  }
}

WSS

?product=options&market=

{market}

&expiration=

{expiration}

&strike=

{strike}

&type=

{type}

&subscriptions=optionsOrders&sessionId=

{sessionId}

This stream is active on the optionsOrders subscription, which is on by default when you connect. It allows you to create, modify, and cancel orders, and receive fill notifications.

Multi-Step Responses

Order actions typically produce more than one message on this stream:

An acknowledgment (statusCode: 202) confirming the request was received and is being processed — cancelOrder skips this step and goes straight to confirmation or error
A confirmation (statusCode: 200) once the action has taken effect, or an error if it failed

Notifications

completeFillOrder and partialFillOrder are pushed as your orders execute.

Backfill

Connecting with a sessionId query parameter starts a WebSocket session on this stream: on connect, any messages missed since the last delivered position are backfilled first, followed by a sessionBackfill message summarizing the session. See WebSocket Session for the full field reference, session continuity semantics, and backfill limits.

Messages

{
  "message": "createOrder",
  "content": {
    "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef",
    "market": "BTC-3JUL26-55000-C",
    "price": "6400",
    "quantity": "1",
    "orderType": "buy",
    "tradeType": "limit",
    "postOnly": false
  }
}

{
  "message": "modifyOrder",
  "content": {
    "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7",
    "market": "BTC-3JUL26-55000-C",
    "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
    "price": "6300",
    "quantity": "1"
  }
}

{
  "message": "cancelOrder",
  "content": {
    "clientRequestId": "b56692f8-4322-411d-846f-268c01cd4fa9",
    "market": "BTC-3JUL26-55000-C",
    "cancelBy": "orderId",
    "orderId": "01KWK47RT6A4DD1TCQE662QJ3W"
  }
}

{
  "resultType": "createOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 202,
    "body": "order received",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6400",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "pending",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053411171,
      "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
    },
    "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
  }
}

{
  "resultType": "createOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order placed",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6400",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "open",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053411174,
      "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
    },
    "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
  }
}

{
  "resultType": "createOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 400,
    "body": "self trade not allowed",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWMXCQCSQC1MN9NJ30TYZPKJ",
      "orderType": "sell",
      "tradeType": "limit",
      "price": "6700",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "rejected",
      "postOnly": true,
      "createdAt": 1783113342363,
      "updatedAt": 1783113342365,
      "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
    },
    "error": {
      "code": "6000",
      "slug": "ORDER_REJECTED"
    },
    "clientRequestId": "3e2c3bb4-be3f-4d05-9133-51d3a27b74ef"
  }
}

{
  "resultType": "modifyOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 202,
    "body": "order received",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6300",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "pending",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053548624,
      "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
    },
    "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
  }
}

{
  "resultType": "modifyOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order placed",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6300",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "open",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053548626,
      "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
    },
    "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
  }
}

{
  "resultType": "modifyOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 404,
    "body": "order not found",
    "error": {
      "code": "3003",
      "slug": "MODIFY_ORDER_NOT_FOUND_ERROR"
    },
    "clientRequestId": "ee86bd11-6478-4aa2-917a-17c94b6c2db7"
  }
}

{
  "resultType": "cancelOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order cancelled",
    "order": {
      "market": "BTC-3JUL26-55000-C",
      "orderId": "01KWK47RT6A4DD1TCQE662QJ3W",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "6300",
      "quantity": "1",
      "filledQuantity": "0",
      "avgFillPrice": "0",
      "leverage": "0",
      "orderStatus": "cancelled",
      "postOnly": false,
      "createdAt": 1783053411143,
      "updatedAt": 1783053687411,
      "clientRequestId": "b56692f8-4322-411d-846f-268c01cd4fa9"
    },
    "clientRequestId": "b56692f8-4322-411d-846f-268c01cd4fa9"
  }
}

{
  "resultType": "cancelOrder",
  "market": "BTC-3JUL26-55000-C",
  "data": {
    "statusCode": 404,
    "body": "order not found",
    "error": {
      "code": "0007",
      "slug": "NOT_FOUND"
    },
    "clientRequestId": "b56692f8-4322-411d-846f-268c01cd4fa9"
  }
}

{
  "resultType": "completeFillOrder",
  "market": "BTC-10JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order filled",
    "order": {
      "market": "BTC-10JUL26-55000-C",
      "orderId": "01KWVNC7T8XWVHGKY00A9TD0YG",
      "orderType": "buy",
      "tradeType": "market",
      "price": "7029.8",
      "quantity": "1",
      "filledQuantity": "1",
      "avgFillPrice": "7029.8",
      "leverage": "0",
      "orderStatus": "completed",
      "postOnly": false,
      "createdAt": 1783339818825,
      "updatedAt": 1783339818882,
      "clientRequestId": "a9716fab-8ac2-47fd-803e-44e2ca22b948"
    },
    "clientRequestId": "a9716fab-8ac2-47fd-803e-44e2ca22b948"
  }
}

{
  "resultType": "partialFillOrder",
  "market": "BTC-10JUL26-55000-C",
  "data": {
    "statusCode": 200,
    "body": "order partially filled",
    "order": {
      "market": "BTC-10JUL26-55000-C",
      "orderId": "01KWVN9WSB5H7ZQK2P3M4NR8XA",
      "orderType": "buy",
      "tradeType": "limit",
      "price": "7000",
      "quantity": "2",
      "filledQuantity": "1",
      "avgFillPrice": "7000",
      "leverage": "0",
      "orderStatus": "open",
      "postOnly": false,
      "createdAt": 1783339700000,
      "updatedAt": 1783339750000,
      "clientRequestId": "3d1f9c02-5a77-4c1e-9b6a-2e8d4f0b1c33"
    },
    "clientRequestId": "3d1f9c02-5a77-4c1e-9b6a-2e8d4f0b1c33"
  }
}

{
  "resultType": "sessionBackfill",
  "data": {
    "sessionId": "e4a1c6f0-7b2d-4c8e-9f3a-5d6b8c1e2f4a",
    "resumed": true,
    "from": 1784834389615,
    "to": 1784834449615,
    "events": 6,
    "backfilledMarkets": [
      "BTC-3JUL26-55000-C",
      "ETH-31JUL26-1600-C"
    ],
    "expiredMarkets": []
  }
}

market

type:string

required

A specific market (e.g. BTC-USDT) or ALL.

expiration

type:string

required

Contract expiration, e.g. 24JUN26. Requires market; omit to match every expiration.

strike

type:string

required

Strike price, e.g. 62000. Requires expiration; omit to match every strike.

type

type:string

required

C (call) or P (put). Requires strike; omit to match both.

sessionId

type:string

required

UUID identifying a session. Enables WebSocket Session on this stream. Omit to opt out.

Sec-WebSocket-Protocol

type:httpApiKey

Supply as authorization#<JWT> during the WebSocket handshake.

Create Order

type:object

Modify Order

type:object

Cancel Order By ID

type:object

Create Order — Acknowledgment

type:object

Create Order — Confirmation

type:object

Create Order — Error

type:object

Modify Order — Acknowledgment

type:object

Modify Order — Confirmation

type:object

Modify Order — Error

type:object

Cancel Order — Confirmation

type:object

Cancel Order — Error

type:object

Order Filled — Complete Fill

type:object

Order Filled — Partial Fill

type:object

Session Backfill

type:object

⌘I

Guides

Formulas

WS Reference

API Reference

Multi-Step Responses

Notifications

Backfill

​Multi-Step Responses

​Notifications

​Backfill

Multi-Step Responses

Notifications

Backfill