Skip to main content

Get Positions

Get Positions

Get positions list

Request frequency limit: 1/1s

Request URL

GET /deepcoin/account/positions

Request Parameters

Field NameRequiredTypeDescription
instTypetruestringProduct type
Contract: SWAP
Spot: SPOT
instIdfalsestringProduct ID

Response Parameters

Field NameTypeDescription
instTypestringProduct type

Spot is displayed as: SPOT
mgnModestringMargin mode: cross=Cross margin

Spot is displayed as:cash
instIdstringProduct ID
posIdstringOrder ID
posSidestringPosition side
Long: long
Short: short

Spot is displayed as: ""
posstringPosition size (in contracts)
avgPxstringAverage open price

Spot is displayed as: average buy price
leverstringLeverage size (not applicable to spot/options)

Spot is displayed as: ""
liqPxstringLiquidation price
useMarginstringUsed margin

Spot is displayed as: ""
mrgPositionstringPosition type
Merged: merge
Split: split

Spot is displayed as: ""
ccystringMargin currency
uTimestringPosition creation time, Unix timestamp in milliseconds
cTimestringLast position update time, Unix timestamp in milliseconds

Response Example

{
"code": "0",
"msg": "",
"data": [
{
"instType": "SWAP",
"mgnMode": "cross",
"instId": "BTC-USDT-SWAP",
"posId": "1000587858872759",
"posSide": "long",
"pos": "200",
"avgPx": "97603",
"lever": "1",
"liqPx": "0.1",
"useMargin": "19520.6",
"mrgPosition": "split",
"ccy": "USDT",
"uTime": "1739243187000",
"cTime": "1739243187000"
}
]
}