Get swap information on order limit

/sapi/v1/trade/order_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 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. 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 type code	Case-Insenstive.Both uppercase and lowercase are supported.e.g. swap:"BTC-USDT"... , future:"BTC-USDT-210625"...
order_price_type	string	true	Order Type	"limit": Limit Order，"opponent":BBO，"lightning": Lightning Close，"optimal_5": Optimal top 5 price，"optimal_10":Optimal top 10 price，"optimal_20":Optimal top 20 price,"fok":FOK order,"ioc":ioc order, "opponent_ioc"：IOC order using the BBO price，"lightning_ioc"：lightning IOC，"optimal_5_ioc"：optimal_5 IOC，"optimal_10_ioc"：optimal_10 IOC，"optimal_20_ioc"：optimal_20 IOC, "opponent_fok"：FOK order using the BBO price，"lightning_fok"：lightning FOK，"optimal_5_fok"：optimal_5 FOK，"optimal_10_fok"：optimal_10 FOK，"optimal_20_fok"：optimal_20 FOK
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>		false
order_price_type	string	true	Order Type	"limit": Limit Order，"opponent":BBO，"lightning": Lightning Close，"optimal_5": Optimal top 5 price，"optimal_10":Optimal top 10 price，"optimal_20":Optimal top 20 price,"fok":FOK order,"ioc":ioc order, "opponent_ioc"：IOC order using the BBO price，"lightning_ioc"：lightning IOC，"optimal_5_ioc"：optimal_5 IOC，"optimal_10_ioc"：optimal_10 IOC，"optimal_20_ioc"：optimal_20 IOC, "opponent_fok"：FOK order using the BBO price，"lightning_fok"：lightning FOK，"optimal_5_fok"：optimal_5 FOK，"optimal_10_fok"：optimal_10 FOK，"optimal_20_fok"：optimal_20 FOK
<list>		false
symbol	string	true	symbol	"BTC","ETH"...
contract_code	string	true	contract type code	swap:"BTC-USDT"... , future:"BTC-USDT-210625"...
open_limit	decimal	true	Max open order limit
close_limit	decimal	true	Max close order limit
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
</list>		false
</data>		false

Request Example

POST https://api.sunx.io/sapi/v1/trade/order_limit?order_price_type=limit&SignatureVersion=2&SignatureVersion=2&AccessKeyId=<your key>&Signature=<your signature>&SignatureMethod=HmacSHA256&Timestamp=2025-09-16T07%3A16%3A15
{
    "order_price_type":"limit"
}

Response Example

{
  "status": "ok",
  "data": {
    "order_price_type": "limit",
    "list": [
      {
        "symbol": "BTC",
        "contract_code": "BTC-USDT",
        "open_limit": 170000,
        "close_limit": 170000,
        "business_type": "swap",
        "contract_type": "swap",
        "pair": "BTC-USDT"
      }
    ]
  },
  "ts": 1638760136200
}