realtime_transaction_quote_subscription_cn.md

English | 中文

最新成交价(Tick数据)批量订阅

接口说明

该接口支持批量订阅产品的最新成交价(Tick数据)，该接口特性为对于每一个websocket连接，每发送一次该请求，后台会默认覆盖上一次订阅请求。订阅成功后会进行推送数据。

注意：
1、订阅一次成功后，不需要再频繁的发起订阅请求，要求每10秒发送一次心跳，接口就会实时推送数据，在30秒内如果没有收到心跳请求，就会认为超时，断开请求者的websocket连接
2、接入时，客户可增加断开自动重连的逻辑，确保因网络等原因断开可自动重连

接口地址

1、美股、港股、A股、大盘数据接口地址：

基本路径: /quote-stock-b-ws-api

完整URL: wss://quote.tradeswitcher.com/quote-stock-b-ws-api

2、外汇、贵金属、加密货币、商品接口地址：

基本路径: /quote-b-ws-api

完整URL: wss://quote.tradeswitcher.com/quote-b-ws-api

请求示例

1、美股、港股、A股、大盘数据请求示例：

每次建立连接时，必须在URL中附加您的认证token，如下所示：

wss://quote.tradeswitcher.com/quote-stock-b-ws-api?token=您的token

连接成功后，您可以根据需要订阅特定的股票市场数据。详细的调用方法请参考下面的文档说明。

2、外汇、贵金属、加密货币、商品请求示例：

每次建立连接时，必须在URL中附加您的认证token，如下所示：

wss://quote.tradeswitcher.com/quote-b-ws-api?token=您的token

连接成功后，您可以根据需要订阅特定的外汇、加密货币、贵金属、商品数据。详细的调用方法请参考下面的文档说明。

请求-协议号：22004

数据格式:json

数据结构

data定义

字段	名称	类型	必填项	说明
symbol_list	产品列表	array	是	具体格式见下面symbol定义

symbol定义

字段	名称	类型	必填项	说明
code	代码	string	是	具体内容，请查阅code列表

请求示例

{
    "cmd_id":22004,
    "seq_id":106254124,
    "trace":"3baaa938-f92c-4a74-a228-fd49d5e2",
    "data":{
        "symbol_list": [
            {
				"code": "1288.HK"
            },{
				"code": "AAPL.US"
            },
	],
    }
}

应答-协议号：22005

数据格式:json

数据结构

data定义

字段	名称	类型	说明

应答示例

{
    "ret":200,
    "msg":"ok",
    "cmd_id":22005,
    "seq_id":106254124,
    "trace":"3baaa938-f92c-4a74-a228-fd49d5e2",
    "data":{
    }    
}

推送-协议号：22998

数据格式:json

数据结构

data定义

字段	名称	类型	说明
code	代码	string	具体内容，请查阅code列表
seq	报价序号	string
tick_time	报价时间戳	string	单位毫秒
price	成交价	string
volume	成交量	string
turnover	成交额	string
trade_direction	成交方向	uint32	0为默认值，1为BUY，2为SELL

应答示例

{
    "cmd_id":22998,
    "data":{
	"code": "1288.HK",
        "seq": "1605509068000001",
        "tick_time": "1605509068",
        "price": "651.12",
        "volume": "300",
        "turnover": "12345.6",
        "trade_direction": 1,
    }
}