股票 WebSocket 文档

iTick.org Stocks WebSocket API 提供对深圳交易所、上海交易所、香港交易所以及美国等最新股市数据的流式访问。您可以通过以操作形式发送指令来指定要使用的频道。当您订阅的频道中发生事件时，我们的 WebSockets 会发出事件以通知您。

我们的 WebSocket API 基于授权，授权可控制您可以连接到哪些 WebSocket 集群以及您可以访问哪些类型的数据。您可以登录查看包含您的 API 密钥并根据您的授权进行个性化的示例。

第 1 步：连接

使用高级计划，您将能够使用单个连接到集群。如果另一个连接同时尝试连接到集群，则当前连接将被断开。如果您需要同时连接到此集群的更多连接，您可以联系支持人员。

连接到集群：

wscat -c wss://api.itick.org/sws

连接后您将收到以下消息：

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

第 2 步：验证

您必须先进行身份验证，然后才能提出任何其他请求。

{
  "ac":"auth",
  "params":"dVEIODs9rmbxOtFJAL_SRvwLXjmddLKg"
}

验证成功后，您将收到以下消息：

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

验证失败，会断开连接，流程终止

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

第 3 步：订阅

验证身份后，即可请求流。您可以在同一请求中请求多个流。

{
  "ac":"subscribe",
  "params":"AAPL$US,TSLA$US",
  "types":"depth,quote"
}

params：标的Code，支持订阅多个，注意：多市场订阅时，产品参数 = code & region，例如：AAPL$US
types: 订阅的类型，depth盘口、quote报价、tick成交

订阅成功返回内容。

{
  "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": "AAPL.US",
        "ld": 225.215,
        "v": 16742235,
        "t": 1731689407000,
        "type": "tick"
    }
}

报价响应内容

{
    "code": 1,
    "data": {
        "s": "AAPL.US",
        "ld": 225.215,
        "o": 226.27,
        "h": 226.92,
        "l": 224.44,
        "t": 1731689407000,
        "v": 16742235,
        "tu": 3774688301.452,
        "ts": 0,
        "type": "quote"
    }
}

盘口响应内容

{
    "code": 1,
    "data": {
        "s": "AAPL.US",
        "a": [
            {
                "po": 1,
                "p": 3034.01,
                "v": 10.6023,
                "o": 10.6023
            },
            {
                "po": 2,
                "p": 3034.03,
                "v": 0.0017,
                "o": 0.0017
            },
            {
                "po": 3,
                "p": 3034.18,
                "v": 0.0017,
                "o": 0.0017
            },
            {
                "po": 4,
                "p": 3034.26,
                "v": 0.0018,
                "o": 0.0018
            },
            {
                "po": 5,
                "p": 3034.27,
                "v": 0.21,
                "o": 0.21
            }
        ],
        "b": [
            {
                "po": 1,
                "p": 3034,
                "v": 20.9758,
                "o": 20.9758
            },
            {
                "po": 2,
                "p": 3033.99,
                "v": 1.8408,
                "o": 1.8408
            },
            {
                "po": 3,
                "p": 3033.98,
                "v": 0.003,
                "o": 0.003
            },
            {
                "po": 4,
                "p": 3033.97,
                "v": 0.0065,
                "o": 0.0065
            },
            {
                "po": 5,
                "p": 3033.94,
                "v": 0.003,
                "o": 0.003
            }
        ],
        "type": "depth"
    }
}

K线响应内容

{
    "code": 0,
    "msg": null,
    "data": {
        "s":"AAPL.US",
        "t":1,
        "k":
        {
            "tu": 157513,
            "c": 3059.39,
            "t": 1731660060000,
            "v": 28,
            "h": 3061.41,
            "l": 3055.24,
            "o": 3055.36
        }
     }
}

t Kline 周期：周期 1分钟、2五分钟、3十分钟、4三十分钟、5一小时、6两小时、7四小时、8一天、9一周、10一月

第 5 步：保持心跳

客户端向服务器发送

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

服务端向客户端发送

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

ping、pong的时间戳需要保持一致