Skip to main content
GET
/
v3
/
futures
/
positions
cURL
curl --request GET \
  --url https://api.woox.io/v3/futures/positions \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-api-signature: <x-api-signature>' \
  --header 'x-api-timestamp: <x-api-timestamp>'
{
    "success": true,
    "data": {
        "positions": [
            {
                "symbol": "PERP_BTC_USDT",
                "holding": "1.0234",
                "positionSide": "BOTH",
                "pendingLongQty": "0.0",
                "pendingShortQty": "0.0",
                "settlePrice": "27903.2",
                "averageOpenPrice": "27903.2",
                "pnl24H": "0.0",
                "fee24H": "0.0",
                "markPrice": "27903.2",
                "estLiqPrice": "0.0",
                "adlQuantile": 1,
                "timestamp": 1696663260695
            },
            ...
        ]
    },
    "timestamp": 1696663264324
}
Limit: 30 requests per 10 seconds per user 
{
    "success": true,
    "data": {
        "positions": [
            {
                "symbol": "PERP_BTC_USDT",
                "holding": "1.0234",
                "positionSide": "BOTH",
                "pendingLongQty": "0.0",
                "pendingShortQty": "0.0",
                "settlePrice": "27903.2",
                "averageOpenPrice": "27903.2",
                "pnl24H": "0.0",
                "fee24H": "0.0",
                "markPrice": "27903.2",
                "estLiqPrice": "0.0",
                "adlQuantile": 1,
                "timestamp": 1696663260695
            },
            ...
        ]
    },
    "timestamp": 1696663264324
}

Headers

​
x-api-key
string
required
Example:

"abcdef123456"

​
x-api-signature
string
required
Example:

"signaturestring"

​
x-api-timestamp
string
required
Example:

"1718943200000"

Query Parameters

​
symbol
string
required

Symbol name

Response

200 - application/json
​
success
boolean

true

​
timestamp
integer

timestamp

​
data
object