> ## Documentation Index
> Fetch the complete documentation index at: https://alltick.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Websocket 通用标准头

> 本页面详细说明AllTick WebSocket行情接口使用的通用标准报文头和连接参数，包括认证相关字段、协议版本与压缩等信息，帮助开发者在建立实时行情订阅连接时按照统一规范发送头部与握手参数，保证推送数据的安全与兼容性。

## 请求通用标准头介绍

| 字段      | 名称  | 类型     | 必填项         | 说明                        |
| ------- | --- | ------ | ----------- | ------------------------- |
| cmd\_id | 协议号 | uint32 | 详见各个接口定义有提供 |                           |
| seq\_id | 序列号 | uint32 | 是           | 请求者生成唯一，响应与请求将保持一致        |
| trace   | 跟踪号 | string | 是           | 请求者生成唯一，响应与请求将保持一致,最大长度64 |
| data    | 数据体 | object | 是           | 具体数据格式见各个接口定义             |

```
{
    "cmd_id":22000,
    "seq_id":123,
    "trace":"asdfsdfa",
    "data":{
    }
}
```

## 应答通用标准头介绍

| 字段      | 名称  | 类型     | 说明                                                  |
| ------- | --- | ------ | --------------------------------------------------- |
| ret     | 返回值 | int32  | [错误码说明](/zh/getting-started/error-code-description) |
| msg     | 消息  | string | 对成功或者失败具体的描述                                        |
| cmd\_id | 协议号 | uint32 | 详见各个接口定义有提供                                         |
| seq\_id | 序列号 | uint32 | 请求者生成唯一，响应与请求将保持一致                                  |
| trace   | 跟踪号 | string | 请求者生成唯一，响应与请求将保持一致,最大长度64                           |
| data    | 数据体 | object | 具体数据格式见各个接口定义                                       |

```
{
    "ret":201,
    "msg":"request header param invalid",
    "cmd_id":0,
    "seq_id":0,
    "trace":"",
    "data":{
    }    
}
```

***

#### AllTick网站

<Note>
  官方网站：<a href="https://alltick.co/">[https://alltick.co/](https://alltick.co/)</a>
</Note>

<script src="/seo-keywords.js" />