查询持仓风险限额

/sapi/v1/position/risk/limit

请求类型: GET

是否验签: 是

接口权限: 读取

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

接口描述: 查询当前持有的合约持仓风险限额阶梯信息

请求地址

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

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	String	false	合约代码	"BTC-USDT","ETH-USDT20241109"……
margin_mode	String	false	保证金模式	cross：全仓
position_side	String	false	仓位方向	long:多，short:空，both：单向持仓

响应参数

参数	数据类型	是否必填	描述	取值范围
contract_code	String	true	合约代码	"BTC-USDT","ETH-USDT20241109"……
margin_mode	String	true	保证金模式	cross：全仓
position_side	String	true	仓位方向	long:多，short:空，both：单向持仓
max_lever	String	true	该层最大杠杆等级
maintenance_margin_rate	String	true	该层维持保证率
max_volume	String	true	该层最高持有张数
min_volume	String	true	该层最低持有张数

请求示例

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

响应示例

{
  "code": 200,
  "message": "Success",
  "data": [
    {
      "contract_code": "BTC-USDT",
      "margin_mode": "cross",
      "position_side": "short",
      "max_lever": "200",
      "maintenance_margin_rate": "0.003850000000000000",
      "max_volume": "400.000000000000000000",
      "min_volume": "1.000000000000000000"
    }
  ],
  "ts": 1740453921437
}