Get Market BBO Data

/sapi/v1/market/bbo

Request type: GET

Signature verification: No

Interface permission: Read

Rate Limit: For public interface to get market data such as Get Kline data, Get Market Data Overview, Get Contract Information,Get market in-depth data, Get premium index Kline, Get real-time forecast capital rate kline, Get basis data, Get the last Trade of a Contract and so on： （1）For restful interfaces, products, (future, coin margined swap, usdt margined Contracts)800 times/second for one IP at most

Interface description: he interface supports cross margin mode and isolated margin mode. The request parameter "contract_code" supports the contract code of futures, in that the format is BTC-USDT-210625; and supports contract type: BTC-USDT, BTC-USDT-CW, BTC-USDT-NW, BTC-USDT-CQ, BTC-USDT-NQ. business_type is a required parameter when query info of futures contract, and its value must be futures or all.

Request Address

Environment	Address
Online	https://api.sunx.io
Online (preferred by aws customers)	https://api.sunx.io

Request Parameter

Parameter	Data Type	Required	Description	Value Range	Default Value
contract_code	string	false	contract code or contract type	swap: "BTC-USDT"... , future: "BTC-USDT-220325" ... or BTC-USDT-CW, BTC-USDT-NW, BTC-USDT-CQ, BTC-USDT-NQ
business_type	string	false	business type, default is swap	futures, swap, all

Response Parameter

Parameter	Data Type	Required	Description	Value Range
status	string	true	the result of server handling to request	"ok" , "error"
<ticks>	object array	true
contract_code	string	true	contract code or contract type	swap: "BTC-USDT"... , future: "BTC-USDT-220325" ... or BTC-USDT-CW, BTC-USDT-NW, BTC-USDT-CQ, BTC-USDT-NQ
business_type	string	true	business type	futures, swap
mrid	long	true	Match ID, unique identification
ask	array	false	[Ask 1 price, Ask 1 qty (cont)]
bid	array	false	[Bid 1 price, Bid 1 qty (cont)]
ts	long	true	The system detects the orderbook time point, unit: milliseconds
</ticks>		false
ts	long	true	Time of Respond Generation, Unit: Millisecond

Request Example

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

Response Example

{
    "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
}