基金即時行情API 即時報價api 中國基金、美國基金、香港基金即時行情資料推送 WebSocket WEBSOCKET API 提供場內交易基金(ETF/LOF)的WebSocket即時行情數據流，完整推送基金即時價格、成交量、IOPV淨值估值及盤口深度變化。數據覆蓋股票ETF、債券ETF、商品ETF等全品類基金品種，毫秒級低延遲推送。

ETF基金 WebSocket 文檔

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

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

第 1 步：連接

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

連接到集群：

wscat -c wss://api.itick.io/fund  -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":"QQQ$US,SPY$US",
  "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": "QQQ$US",             // 標的`symbol$region`
        "ld": 3034.25,             // 最新價
        "v": 16742235,             // 成交量
        "t": 1731689407000,        // 時間戳 毫秒
        "type": "tick"             // 資料類型 tick、quote、depth
    }
}

報價響應內容

{
    "code": 1,
    "data": {
        "s": "QQQ$US",         // 標的`symbol$region`
        "ld": 3034.25,         // 最新價 
        "o": 3034.27,          // 開盤價
        "h": 3034.92,          // 最高價
        "l": 3034.44,          // 最低價
        "t": 1731690011321,    // 時間戳 毫秒
        "v": 0.6186,           // 當前交易日內成交量
        "tu": 1876.832564,     // 當前交易日內成交額
        "type": "quote"        // 資料類型 tick、quote、depth
    }
}

盤口響應內容

{
    "code": 1,
    "data": {
        "s": "QQQ$US",             // 標的`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,           // 當前K線收盤價
      "t": 1731660060000,     // 時間戳 毫秒
      "v": 28,                // 當前K線成交量
      "h": 3061.41,           // 當前K線最高價
      "l": 3055.24,           // 當前K線最低價
      "o": 3055.36,           // 當前K線開盤價
      "type": "kline@1",      // K線週期
      "s": "QQQ",             // 標的 symbol
      "r": "US"               // 標的 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的時間戳需要保持一致