GET
/
v3
/
futures
/
positions
curl --request GET \
  --url https://api.woox.io/v3/futures/positions \
  --header 'Content-Type: application/x-www-form-urlencoded' \
  --header 'x-api-key: <x-api-key>' \
  --header 'x-api-signature: <x-api-signature>' \
  --header 'x-api-timestamp: <x-api-timestamp>' \
  --data 'symbol=<string>'
{
    "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

api-key

Example:

"abcdef123456"

​
x-api-signature
string
required

api-signature

Example:

"signaturestring"

​
x-api-timestamp
string
required

api-timestamp

Example:

"1718943200000"

Body

application/x-www-form-urlencoded

The body is of type object.

Response

200 - application/json

The response is of type object.