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",
      "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",
      "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",
      "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",
      "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",
      "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",
      "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",
      "leverage": "0",
      "orderStatus": "filled",
      "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",
      "leverage": "0",
      "orderStatus": "open",
      "postOnly": false,
      "createdAt": 1783339700000,
      "updatedAt": 1783339750000,
      "clientRequestId": "3d1f9c02-5a77-4c1e-9b6a-2e8d4f0b1c33"
    },
    "clientRequestId": "3d1f9c02-5a77-4c1e-9b6a-2e8d4f0b1c33"
  }
}

WSS

?product=options&market=

{market}

This stream is active on the orders 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.

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",
      "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",
      "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",
      "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",
      "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",
      "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",
      "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",
      "leverage": "0",
      "orderStatus": "filled",
      "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",
      "leverage": "0",
      "orderStatus": "open",
      "postOnly": false,
      "createdAt": 1783339700000,
      "updatedAt": 1783339750000,
      "clientRequestId": "3d1f9c02-5a77-4c1e-9b6a-2e8d4f0b1c33"
    },
    "clientRequestId": "3d1f9c02-5a77-4c1e-9b6a-2e8d4f0b1c33"
  }
}

market

type:string

required

Option contract name (e.g. BTC-19JUN26-62000-C), or ALL to connect across all contracts.

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

Common Requests Contracts Stream

⌘I

Guides

Formulas

WS Reference

API Reference

Multi-Step Responses

Notifications

​Multi-Step Responses

​Notifications

Multi-Step Responses

Notifications