Common Subscription

Subscribe to chain-level common events, including block number changes and market list changes.

Subscribe Request

{
  "id": 5,
  "method": "SUBSCRIBE",
  "params": {
    "chainId": 143,
    "type": "common"
  }
}

Unsubscribe Request

{
  "id": 5,
  "method": "UNSUBSCRIBE",
  "params": {
    "chainId": 143,
    "type": "common"
  }
}

Parameter Description

• chainId (required): Chain ID

• type (required): Must be "common"

Data Stream Message Types

Block Number Changed (blockNumChanged)

{
  "stream": "blockNumChanged",
  "data": {
    "chainId": 143,
    "blockNum": 12345678,
    "blockTime": 1699000000
  }
}

Market List Changed (marketListChanged)

{
  "stream": "marketListChanged",
  "data": [
    {
      "instrumentAddr": "0x73ada1ea346cc3908f41cf67a040f0acd7808be0",
      "expiry": 4294967295,
      "symbol": "ETH/USD",
      "baseToken": {
        "symbol": "ETH",
        "address": "0x...",
        "decimals": 18,
        "price": 2000.0,
        "image": "https://..."
      },
      "quoteToken": {
        "symbol": "USD",
        "address": "0x...",
        "decimals": 18,
        "price": 1.0,
        "image": "https://..."
      },
      "fairPrice": "2000.30",
      "markPrice": "2000.50",
      "fairPriceChange24h": "2.5",
      "baseVolume24h": "1000.5",
      "openInterests": "1000000000000000000",
      "tvl": "2000000000000000000",
      "volume24hUsd": "2000000.0",
      "tvlUsd": "4000000.0",
      "openInterestsUsd": "2000000.0",
      "longOi": "500000000000000000",
      "shortOi": "500000000000000000",
      "periods1hFunding": {
        "long": "0.0001",
        "short": "-0.0001"
      },
      "last1hFunding": {
        "long": "0.0001",
        "short": "-0.0001"
      },
      "fundingRatePerHour": "0.0001",
      "quoteVolume24h": "2000000.0",
      "fullSymbol": "ETH/USD",
      "updateTime": 1699000000,
      "marketType": "perp",
      "poolFee24h": "1000.0",
      "maxLeverage": 100,
      "spotPrice": "2000.00",
      "condition": 1,
      "ammStatus": 1
    }
  ]
}

Stream Types

When subscribing to common, you will receive the following stream types:

1. blockNumChanged: Sent when a new block is mined on the chain

2. marketListChanged: Sent when the market list is updated (new markets added, markets removed, etc.)

Note: To receive individual market pair information updates (marketPairInfoChanged), you need to subscribe to the instrument type instead.