指指數即時行情API 即時報價api 上證、恆生、標普500、納斯達克指數即時行情推送 WebSocket WEBSOCKET API 提供全球指數最新數據的流式訪問，覆蓋上證指數、滬深300、道瓊斯、標普500、納斯達克、恒生等主流核心指數，推送最新價、漲跌幅、成交量等關鍵數據，毫秒級低延遲。

指數 WebSocket 文檔

iTick Indices WebSocket API 提供全球指數最新數據的串流存取。您可以通過以操作形式發送指令來指定要使用的頻道。當您訂閱的頻道中發生事件時，我們的 WebSockets 會發出事件以通知您。

我們的 WebSocket API 基於授權，授權可控制您可以連接到哪些 WebSocket 集群以及您可以存取哪些類型的數據。您可以登入查看包含您的 API 密鑰並根據您的授權進行個人化的範例。

第 1 步：連接

使用高級計劃，您將能夠使用單一連接到集群。如果另一個連接同時嘗試連接到集群，則當前連接將被斷開。如果您需要同時連接到此集群的更多連接，您可以聯繫支援人員。

連接到集群：

wscat -c wss://api.itick.io/indices -H "token: 2abf6c0*************************dd8a1930a2f48ba14a"

連接後您將收到以下訊息：

{
  "code":1,
  "msg": "Connected Successfully"
}

第 2 步：驗證

驗證成功後，您將收到以下訊息：

{
  "code":1,
  "resAc":"auth",
  "msg": "authenticated"
}

驗證失敗，會斷開連接，流程終止

{
  "code":0,
  "resAc":"auth",
  "msg": "auth failed"
}

第 3 步：訂閱

驗證身份後，即可請求串流。您可以在同一請求中請求多個串流。

{
  "ac":"subscribe",
  "params":"DJI$GB,SPX$GB",
  "types":"quote"
}

params：標的symbol$region，支援訂閱多個，多個用英文逗號隔開，單一WS最大訂閱數為500，超過則會被限制
types: 訂閱的類型 depth：盤口、quote：報價、tick：成交、kline：K線（訂閱1分鐘參數：kline@1）
注意:kline@1目前只有高級以上、股票套餐支持

訂閱成功返回內容。

{
  "code":1,
  "resAc":"subscribe",
  "msg": "subscribe Successfully"
}

訂閱失敗返回內容。如下：分別是超出套餐計劃最大數量，訂閱參數錯誤。

{
  "code":0,
  "resAc":"subscribe",
  "msg": "exceeding the maximum subscription limit"
}

{
  "code":0,
  "resAc":"subscribe",
  "msg": "cannot be resolved action"
}

第 4 步：響應內容

iTick.org WebSocket 客戶端必須能夠每秒處理許多傳入訊息。由於 WebSocket 協定的性質，如果客戶端從伺服器獲取訊息的速度很慢，iTick.org 的伺服器必須緩衝訊息，並以客戶端可以接收的速度發送訊息。如果客戶端長時間以太慢的速度消費訊息， iTick.org的伺服器端緩衝區可能會變得太大。如果發生這種情況，iTick.org 將終止 WebSocket 連接。如果您經常遇到這種情況，請考慮訂閱較少的符號或頻道。

訂閱成功後數據按照如下內容發送。

成交響應內容

{
    "code": 1,
    "data": {
        "s": "DJI$GB",        // 標的`symbol$region`
        "ld": 225.215,        // 最新價
        "v": 16742235,        // 成交量
        "t": 1731689407000,   // 時間戳 毫秒
        "type": "tick"        // 資料類型 tick、quote、depth
    }
}

報價響應內容

{
    "code": 1,
    "data": {
        "s": "DJI$GB",           // 標的`symbol$region`
        "ld": 225.215,           // 最新價
        "o": 226.27,             // 開盤價
        "h": 226.92,             // 最高價
        "l": 224.44,             // 最低價
        "t": 1731689407000,      // 時間戳 毫秒
        "v": 16742235,           // 當前交易日內成交量
        "tu": 3774688301.452,    // 當前交易日內成交額
        "type": "quote"          // 資料類型 tick、quote、depth
    }
}

盤口響應內容

{
    "code": 1,
    "data": {
        "s": "DJI$GB",           // 標的`symbol$region`
        "a": [                   // 盤口 ask
            {
                "po": 1,         // 盤口檔位
                "p": 3034.01,    // 盤口價
                "v": 10.6023,    // 盤口數量
                "o": 10.6023     // 盤口委托量
            }
        ],
        "b": [                    // 盤口 bid
            {
                "po": 1,          // 盤口檔位
                "p": 3034,        // 盤口價
                "v": 20.9758,     // 盤口數量
                "o": 20.9758      // 盤口委托量
            }
        ],
        "type": "depth"           // 資料類型 tick、quote、depth
    }
}

K線響應內容

{
  "code": 1,
  "data": {
      "tu": 157513,         // 當前周期總成交額
      "c": 3059.39,         // 當前周期收盤價
      "t": 1731660060000,   // 週期時間戳 毫秒
      "v": 28,              // 當前周期總成交量
      "h": 3061.41,         // 當前周期最高價
      "l": 3055.24,         // 當前周期最低價
      "o": 3055.36,         // 當前周期開盤價
      "type": "kline@1",    // K線週期
      "s": "DJI",           // 標的 symbol
      "r": "GB"             // 標的 region
    }
}

t Kline 周期：周期 1分鐘、2五分鐘、3十五分鐘、4三十分鐘、5一小時、8一天、9一周、10一月

第 5 步：保持心跳

客戶端向伺服器發送,如果超過1分鐘沒有心跳，服務會在適當的時機後斷開與客戶端的鏈接，建議至少每30秒內發送一次心跳，保持與服務端的鏈接

{
  "ac":"ping",
  "params":"1731688569840"
}

伺服端向客戶端發送

{
  "resAc":"pong",
  "data": {"params":"1731688569840"}
}

ping、pong的時間戳需要保持一致