基本信息
基地址
wss://fstream.monochrome.exchange/ws/marketRequest Headers
请求头必须添加压缩扩展协议。 Sec-Websocket-Extensions:permessage-deflate请求报文格式
订阅
取消订阅
响应报文格式
响应报文格式
Response-成功
response-token失效
推送报文格式
格式
成交记录(实时推送报文)样例
心跳
客户端每个链接需要定期发送”ping”字符串,服务端会回复”pong”,服务端在30秒内没有收到客户端的ping消息,会主动断开链接订阅参数
结构 {topic}@{arg},{arg},…Orderbook 维护
如何正确在本地维护一个orderbook副本 1.订阅 wss://fstream.monochrome.exchange/ws/market,depth_update@btc_usdt 2.开始缓存收到的更新。同一个价位,后收到的更新覆盖前面的。 3.访问Rest接口 https://fapi(或dapi).monochrome.exchange/future/market/v1/public/q/depth?symbol=btc_usdt&level=500 获得一个500档的深度快照 4.将目前缓存到的信息中u <= 步骤3中获取到的快照中的lastUpdateId的部分丢弃(丢弃更早的信息,已经过期)。 5.将深度快照中的内容更新到本地orderbook副本中,并从websocket接收到的第一个fu <= lastUpdateId+1 且 u >= lastUpdateId+1 的event开始继续更新本地副本。 6.每一个新event的fu应该恰好等于上一个event的u+1,否则可能出现了丢包,请从step3重新进行初始化。 7.每一个event中的挂单量代表这个价格目前的挂单量绝对值,而不是相对变化。 8.如果某个价格对应的挂单量为0,表示该价位的挂单已经撤单或者被吃,应该移除这个价位。 注意: 因为深度快照对价格档位数量有限制,初始快照之外的价格档位并且没有数量变化的价格档位不会出现在增量深度的更新信息内。因此,即使应用来自增量深度的所有更新,这些价格档位也不会在本地 order book 中可见, 所以本地的 order book 与真实的 order book 可能会有一些差异。 不过对于大多数用例,500 的深度限制足以有效地了解市场和交易。成交记录
请求 语法: trade@{symbol} 示例: trade@btc_usdt 速率: 实时Response
K线
请求 语法: kline@{symbol},{interval} interval: 1m, 3m, 5m, 15m, 30m, 1h, 2h, 4h, 6h, 8h, 12h, 1d, 3d, 1w, 1M 示例: kline@btc_usdt,5m 速率: 1000msResponse
ticker
请求 语法: ticker@{symbol} 示例: ticker@btc_usdt 速率: 1000msResponse
agg ticker
请求 语法: agg_ticker@{symbol} 示例: agg_ticker@btc_usdt 速率: 1000msResponse
指数价格
请求 语法: index_price@{symbol} 示例: index_price@btc_usdt 速率: 1000msResponse
标记价格
请求 语法: mark_price@{symbol} 示例: mark_price@btc_usdt 速率: 1000msResponse
增量深度
请求 语法: depth_update@{symbol},{interval} interval: 100/250/500/1000 默认速率100ms 示例: depth_update@btc_usdt,100msResponse
有限深度
请求 语法: depth@{symbol},{levels},{interval} levels: 5/10/20/50 interval: 100/250/500/1000 默认速率1000ms 示例: depth@btc_usdt,50,1000msResponse
资金费率
请求 语法: fund_rate@{symbol} 示例: fund_rate@btc_usdt 速率: 60sResponse

