Get Futures Position

Description

Get the positions of given futures name

HTTP Request

• GET /fapi/v1/position/positions

Request Parameters

Parameter	Type	Required	Description
futuresName	String	Yes	Futures name, e.g. "E-BTC-USDT"

Request Example

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"

Response Parameters

Parameter	Type	Description
> symbol	String	Trading pair, e.g. "BTC-USDT"
> futuresName	String	Futures name, e.g. "E-BTC-USDT"
> leverage	String	Leverage
> positionType	String	Position type, 1: Cross, 2: Isolated
> avgPrice	String	Average open price
> positionSide	String	Position direction, BUY: long position, SELL: short position
> realizedAmount	String	Realized profit and loss
> positionVolume	String	Total amount of all positions
> holdAmount	String	Isolated margin, crossed mode is 0
> openPrice	String	Open price
> canCloseVolume	String	Cancellable quantity
> ctime	String	Creation timestamp, ms
> mtime	String	Last updated timestamp, ms

Response Example

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