- Introduction
- Authentication
- Enums Definitions
- Terms Definitions
- SDK
- Rate Limit
- Change Log
- User Service
- Unified REST
- Unified Websocket
- Classic REST
- Account Info
- Account & Funding
- Get Account Summary Info
- Get Apikey Info
- Get Account Type - Spot
- Get Account List - Spot
- Get Account Detail - Spot
- Get Account - Cross Margin
- Get Account - Isolated Margin
- Get Account - Futures
- Get Account Ledgers - Spot/Margin
- Get Account Ledgers - Trade_hf
- Get Account Ledgers - Margin_hf
- Get Account Ledgers - Futures
- Sub Account
- Sub Account API
- Deposit
- Withdrawals
- Transfer
- Trade Fee
- Account & Funding
- Spot Trading
- Market Data
- Get Announcements
- Get Currency
- Get All Currencies
- Get Symbol
- Get All Symbols
- Get Ticker
- Get All Tickers
- Get Trade History
- Get Klines
- Get Part OrderBook
- Get Full OrderBook
- Get Call Auction Part OrderBook
- Get Call Auction Info
- Get Fiat Price
- Get 24hr Stats
- Get Market List
- Get Client IP Address
- Get Server Time
- Get Service Status
- Orders
- Add Order
- Add Order Sync
- Add Order Test
- Batch Add Orders
- Batch Add Orders Sync
- Cancel Order By OrderId
- Cancel Order By OrderId Sync
- Cancel Order By ClientOid
- Cancel Order By ClientOid Sync
- Cancel Partial Order
- Cancel All Orders By Symbol
- Cancel All Orders
- Modify Order
- Get Order By OrderId
- Get Order By ClientOid
- Get Symbols With Open Order
- Get Open Orders
- Get Open Orders By Page
- Get Closed Orders
- Get Trade History
- Get DCP
- Set DCP
- Add Stop Order
- Cancel Stop Order By ClientOid
- Cancel Stop Order By OrderId
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Market Data
- Margin Trading
- Market Data
- Orders
- Add Order
- Add Order Test
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Cancel All Orders By Symbol
- Get Symbols With Open Order
- Get Open Orders
- Get Closed Orders
- Get Trade History
- Get Order By OrderId
- Get Order By ClientOid
- Add Stop Order
- Cancel Stop Order By OrderId
- Cancel Stop Order By ClientOid
- Batch Cancel Stop Orders
- Get Stop Orders List
- Get Stop Order By OrderId
- Get Stop Order By ClientOid
- Add OCO Order
- Cancel OCO Order By OrderId
- Cancel OCO Order By ClientOid
- Batch Cancel OCO Order
- Get OCO Order By OrderId
- Get OCO Order By ClientOid
- Get OCO Order Detail By OrderId
- Get OCO Order List
- Debit
- Credit
- Risk Limit
- Futures Trading
- Introduction
- Market Data
- Orders
- Add Order
- Add Order Test
- Batch Add Orders
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Batch Cancel Orders
- Cancel All Orders
- Cancel All Stop orders
- Get Order By OrderId
- Get Order By ClientOid
- Get Order List
- Get Recent Closed Orders
- Get Stop Order List
- Get Open Order Value
- Get Recent Trade History
- Get Trade History
- Positions
- Get Margin ModeGET
- Switch Margin ModePOST
- Batch Switch Margin ModePOST
- Get Position ModeGET
- Switch Position ModePOST
- Get Max Open SizeGET
- Get Position DetailsGET
- Get Position ListGET
- Get Positions HistoryGET
- Get Max Withdraw MarginGET
- Get Cross Margin LeverageGET
- Modify Cross Margin LeveragePOST
- Add Isolated MarginPOST
- Remove Isolated MarginPOST
- Get Cross Margin Risk LimitGET
- Get Cross Margin RequirementPOST
- Get Isolated Margin Risk LimitGET
- Modify Isolated Margin Risk LimitPOST
- Funding Fees
- Copy Trading
- Introduction
- Add Order
- Add Order Test
- Add Take Profit And Stop Loss Order
- Cancel Order By OrderId
- Cancel Order By ClientOid
- Get Max Open Size
- Get Max Withdraw Margin
- Add Isolated Margin
- Remove Isolated Margin
- Modify Isolated Margin Risk Limit
- Modify Isolated Margin Auto-Deposit Status
- Switch Margin Mode
- Modify Cross Margin Leverage
- Get Cross Margin Requirement
- Switch Position Mode
- Earn
- VIP Lending
- Affiliate
- Broker
- Convert
- Classic Websocket
- Error Code
- Abandoned Endpoints
- Introduction
- Account & Funding
- Get sub-account List - Summary Info (V1)
- Get sub-account List - Spot Balance (V1)
- Get Deposit Addresses (V2)
- Get Deposit Addresses - V1
- Sub-account Transfer
- Get Deposit History - Old
- Internal Transfer
- Get Futures Account Transfer Out Ledger
- Get Withdrawal History - Old
- Futures Account Transfer Out
- Futures Account Transfer In
- Add Deposit Address - V1
- Withdraw - V1
- Spot Trading
- Margin Trading
- Futures Trading
- Affiliate
- Broker
- Developing
Get Position Details
GET
https://api-futures.kucoin.com/api/v2/position
api-channel:Private
api-permission:General
api-rate-limit-pool:Futures
sdk-service:Futures
sdk-sub-service:Positions
sdk-method-name:GetPositionDetails
api-rate-limit-weight:2
Description
Request
Query Params
Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-futures.kucoin.com/api/v2/position?symbol'Responses
🟢200成功
application/json
Body
Examples
{
"code": "200000",
"data": [
{
"id": "500000000001478576",
"symbol": "XBTUSDTM",
"autoDeposit": true,
"maintMarginReq": "0.004",
"riskLimit": 500000,
"realLeverage": "6.01",
"crossMode": false,
"delevPercentage": "0.09",
"openingTimestamp": 1759395308117,
"currentTimestamp": 1759395824264,
"currentQty": 1,
"currentCost": "118.6371",
"currentComm": "0.07118226",
"unrealisedCost": "118.6371",
"realisedGrossCost": "0.0000000000",
"realisedCost": "0.0711822600",
"isOpen": true,
"markPrice": "118604.2",
"markValue": "118.6042000000",
"posCost": "118.6371",
"posCross": "0",
"posCrossMargin": "0",
"posProfit": "0",
"posInit": "19.7728500039",
"posComm": "0",
"posCommCommon": "0",
"posCommFunding": "0",
"posLoss": "0",
"posMargin": "19.7728500039",
"posFunding": "0",
"posMaint": "0.5455793200",
"maintMargin": "19.7399500039",
"realisedGrossPnl": "0.0000000000",
"realisedPnl": "-0.0711822600",
"unrealisedPnl": "-0.0329000000",
"unrealisedPnlPcnt": "-0.0003",
"unrealisedRoePcnt": "-0.0017",
"avgEntryPrice": "118637.10",
"liquidationPrice": "99321.13",
"bankruptPrice": "98864.25",
"settleCurrency": "USDT",
"isInverse": false,
"maintainMargin": "0.004",
"riskLimitLevel": 2,
"marginMode": "ISOLATED",
"positionSide": "LONG",
"leverage": "6.01",
"cumulativeTradeFee": "0.07118226",
"cumulativeFundingFee": "0",
"withdrawPnl": "0",
"cumulativeTax": "0",
"aggRate": "0.0046"
}
]
}Modified at 2025-11-12 07:54:53