获取市场最优挂单

/sapi/v1/market/bbo

请求类型: 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（次季）。 business_type 在查询交割合约数据时为必填参数。且参数值要传：futures 或 all 。

请求地址

环境	地址
线上环境	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（次季合约标识）
business_type	string	false	业务类型，不填默认永续	futures：交割、swap：永续、all：全部

响应参数

参数	数据类型	是否必填	描述	取值范围
status	string	true	请求处理结果	ok , "error"
<ticks>	object array	true
contract_code	string	true	合约代码 或 合约标识	永续："BTC-USDT" ... ，交割：“BTC-USDT-210625”... 或 BTC-USDT-CW（当周合约标识）、BTC-USDT-NW（次周合约标识）、BTC-USDT-CQ（当季合约标识）、BTC-USDT-NQ（次季合约标识）
business_type	string	true	业务类型	futures：交割、swap：永续
mrid	long	true	撮合ID，唯一标识
ask	array	false	[卖1价,卖1量(张)]
bid	array	false	[买1价,买1量(张)]
ts	long	true	系统检测orderbook时间点，单位：毫秒
</ticks>		false
ts	long	true	响应生成时间点，单位：毫秒

请求示例

GET https://api.sunx.io/sapi/v1/market/bbo?contract_code=BTC-USDT

响应示例

{
    "status": "ok",
    "ticks": [
        {
            "trade_partition": "USDT",
            "business_type": "swap",
            "contract_code": "BTC-USDT",
            "ask": [
                114881.2,
                34
            ],
            "bid": [
                114860.2,
                5
            ],
            "mrid": 100000016261408,
            "ts": 1757931638127
        }
    ],
    "ts": 1757931643221
}