# 合约websocket

# k线

主题: PUBLIC@CONTRACT_KLINE?SYMBOL&PERIOD

所属模块 所属类型 资源隔离类型
合约行情(CONTRACT_MARKET) 查询(QUERY) 币对(SYMBOL)

订阅参数

名称 描述 示例值
SYMBOL 交易对 BTC/USDT等, 请通过调用RestAPI 合约交易对配置接口 , 获取支持的所有交易对
PERIOD K线周期 1MIN:1分钟K线, 5MIN:5分钟K线, 15MIN:15分钟K线, 30MIN:30分钟K线, 60MIN:小时K线,4HOUR:4小时K线,1DAY:日K线,1MON:月K线

消息参数

名称 类型 描述
id Long id,同t
t Long K线柱id
a BigDecimal 成交额
ct Long 交易次数
o BigDecimal 开盘价
c BigDecimal 收盘价
l BigDecimal 最低价
h BigDecimal 最高价
v BigDecimal 成交量
s BigDecimal 交易对
p String k线周期

订阅示例

{"method":"SUBSCRIBE","subject":"PUBLIC@CONTRACT_KLINE?BTC/USDT&1MIN"}

消息示例

{
	"d": {
		"p": "1min",
		"a": 3.242450,
		"ct": 71,
		"c": 30683.7,
		"s": "BTC/USDT",
		"t": 1688552880000,
		"v": 99526.182775,
		"h": 30702.2,
		"id": 1688552880000,
		"l": 30680.7,
		"o": 30700.0
	},
	"e": "MESSAGE",
	"s": "PUBLIC@CONTRACT_KLINE?BTC/USDT&1MIN"
}

# 实时成交

主题: PUBLIC@CONTRACT_TRADE?SYMBOL

所属模块 所属类型 资源隔离类型
合约行情(CONTRACT_MARKET) 查询(QUERY) 币对(SYMBOL)

订阅参数

名称 描述 示例值
SYMBOL 交易对 BTC/USDT等, 请通过调用RestAPI 合约交易对配置接口 , 获取支持的所有交易对

消息参数

名称 类型 描述
s String 交易对
t Long 时间戳
a BigDecimal 成交量
p BigDecimal 成交价
d String 交易方向:BUY 买,SELL 卖

订阅示例

{"method":"SUBSCRIBE","subject":"PUBLIC@CONTRACT_TRADE?BTC/USDT"}

消息推送示例

{
	"d": {
		"p": 30702.0,
		"a": 0.00359,
		"s": "BTC/USDT",
		"t": 1688552725746,
		"d": "BUY"
	},
	"e": "MESSAGE",
	"s": "PUBLIC@CONTRACT_TRADE?BTC/USDT"
}

# 深度

主题: PUBLIC@CONTRACT_DEPTH?SYMBOL&DEPTH

所属模块 所属类型 资源隔离类型
合约行情(CONTRACT_MARKET) 查询(QUERY) 币对(SYMBOL)

订阅参数

名称 描述 示例值
SYMBOL 交易对 BTC/USDT等, 请通过调用RestAPI 合约交易对配置接口 , 获取支持的所有交易对
DEPTH 深度档位 DEPTH_5: 五档深度; DEPTH_10:十档深度;DEPTH_20: 二十档深度; DEPTH_50: 五十档深度

消息参数

名称 类型 描述
s String 交易对
t Long 时间戳
bids Array 买盘
|a BigDecimal 数量
|p BigDecimal 价格
asks Array 卖盘
|a BigDecimal 数量
|p BigDecimal 价格

订阅示例

{"method":"SUBSCRIBE","subject":"PUBLIC@CONTRACT_DEPTH?BTC/USDT&DEPTH_5"}

消息推送示例

{
    "d":{
        "s":"BTC/USDT",
        "t":1688725772858,
        "asks":[
            {
                "p":30233.8,
                "a":0.5938
            },
            {
                "p":30233.9,
                "a":0.59529
            },
            {
                "p":30234.2,
                "a":0.88836
            },
            {
                "p":30238.9,
                "a":0.62001
            },
            {
                "p":30238.9,
                "a":0.1206
            }
        ],
        "bids":[
            {
                "p":29992.9,
                "a":0.53715
            },
            {
                "p":29988.3,
                "a":0.44678
            },
            {
                "p":29987.7,
                "a":0.13787
            },
            {
                "p":29987.3,
                "a":0.58617
            },
            {
                "p":29985.4,
                "a":0.24439
            }
        ]
    },
    "e":"MESSAGE",
    "s":"PUBLIC@CONTRACT_DEPTH?BTC/USDT&DEPTH_5"
}