查询用户当前的下单量限制

/sapi/v1/trade/order_limit

请求类型: POST

是否验签: 是

接口权限: 读取

限频: 每个account 3秒最多 144 次请求(交易接口3秒最多 72 次请求，查询接口3秒最多 72 次请求) (该account的所有币种和不同到期日的合约的所有私有接口共享该限制) 。

接口描述: 该接口支持全仓模式和逐仓模式 请求参数contract_code支持交割合约代码，格式为BTC-USDT-210625。 pair、contract_type和contract_code同时填写，优先取contract_code。 business_type 在查询交割合约数据时为必填参数。且参数值要传：futures 或 all 。

请求地址

环境	地址
线上环境	https://api.sunx.io
线上环境（aws客户首选）	https://api.sunx.io

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	false	合约代码	永续"BTC-USDT"... ，交割："BTC-USDT-220325"...
order_price_type	string	true	订单报价类型	limit:限价，"opponent":对手价，"lightning":闪电平仓，"optimal_5":最优5档，"optimal_10":最优10档，"optimal_20":最优20档，"fok":FOK订单，"ioc":IOC订单,opponent_ioc"： 对手价-IOC下单，"lightning_ioc"：闪电平仓-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"lightning_fok"：闪电平仓-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
pair	string	false	交易对	BTC-USDT
contract_type	string	false	合约类型	swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
business_type	string	false	业务类型，不填默认永续	futures：交割、swap：永续、all：全部

响应参数

参数	数据类型	是否必填	描述	取值范围
status	string	false	请求处理结果	ok , "error"
ts	long	true	响应生成时间点，单位：毫秒
<data>		false
order_price_type	string	true	订单报价类型	limit:限价，"opponent":对手价，"lightning":闪电平仓，"optimal_5":最优5档，"optimal_10":最优10档，"optimal_20":最优20档，"fok":FOK订单，"ioc":IOC订单,opponent_ioc"： 对手价-IOC下单，"lightning_ioc"：闪电平仓-IOC下单，"optimal_5_ioc"：最优5档-IOC下单，"optimal_10_ioc"：最优10档-IOC下单，"optimal_20_ioc"：最优20档-IOC下单,"opponent_fok"： 对手价-FOK下单，"lightning_fok"：闪电平仓-FOK下单，"optimal_5_fok"：最优5档-FOK下单，"optimal_10_fok"：最优10档-FOK下单，"optimal_20_fok"：最优20档-FOK下单
<list>(属性名称：list)		false
symbol	string	true	品种代码	BTC,"ETH"...
contract_code	string	true	合约代码	永续"BTC-USDT"... ，交割："BTC-USDT-220325"...
open_limit	decimal	true	合约开仓单笔下单量最大值
close_limit	decimal	true	合约平仓单笔下单量最大值
contract_type	string	true	合约类型	swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
pair	string	true	交易对	如：“BTC-USDT”
business_type	string	true	业务类型	futures：交割、swap：永续
</list>		false
</data>		false

请求示例

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

响应示例

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