Position

User position (portfolio) operations

Get user positions

get

Get positions (portfolio) of a specific user by wallet address. Results are sorted by position size (descending).

Authorizations

ApiKeyAuth

apikeystringRequired

API key for authentication

Path parameters

walletAddressstringRequired

Target user's wallet address

Query parameters

pageinteger · min: 1Optional

Page number

Default: 1

limitinteger · max: 20Optional

Number of items per page (max 20)

Default: 10

marketIdinteger · int64Optional

Market ID filter

chainIdstringOptional

Chain ID filter

Responses

200

Successful response

application/json

codeintegerOptional

Response code (0 for success)

Example: 0

msgstringOptional

Response message

Example: success

400

Bad request - invalid parameters

application/json

get/positions/user/{walletAddress}

HTTPcURLJavaScriptPython

GET /openapi/positions/user/{walletAddress} HTTP/1.1
apikey: YOUR_API_KEY
Accept: */*

{
  "code": 0,
  "msg": "success",
  "result": {
    "total": 1,
    "list": [
      {
        "marketId": 1,
        "marketTitle": "text",
        "marketStatus": 1,
        "marketStatusEnum": "text",
        "marketCutoffAt": 1,
        "rootMarketId": 1,
        "rootMarketTitle": "text",
        "outcome": "text",
        "outcomeSide": 1,
        "outcomeSideEnum": true,
        "sharesOwned": "text",
        "sharesFrozen": "text",
        "unrealizedPnl": "text",
        "unrealizedPnlPercent": "text",
        "dailyPnlChange": "text",
        "dailyPnlChangePercent": "text",
        "conditionId": "text",
        "tokenId": "text",
        "currentValueInQuoteToken": "text",
        "avgEntryPrice": "text",
        "claimStatus": 1,
        "claimStatusEnum": "CanNotClaim",
        "quoteToken": "text"
      }
    ]
  }
}