Get Information On Position Limit

/sapi/v1/position/position_limit

Request type: POST

Signature verification: Yes

Interface permission: Read

Rate Limit: Generally, the private interface rate limit of API key is at most 144 times every 3 seconds for each UID (Trade Interface: at most 72 times every 3 seconds. Read Interface: at most 72 times every 3 seconds) (this rate limit is shared by all the altcoins contracts delivered by different date).

Interface description: The interface only supports cross margin mode. The request parameter "contract_code" supports the contract code of futures, in that the format is BTC-USDT-210625. 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	contract code	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"
ts	long	true	Time of Respond Generation, Unit: Millisecond
<data>	object array	true
symbol	string	true	symbol	"BTC","ETH"...
contract_code	string	true	contract code	swap: "BTC-USDT"... , future: "BTC-USDT-210625" ...
margin_mode	string	true	margin mode	cross: cross margin mode
buy_limit	decimal	true	max qty of position on long positions, unit: piece(calculated with mark_price)
sell_limit	decimal	true	max qty of position on short positions, unit: piece(calculated with mark_price)
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
lever_rate	int	true	leverage rate
buy_limit_value	decimal	true	upper limit on long positions, unit: usdt
sell_limit_value	decimal	true	upper limit on short positions, unit: usdt
mark_price	decimal	true	mark price(use this price to calculate the qty of open positions)
trade_partition	string	true	Deprecated parameter
</data>		false

Request Example

GET https://api.sunx.io/sapi/v1/position/position_limit?contract_code=BTC-USDT&SignatureVersion=2&SignatureVersion=2&AccessKeyId=<your key>&Signature=<your signature>&SignatureMethod=HmacSHA256&Timestamp=2025-09-16T07%3A16%3A15

Response Example

{
    "status": "ok",
    "data": [
        {
            "symbol": "BTC",
            "contract_code": "BTC-USDT",
            "margin_mode": "cross",
            "buy_limit": 26126,
            "sell_limit": 26126,
            "business_type": "swap",
            "contract_type": "swap",
            "pair": "BTC-USDT",
            "lever_rate": 5,
            "buy_limit_value": 3000000.000000000000000000,
            "sell_limit_value": 3000000.000000000000000000,
            "mark_price": 114826.3,
            "trade_partition": "USDT"
        }
    ],
    "ts": 1757939712955
}