---
title: "Market data subscription"
method: POST
path: "/orders/v1/create_market_data_subscription"
tags: ["CLOB"]
---

# Market data subscription

`POST /orders/v1/create_market_data_subscription`

Subscribe to market data for CLOB instrument.

## Headers

- `X-SCX-SIGNED` string, required
- `X-SCX-TIMESTAMP` string, required

## Request body

- PostMarketDataSubscriptionRequest
  - `depth` integer — The depth of the market data
  - `snapshotOnly` boolean — Indicates if only a snapshot of the market data is requested
  - `symbols` string[] — The array of symbols to subscribe to for market data
  - `unaggregated` boolean

## Response `200`

A successful response

- PostMarketDataSubscriptionResponse
  - `error` object
    - `code` integer
    - `details` object[]
      - `@type` string
    - `message` string
  - `result` object
    - `heartbeat` object
    - `update` object — Market data update
      - `bids` object[] — List of bid orders
        - `px` string — The price of the order scaled by the instrument's `price_scale`
        - `qty` string — The quantity of the order scaled by the instrument's `fractional_qty_scale`
        - `symbolSubType` string — The symbol sub-type
      - `offers` object[] — List of offer orders
        - `px` string — The price of the order scaled by the instrument's `price_scale`
        - `qty` string — The quantity of the order scaled by the instrument's `fractional_qty_scale`
        - `symbolSubType` string — The symbol sub-type
      - `bookHidden` boolean — Indicates if the order book is hidden
      - `state` string — The current state of the instrument
      - `stats` object — Trading statistics for the filtered symbol
        - `closePx` string — The closing price
        - `closeSetTime` string, date-time — The closing time
        - `highPx` string — The highest price
        - `highSetTime` string, date-time — The time at which the highest price was set
        - `indicativeOpenPx` string — The indicative open price
        - `indicativeOpenSetTime` string, date-time — The time at which the indicative open price was set
        - `lastTradePx` string — The last trade price
        - `lastTradeQty` string — The last trade quantity
        - `lastTradeSetTime` string, date-time
        - `lowPx` string — The lowest price
        - `lowSetTime` string, date-time
        - `notionalTraded` string — The notional traded amount
        - `notionalSetTime` string, date-time
        - `openInterest` string — The open interest
        - `openInterestSetTime` string, date-time
        - `openPx` string — The opening price
        - `openSetTime` string, date-time
        - `settlementPreliminaryFlag` boolean
        - `settlementPriceCalculationMethod` string
        - `settlementPx` string — The settlement price
        - `settlementSetTime` string, date-time
        - `sharesTraded` string — The number of shares traded
        - `tradingReferencePx` string — The trading reference price
        - `tradingReferenceSetTime` string, date-time — The time at which the trading reference price was set
      - `symbol` string — The trading pair symbol
      - `transactTime` string, date-time — The time at which the transaction occurred

## Other responses

- `default` — An error occurred

---

[API](https://skmtc.dev/zerohash/apis/zerohash-api.md) · [All operations](https://skmtc.dev/zerohash/apis/zerohash-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zerohash/zerohash-api/revisions/8b647d934363/schema)