Positions
wss://ws-api-futures.kucoin.com
Topic: /contract/positionAll
OR
Topic:/contract/position:XBTUSDTM
Description
1.
2.
3.
4.
5.
1.
2.
Subscribe Message
//Get all symbols position change
{
"id": 1545910660739,
"type": "subscribe",
"topic": "/contract/positionAll",
"response": true,
"privateChannel": "true"
}
//Get specific symbol position change
{
"id": 1545910660739,
"type": "subscribe",
"topic": "/contract/position:XBTUSDTM",
"response": true,
"privateChannel": "true"
}
Response
Data Schema
position
Example
1. Position Changes Caused Operations
// Isolated Margin
{
"type": "message",
"topic": "/contract/positionAll",
"subject": "position.change",
"data": {
"symbol": "XBTUSDTM",
"maintMarginReq": 0.004,
"riskLimit": 50000000,
"realLeverage": 19.1376874933,
"crossMode": false,
"delevPercentage": 0.87,
"openingTimestamp": 1771400783360,
"autoDeposit": false,
"currentTimestamp": 1771474169458,
"currentQty": -1,
"currentCost": -68.0942,
"currentComm": 0.03794569,
"unrealisedCost": -68.0942,
"realisedCost": 0.03794569,
"isOpen": true,
"markPrice": 66954.6,
"markValue": -66.9546,
"posCost": -68.0942,
"posCross": 1,
"posInit": 1.361884,
"posComm": 0,
"posLoss": 0.00291083,
"posMargin": 2.35897317,
"posFunding": -0.00291083,
"posMaint": 0.30799116,
"maintMargin": 3.49857317,
"avgEntryPrice": 68094.2,
"liquidationPrice": 70130.5725363,
"bankruptPrice": 70453.17317,
"settleCurrency": "USDT",
"changeReason": "changeRiskLimit",
"riskLimitLevel": 5,
"realisedGrossCost": 0.0,
"realisedGrossPnl": 0.0,
"realisedPnl": -0.04376735,
"unrealisedPnl": 1.1396,
"unrealisedPnlPcnt": 0.0167,
"unrealisedRoePcnt": 0.8368,
"leverage": 19.1376874933,
"marginMode": "ISOLATED", // CROSS, ISOLATED
"positionSide": "SHORT",
"tax": 0,
"dealComm": -0.04085652,
"fundingFee": -0.00291083,
"aggRate": 0.0046
}
}
// Cross Margin
{
"topic": "/contract/position:XBTUSDTM",
"type": "message",
"data": {
"symbol": "XBTUSDTM",
"crossMode": true,
"delevPercentage": 0.06,
"openingTimestamp": 1717639498983,
"currentTimestamp": 1717724686618,
"currentQty": -2,
"currentCost": -136.002,
"currentComm": 0.06739824,
"unrealisedCost": -136.002,
"realisedCost": 0.06739824,
"isOpen": true,
"markPrice": 70778.04,
"markValue": -141.55608,
"posCost": -136.002,
"posInit": 5.4509819612,
"posMargin": 5.6735903779,
"avgEntryPrice": 68001,
"liquidationPrice": 80700.49720065,
"bankruptPrice": 81152.42267235,
"settleCurrency": "USDT",
"changeReason": "positionChange",
"realisedGrossCost": 0,
"realisedGrossPnl": 0,
"realisedPnl": -0.09580416,
"unrealisedPnl": -5.55408,
"unrealisedPnlPcnt": -0.0408,
"unrealisedRoePcnt": -1.0189,
"leverage": 24.95,
"marginMode": "CROSS", // CROSS, ISOLATED
"positionSide": "BOTH"
},
"subject": "position.change",
"userId": "665ec530aa70390001d22576",
"channelType": "private"
}
2. Funding Fee Settlement
{
"type": "message",
"topic": "/contract/position:XBTUSDTM",
"subject": "position.settlement",
"data": {
"markPrice": 67198.3, // Settlement price
"qty": -2, // Position size
"positionSide": "SHORT",
"settleCurrency": "USDT", // Currency used to clear and settle the trades
"fundingTime": 1771488000000, // Funding time
"marginMode": "ISOLATED",
"fundingFee": -0.00309113, // Funding fees
"fundingRate": -2.3e-05, // Funding rate
"ts": 1771488018495030863 // Current time (nanosecond)
}
}
3. Adjustment Isolated margin Risk Limit Level
{
"type": "message",
"topic": "/contract/positionAll",
"subject": "position.adjustRiskLimit",
"data": {
"msg": "Insufficient balance. Cannot increase margin.", // Failure reason
"success": false,
"riskLimitLevel": 9
}
}Request
Query Params
Modified at 2026-02-19 13:03:19