Symbol Snapshot

Topic: /market/snapshot:{symbol}

Description

Subscribe to get snapshot data for a single symbol.

Push frequency: once every 2s

{
  "id": 1545910660739,
  "type": "subscribe",
  "topic": "/market/snapshot:BTC-USDT",
  "response": true
}

Response

Data Schema

symbolSnapshot

topic

string

required

type

string

required

subject

string

required

data

object

required

sequence

string

required

data

object

required

Example

{
  "topic": "/market/snapshot:BTC-USDT",
  "type": "message",
  "subject": "trade.snapshot",
  "data": {
    "sequence": "14691517895",
    "data": {
      "askSize": 1.15955795,
      "averagePrice": 66867.89967612,
      "baseCurrency": "BTC",
      "bidSize": 0.81772627,
      "board": 1, //Trading pair partition： 0.primary partition 1.KuCoin Plus", example = "1"
      "buy": 67158.1,
      "changePrice": 315.20000000000000000000,
      "changeRate": 0.0047,
      "close": 67158.1,
      "datetime": 1729758286011,
      "high": 67611.80000000000000000000,
      "lastTradedPrice": 67158.1,
      "low": 65257.10000000000000000000,
      "makerCoefficient": 1.000000,
      "makerFeeRate": 0.001,
      "marginTrade": true,
      "mark": 0, //Trading Pair Mark： 0.default 1.ST. 2.NEW", example = "1"
      "market": "USDS",
      "marketChange1h": {
        "changePrice": -102.10000000000000000000,
        "changeRate": -0.0015,
        "high": 67310.60000000000000000000,
        "low": 67051.80000000000000000000,
        "open": 67260.20000000000000000000,
        "vol": 53.73698081000000000000,
        "volValue": 3609965.13819127700000000000 //24-hour rolling transaction volume, refreshed every 2s
      },
      "marketChange24h": {
        "changePrice": 315.20000000000000000000,
        "changeRate": 0.0047,
        "high": 67611.80000000000000000000,
        "low": 65257.10000000000000000000,
        "open": 66842.90000000000000000000,
        "vol": 2227.69895852000000000000,
        "volValue": 147972941.07857507300000000000
      },
      "marketChange4h": {
        "changePrice": -166.30000000000000000000,
        "changeRate": -0.0024,
        "high": 67476.60000000000000000000,
        "low": 67051.80000000000000000000,
        "open": 67324.40000000000000000000,
        "vol": 173.76971188000000000000,
        "volValue": 11695949.43841656500000000000
      },
      "markets": [
        "USDS",
        "PoW"
      ],
      "open": 66842.90000000000000000000,
      "quoteCurrency": "USDT",
      "sell": 67158.2,
      "siteTypes": [
        "turkey",
        "thailand",
        "global"
      ],
      "sort": 100, //sorting number(Pointless)
      "symbol": "BTC-USDT",
      "symbolCode": "BTC-USDT",
      "takerCoefficient": 1.000000,
      "takerFeeRate": 0.001,
      "trading": true,
      "vol": 2227.69895852000000000000,
      "volValue": 147972941.07857507300000000000
    }
  }
}

Request

Query Params

token

string

required

The token required to establish a websocket connection

Example:

2neAiuYvAU61ZDXANAGAsiL4-iAExhsBXZxftpOeh_55i3Ysy2q2LEsEWU64mdzUOPusi34M_wGoSf7iNyEWJ2gZJLp3fgqGGvpzdfennGL3R06_0gIS-diYB9J6i9GjsxUuhPw3Blq6rhZlGykT3Vp1phUafnulOOpts-MEmEF-3bpfetLOAjzQ04YZ_8fRJBvJHl5Vs9Y=.28mIdGU0xg5pJ6TpPYIhjg==

connectId

string

optional

Connection Id, a unique value taken from the client side. Both the id of the welcome message and the id of the error message are connectId.

Example:

121345

Topic: /market/snapshot:{symbol}#

Subscribe Message#

Response#

Request

Topic: /market/snapshot:{symbol}

Subscribe Message

Response