获取行情深度数据

/sapi/v1/market/depth

请求类型: GET

是否验签: 否

接口权限: 读取

限频: 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取溢价指数K线、获取实时预测资金费率k线，获取基差数据、获取市场最近成交记录： （1） restful接口：同一个IP, 所有业务（交割合约、币本位永续合约和U本位合约）总共1秒最多800个请求

接口描述: 该接口支持全仓模式和逐仓模式 请求参数contract_code支持交割合约代码，格式为BTC-USDT-210625；同时支持合约标识，格式为 BTC-USDT（永续）、BTC-USDT-CW（当周）、BTC-USDT-NW（次周）、BTC-USDT-CQ（当季）、BTC-USDT-NQ（次季）。

请求地址

环境	地址
线上环境	https://api.sunx.io
线上环境（aws客户首选）	https://api.sunx.io

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	false	合约代码 或 合约标识	永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
type	string	true	深度类型	(150档数据) step0, step1, step2, step3, step4, step5, step14, step15, step16, step17（合并深度1-5,14-17）；step0时，不合并深度, (20档数据) step6, step7, step8, step9, step10, step11, step12, step13, step18, step19（合并深度7-13,18-19）；step6时，不合并深度

响应参数

参数	数据类型	是否必填	描述	取值范围
ch	string	true	数据所属的 channel，格式： market.period
status	string	true	请求处理结果	ok , "error"
<tick>	object	true
asks	array	false	卖盘,[price(挂单价), vol(此价格挂单张数)], 按price升序
bids	array	false	买盘,[price(挂单价), vol(此价格挂单张数)], 按price降序
ch	string	true	数据所属的 channel，格式： market.period
id	long	true	消息id
mrid	long	true	订单ID
ts	long	true	消息生成时间，单位：毫秒.
version	long	true	版本
</tick>		false
ts	long	true	响应生成时间点，单位：毫秒

备注: 合并深度仅改变显示方式，不改变实际成交价格。 step16、step17、step18、step19仅供SHIB-USDT合约使用，暂不支持其他合约使用。 step1至step5, step14至step17是进行了深度合并后的150档深度数据，step7至step13, step18, step19 是进行了深度合并后的20档深度数据，对应精度如下： Depth 类型 精度 step16、step18 0.0000001 step17、step19 0.000001 step1、step7 0.00001 step2、step8 0.0001 step3、step9 0.001 step4、step10 0.01 step5、step11 0.1 step14、step12 1 step15、step13 10

请求示例

curl "https://api.sunx.io/sapi/v1/market/depth?contract_code=BTC-USDT&type=step0"

响应示例

{
    "ch": "market.BTC-USDT.depth.step0",
    "status": "ok",
    "tick": {
        "mrid": 100000019245599,
        "id": 1758016468,
        "bids": [
            [
                115507.7,
                41
            ],
            [
                115426.9,
                4
            ],
            [
                115411.9,
                4
            ],
            [
                115396.9,
                4
            ],
            [
                115381.9,
                4
            ],
            [
                115366.9,
                4
            ],
            [
                115351.9,
                5
            ],
            [
                115336.9,
                4
            ],
            [
                115321.9,
                4
            ],
            [
                115306.9,
                4
            ],
            [
                115291.9,
                4
            ]
        ],
        "asks": [
            [
                115580.2,
                4
            ],
            [
                115583.2,
                41
            ],
            [
                115595.2,
                4
            ],
            [
                115610.2,
                4
            ],
            [
                115625.2,
                4
            ],
            [
                115640.2,
                5
            ],
            [
                115655.2,
                5
            ],
            [
                115670.2,
                5
            ],
            [
                115685.2,
                5
            ],
            [
                115700.2,
                5
            ],
            [
                115715.2,
                5
            ]
        ],
        "ts": 1758016468240,
        "version": 1758016468,
        "ch": "market.BTC-USDT.depth.step0"
    },
    "ts": 1758016470037
}