# 接入说明

## 通过websocket协议进行通信

## 行情地址说明

/quote 数字币外汇区域的注册用户 

/quote\_guest 数字币外汇区域的游客 

/quote\_stock 股票区域的注册用户

假定提供的url为wss\://prewppc-3.cmfbl.com/apiQuote 

如果要从数字币外汇区域的注册用户或者股票区域的注册用户，需要在url添加token的查询字符串，访问游客行情不需要token 举例： 

wss\://prewppc.trade.com/apiQuote/quote\_guest \
wss\://prewppc.trade.com/apiQuote/quote?token=02d40878-3627-42bd-a61c-657fb4a3be55app \
wss\://prewppc.trade.com/apiQuote/quote\_stock?token=02d40878-3627-42bd-a61c-657fb4a3be55app

## 请求通用标准头介绍

具体的请求消息格式参考各个接口中的请求示例

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

## 应答通用标准头介绍

具体的应答消息格式参考各个接口中的应答示例

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