Skip to content

获取单个合约仓位信息

描述

获取单个合约仓位信息列表

HTTP请求

  • GET /fapi/v1/position/positions

请求参数

参数名参数类型是否必须描述
futuresNameString合约名称, 如: "E-BTC-USDT"

请求示例

http
curl 'https://futuresopenapi.100ex.com/fapi/v1/position/positions?futuresName=E-BTC-USDT' \
	-H "X-CH-TS:1736156253259" \
	-H "X-CH-SIGN:*" \
	-H "X-CH-APIKEY:********" \
	-H "Content-Type: application/json"

返回参数

参数名参数类型描述
> symbolString交易币对, 如: "BTC-USDT"
> futuresNameString合约名称, 如: "E-BTC-USDT"
> leverageString杠杆倍数
> typeString仓位类型, 1: 全仓, 2: 逐仓
> sideString持仓方向, BUY: 多仓, SELL: 空仓
> volumeString仓位可用数量
> canCloseVolumeString可平仓数量
> realizedAmountString已实现𫞰亏
> unrealizedAmountString未实现盈亏
> holdAmountString持仓保证金
> indexPriceString指数价格
> openPriceString开仓价格
> avgPriceString平均价格
> closePriceString平仓价格
> closeProfitString平仓盈亏
> tradeFeeString手续费
> capitalFeeString资金费率
> keepRateString保证金维持率
> ctimeString开仓时间
> mtimeString更新仓位时间

返回示例

json
{
    "code": "0",
    "msg": "成功",
    "data": [
        {
            "symbol": "BTC-USDT",
            "futuresName": "E-BTC-USDT",
            "leverage": "20",
            "positionType": "1",
            "positionSide": "BUY",
            "positionVolume": "26",
            "realizedAmount": "0",
            "holdAmount": "0",
            "avgPrice": "93173",
            "openPrice": "93173",
            "canCloseVolume": "26",
            "ctime": "1734682364000",
            "mtime": "1734682364000"
        }
    ],
    "succ": true
}