获取单个合约仓位信息

限频规则：10次/秒/UID

描述

返回单个合约的仓位信息，包括预估强平价。

HTTP请求

• GET /api/v2/mix/position/single-position

请求示例

curl "https://api.bitget.com/api/v2/mix/position/single-position?symbol=btcusdt&marginCoin=USDT&productType=usdt-futures" \
  -H "ACCESS-KEY:your apiKey" \
  -H "ACCESS-SIGN:*" \
  -H "ACCESS-PASSPHRASE:*" \
  -H "ACCESS-TIMESTAMP:1659076670000" \
  -H "locale:zh-CN" \
  -H "Content-Type: application/json"

请求参数

参数名	参数类型	是否必须	描述
productType	String	是	产品类型 USDT-FUTURES USDT专业合约 COIN-FUTURES 混合合约 USDC-FUTURES USDC专业合约 SUSDT-FUTURES USDT专业合约模拟盘 SCOIN-FUTURES 混合合约模拟盘 SUSDC-FUTURES USDC专业合约模拟盘
symbol	String	是	交易币对，例如：BTCUSDT
marginCoin	String	是	保证金币种，必须大写，例如：USDT

返回示例

{
    "code": "00000",
    "msg": "success",
    "requestTime": 21312312312321,
    "data": [
        {
            "marginCoin": "USDT",
            "symbol": "BTCUSDT",
            "holdSide": "long",
            "openDelegateSize": "0.01",
            "marginSize": "9.6695050093373343",
            "available": "0.01",
            "locked": "0.09",
            "total": "0.01",
            "leverage": "20",
            "achievedProfits": "0",
            "openPriceAvg": "25000",
            "marginMode": "isolated",
            "posMode": "hedge_mode",
            "unrealizedPL": "1",
            "liquidationPrice": "24144.1124161806977798",
            "keepMarginRate": "0.004",
            "markPrice": "25100",
            "breakEvenPrice": "24778.97",
            "totalFee": "1.45",
            "deductedFee": "0.388",
            "marginRatio": "0.1082149545822005",
            "assetMode":"single",
            "cTime": "1691382137448",
            "uTime": "1691382137999"
        }
    ]
}

返回参数

返回字段	参数类型	字段说明
>symbol	String	币对名称
>marginCoin	String	保证金币种
>holdSide	String	持仓方向 long: 多仓 short: 空仓
>openDelegateSize	String	当前委托待成交的数量(基础币)
>marginSize	String	保证金数量 (保证金币种)
>available	String	仓位可用(基础币)
>locked	String	仓位冻结(基础币)
>total	String	仓位总数量(available + locked)
>leverage	String	杠杆倍数
>achievedProfits	String	已实现盈亏（不包含手续费和资金费用）
>openPriceAvg	String	平均开仓价
>marginMode	String	保证金模式 crossed:全仓 isolated: 逐仓
>posMode	String	持仓模式 one_way_mode 单向持仓 hedge_mode 双向持仓
>unrealizedPL	String	未实现盈亏
>liquidationPrice	String	预估强平价 小于等于0，代表永不爆仓
>keepMarginRate	String	仓位档位维持保证金率
>markPrice	String	标记价格
>breakEvenPrice	String	仓位盈亏平衡价
>totalFee	String	资金费用，仓位存续期间，资金费用的累加值,初始值为空，表示还没收取过资金费
>deductedFee	String	已扣手续费，仓位存续期间扣除的交易手续费
>marginRatio	String	维持保证金率（0.1代表10%）
>cTime	String	创建时间 时间戳, 毫秒
>assetMode	String	single : 单币种保证金 union 多币种联合保证金
>uTime	String	最近更新时间，时间戳，毫秒