Observe markets depth updates

Subscribe to a stream of updates on market depth for a given market

Query Parameters

marketIds string[]

List of market IDs to be obtained in the subscription.

Responses

• 200
• 500
• default

---

A successful response.(streaming responses)

application/json

Schema

Example (from schema)

---

Schema

error object
code int32
details object[]
@type string
message string
result object
update object[]
List of market depth update data.
buy object[]
Collection of updated price levels for the buy side of the book.
numberOfOrders uint64
price string
volume uint64
marketId string
previousSequenceNumber uint64
sell object[]
Collection of updated price levels for the sell side of the book.
numberOfOrders uint64
price string
volume uint64
sequenceNumber uint64

{
  "error": {
    "code": 0,
    "details": [
      {
        "@type": "string"
      }
    ],
    "message": "string"
  },
  "result": {
    "update": [
      {
        "buy": [
          {
            "numberOfOrders": "string",
            "price": "string",
            "volume": "string"
          }
        ],
        "marketId": "string",
        "previousSequenceNumber": "string",
        "sell": [
          {
            "numberOfOrders": "string",
            "price": "string",
            "volume": "string"
          }
        ],
        "sequenceNumber": "string"
      }
    ]
  }
}

An internal server error

application/json

Schema

Example (from schema)

---

Schema

code int32
details object[]
@type string
message string

{
  "code": 0,
  "details": [
    {
      "@type": "string"
    }
  ],
  "message": "string"
}

An unexpected error response.

application/json

Schema

Example (from schema)

---

Schema

code int32
details object[]
@type string
message string

{
  "code": 0,
  "details": [
    {
      "@type": "string"
    }
  ],
  "message": "string"
}

GET /api/v2/stream/markets/depth/updates

Request

Base URL

https://vega-mainnet-data.commodum.io

marketIds — query

curl / cURL

curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/stream/markets/depth/updates' \
-H 'Accept: application/json'

python / requests

curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/stream/markets/depth/updates' \
-H 'Accept: application/json'

go / native

curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/stream/markets/depth/updates' \
-H 'Accept: application/json'

nodejs / axios

curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/stream/markets/depth/updates' \
-H 'Accept: application/json'