Get Swap Price Limitation

/sapi/v1/public/price_limit

Request type: GET

Signature verification: No

Interface permission: Read

Rate Limit: For public interface used to get information of index, price limit, settlement, delivery, open positions and so on, the rate limit is 240 times every 3 second at most for each IP (this 240 times every 3 second public interface rate limit is shared by all the requests from that IP of non-marketing information, like above).

Interface description: The 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-201101; When both of pair, contract_type and contract_code filled in, the contract_code is the preferred. 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	swap: "BTC-USDT"... , future: "BTC-USDT-210625" ...
pair	string	false	pair, BTC-USDT
contract_type	string	false	contract type: swap, this_week, next_week, quarter, next_quarter
business_type	string	false	business type, default is swap: futures, swap, all

Response Parameter

Parameter	Data Type	Required	Description	Value Range
status	string	true	Request Processing Result	"ok" ,"error"
<data>		false
symbol	string	true	Variety code	"BTC","ETH" ...
high_limit	decimal	true	Highest Buying Price
low_limit	decimal	true	Lowest Selling Price
contract_code	string	true	Contract Code	eg swap: "BTC-USDT"... , future: "BTC-USDT-210625" ...
contract_type	string	true	contract type	swap, this_week, next_week, quarter, next_quarter
pair	string	true	pair	such as: “BTC-USDT”
business_type	string	true	business type	futures, swap
trade_partition	string	true	Deprecated parameter
<data>		false
ts	long	true	Time of Respond Generation, Unit: Millisecond

Request Example

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

Response Example

{
        "status": "ok",
        "data": [{
                "symbol": "BTC",
                "contract_code": "BTC-USDT",
                "high_limit": 121563.500000000000000000000000000000000000,
                "low_limit": 109986.100000000000000000000000000000000000,
                "business_type": "swap",
                "pair": "BTC-USDT",
                "contract_type": "swap",
                "trade_partition": "USDT"
        }],
        "ts": 1758006886072
}