用户持仓量限制的查询

/sapi/v1/position/position_limit

请求类型: POST

是否验签: 是

接口权限: 读取

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

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

请求地址

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

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	false	合约代码	永续："BTC-USDT"... ，交割：”BTC-USDT-210625“
pair	string	false	交易对	BTC-USDT
contract_type	string	false	合约类型	swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）

响应参数

参数	数据类型	是否必填	描述	取值范围
status	string	true	请求处理结果	ok , "error"
ts	long	true	响应生成时间点，单位：毫秒
<data>	object array	true
symbol	string	true	品种代码	BTC,"ETH"...
contract_code	string	true	合约代码	永续："BTC-USDT"... ，交割：”BTC-USDT-210625“
margin_mode	string	true	保证金模式	cross：全仓模式；
buy_limit	decimal	true	合约多仓持仓的最大值，单位为张
sell_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：永续
lever_rate	int	true	用户当前品种杠杆倍数
buy_limit_value	decimal	true	合约多仓持仓价值上限，单位USDT
sell_limit_value	decimal	true	合约空仓持仓价值上限，单位USDT
mark_price	decimal	true	当前品种标记价格（以该价格用于计算持仓张数）
trade_partition	string	true	参数已废弃
</data>		false

请求示例

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

响应示例

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