查询当前持仓

/sapi/v1/trade/position/opens

请求类型: GET

是否验签: 是

接口权限: 读取

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

接口描述: 此接口用于查询当前用户持仓仓位的信息。

请求地址

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

请求参数

参数	数据类型	是否必填	描述	取值范围	默认值
contract_code	string	false	合约代码	永续："BTC-USDT"... ， 交割：“BTC-USDT-210625” ...

响应参数

参数	数据类型	是否必填	描述	取值范围
contract_code	String	true	合约代码
position_side	String	true	仓位方向	持仓方向 买卖模式下默认值both， 开平仓模式下： long：平多
direction	String	true	订单方向	"buy":买， "sell":卖
margin_mode	String	true	保证金模式	cross：全仓
open_avg_price	String	true	开仓均价
volume	String	true	持仓量（张
available	String	true	可平仓数量（张）
lever_rate	Long	true	杠杠倍数
adl_risk_percent	String	true	自动减仓指示	(1、2、3、4、5)，1档风险最低，5档风险最高
liquidation_price	String	true	预估强平价
initial_margin	String	true	初始保证金，仅适用于全仓
maintenance_margin	String	true	维持保证金
profit_unreal	String	true	未实现盈亏
profit_rate	String	true	未实现收益率
margin_rate	String	true	保证金率-对标调整信息
margin_currency	String	true	保证金币种（计价币种）
last_price	String	true	最新价格
mark_price	decimal	true	标记价格
contract_type	String	true	合约类型	swap（永续）、this_week（当周）、next_week（次周）、quarter（当季）、next_quarter（次季）
created_time	String	true	创建时间
updated_time	String	true	更新时间

请求示例

GET https://api.sunx.io/sapi/v1/trade/position/opens?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",
      "position_side": "both",
      "direction": "buy",
      "margin_mode": "cross",
      "open_avg_price": "1672.36",
      "volume": "10",
      "available": "10",
      "lever_rate": 5,
      "adl_risk_percent": null,
      "liquidation_price": "-6615323.17169213120630934",
      "initial_margin": "23.9516",
      "maintenance_margin": "0.4490925",
      "profit_unreal": "-47.478",
      "profit_rate": "-1.9822",
      "margin_rate": "0.000000681298594547",
      "mark_price": "1197.58",
      "margin_currency": "USDT",
      "contract_type": "swap",
      "created_time": 1740451087505,
      "updated_time": 1740451087505
    }
  ],
  "ts": 1740451897695
}