Skip to main content

Market

The MARKET channel provides a high-level overview of the requested market: best bid/ask, 24h price movement, volume, and related stats.

Subscribe

Send a SUBSCRIBE message with a unique channelUuid, "channel": "MARKET", and the market symbol (e.g. "ETH-USD").

{
"action": "SUBSCRIBE",
"channel": "MARKET",
"channelUuid": "your-unique-uuid",
"symbol": "ETH-USD"
}
FieldTypeDescription
channelUuidUUIDUnique id for this subscription (you choose it)
symbolStringMarket to receive updates for (e.g. ETH-USD)

Response

A snapshot is sent immediately after a successful subscription. After that, the server sends an update whenever the market state changes (e.g. best bid/ask or 24h stats change).

Example snapshot/update (public connection):

{
"channelUuid": "86fe5ba2-5526-4db9-ab57-f2d055556000",
"bestBid": "2072.00",
"bestAsk": "2090.00",
"priceChange24h": "-2.00",
"percentageChange24h": -0.000964,
"lastTradedPrice": "2072.00",
"volume24h": "14300.29",
"high24h": "2090.00",
"low24h": "2072.00",
"tradeCount24h": "16",
"marketId": "ETH-USD",
"pricePrecision": "2",
"publishTime": "2024-01-12T02:34:54.753771Z"
}
FieldTypeDescription
channelUuidUUIDMatches your subscription
bestBidStringCurrent best bid price
bestAskStringCurrent best ask price
priceChange24hStringPrice change over last 24h
percentageChange24hNumber24h price change in percentage
lastTradedPriceStringLast trade price
volume24hString24h volume
high24h / low24hString24h high/low
tradeCount24hStringNumber of trades in last 24h
marketIdStringMarket identifier
pricePrecisionIntDecimal places for prices
publishTimeStringServer time of the message (ISO 8601)