Skip to main content
This stream provides real-time public trade executions for a single contract. Subscribe with the publicTrades subscription. New executions arrive as publicCompletedOrdersDelta messages, and you can request a snapshot of recent trades with emitPublicCompletedOrders. Upon subscription to this stream, you will receive publicCompletedOrdersDelta messages whenever new trades are executed: 
{
  "resultType": "publicCompletedOrdersDelta",
  "market": "BTC-10JUL26-55000-C",
  "data": {
    "orders": [
      {
        "executionType": "taker",
        "matchId": "01KWM432SK16GA5ZV3H6TQSDRC:01KWW1ERZ59PWXTRVP2YSDA2SB",
        "price": "7204.26",
        "quantity": "1",
        "side": "sell",
        "updatedAt": 1783352484913
      }
    ],
    "statusCode": 200
  }
}
FieldTypeRequiredDescription
resultTypestringYespublicCompletedOrdersDelta
marketstringYesContract name
data.ordersarrayYesNew trade executions since the last update
data.orders[].executionTypestringYesExecution role: taker or maker
data.orders[].matchIdstringYesIdentifier for the trade match (shared by the taker and maker entries)
data.orders[].pricestringYesExecution price
data.orders[].quantitystringYesExecution quantity
data.orders[].sidestringYesSide of the order: buy or sell
data.orders[].updatedAtnumberYesExecution timestamp (ms since epoch)
data.statusCodenumberYes200

​
Recent Trades Snapshot Request

Request recent trade history with emitPublicCompletedOrders, which returns a publicCompletedOrders message. Use it to hydrate recent trades when you first subscribe, or to resynchronize after a gap.

​
Request

{
  "message": "emitPublicCompletedOrders",
  "content": {
    "clientRequestId": "f45cf3c8-3f2d-4ace-80de-8cb4da0a63bb",
    "market": "BTC-10JUL26-55000-C"
  }
}
FieldTypeRequiredDescription
messagestringYesemitPublicCompletedOrders
content.clientRequestIdstringNoClient-generated UUID for correlation
content.marketstringYesContract name

​
Response

{
  "resultType": "publicCompletedOrders",
  "market": "BTC-10JUL26-55000-C",
  "data": {
    "clientRequestId": "f45cf3c8-3f2d-4ace-80de-8cb4da0a63bb",
    "orders": [
      {
        "executionType": "taker",
        "matchId": "9b8e7bc6-c111-46e7-81f2-04691780c1fd-1",
        "price": "7204.26",
        "quantity": "1",
        "side": "sell",
        "updatedAt": 1783352484840
      },
      {
        "executionType": "maker",
        "matchId": "9b8e7bc6-c111-46e7-81f2-04691780c1fd-1",
        "price": "7204.26",
        "quantity": "1",
        "side": "buy",
        "updatedAt": 1783086811956
      },
      {
        "executionType": "taker",
        "matchId": "a9716fab-8ac2-47fd-803e-44e2ca22b948-1",
        "price": "7210.97",
        "quantity": "1",
        "side": "buy",
        "updatedAt": 1783339818825
      },
      {
        "executionType": "maker",
        "matchId": "a9716fab-8ac2-47fd-803e-44e2ca22b948-1",
        "price": "7210.97",
        "quantity": "1",
        "side": "sell",
        "updatedAt": 1783086557575
      }
    ],
    "statusCode": 200
  }
}
FieldTypeRequiredDescription
resultTypestringYespublicCompletedOrders
marketstringYesContract name
data.clientRequestIdstringNoClient-generated UUID for correlation
data.ordersarrayYesSnapshot of recent trade executions
data.orders[].executionTypestringYesExecution role: taker or maker
data.orders[].matchIdstringYesIdentifier for the trade match (shared by the taker and maker entries)
data.orders[].pricestringYesExecution price
data.orders[].quantitystringYesExecution quantity
data.orders[].sidestringYesSide of the order: buy or sell
data.orders[].updatedAtnumberYesExecution timestamp (ms since epoch)
data.statusCodenumberYes200