Light Tickers

Real-time market data with 24-hour statistics, mark prices, and funding rates.

Channel: ticker

Overview

Connection

Connect to the WebSocket endpoint:

wss://marketdata.app.hello.trade/ws

Subscription Request

{
  "type": "subscribe",
  "channel": "ticker",
  "symbols": ["BTC", "ETH", "NVDA"],
  "interval": 1000
}

Field	Type	Required	Description
type	string	Yes	Must be "subscribe"
channel	string	Yes	Must be "ticker"
symbols	string[]	Yes	List of instrument symbols
interval	Number	No	Update interval in milliseconds: 100, 1000, 2000 (default: 1000)

Unsubscription Request

{
  "type": "unsubscribe",
  "channel": "ticker",
  "symbols": ["BTC"]
}

Response

{
  "type": "marketData",
  "channel": "ticker",
  "data": {
    "symbol": "BTC",
    "lastPrice": "45000.75",
    "lastPriceTimestamp": 1705596400000,
    "lastQuantity": "0.5",
    "bidPrice": "45000.50",
    "bidQuantity": "2.5",
    "askPrice": "45001.25",
    "askQuantity": "1.8",
    "timeStamp": 1705596400000,
    "openingPrice": "44500.00",
    "closingPrice": "45000.00",
    "low": "44000.00",
    "high": "46000.00",
    "volume": "1500.50",
    "quoteVolume": "67500000.00",
    "status": "Trading",
    "volumeTypes": [
      { "type": "Matched", "volume": "1450.00" },
      { "type": "RFQ", "volume": "50.50" }
    ],
    "priceLimits": {
      "minPrice": "40000.00",
      "maxPrice": "50000.00"
    },
    "markPrice": "45000.85",
    "indexPrice": "45001.00",
    "fundingRate": "0.0001",
    "nextFundingTime": 1705600000
  }
}

Field	Type	Description
symbol	string	Instrument symbol
lastPrice	string	Last execution price (omitted if no trades)
lastPriceTimestamp	Number	Unix timestamp (milliseconds) of last price (omitted if no trades)
lastQuantity	string	Last execution quantity (omitted if no trades)
bidPrice	string	Highest bid price (omitted if no bids)
bidQuantity	string	Total quantity at best bid (0 if no bids)
askPrice	string	Lowest ask price (omitted if no asks)
askQuantity	string	Total quantity at best ask (0 if no asks)
timeStamp	Number	Unix timestamp (milliseconds) of ticker data
openingPrice	string	24h opening price (omitted if not available)
closingPrice	string	24h closing price (omitted if not available)
low	string	Lowest price in last 24h (omitted if no trades)
high	string	Highest price in last 24h (omitted if no trades)
volume	string	Total volume in last 24h (omitted if no trades)
quoteVolume	string	Total quote currency volume in last 24h (omitted if no trades)
status	string	Trading status: Trading, Closed, Halted
volumeTypes	Array	Volume breakdown by trade type (omitted if no trades)
priceLimits	Object	Min/max price limits (omitted if not configured)
**markPrice**	string	Current mark price from Stork Oracle
**indexPrice**	string	Current index price from Stork Oracle
**fundingRate**	string	Current funding rate - hourly
**nextFundingTime**	Number	Unix timestamp (seconds) of next funding

Error Response

{
  "type": "error",
  "message": "Invalid subscription request",
  "code": 400
}

Unknown symbols are rejected with a 400 that names them. See Unknown symbols.