Real-Time Long Short Ratio

GET /coin/position_value/{symbol}

Description: Retrieve long/short position value analytics for a specific token, including user distribution, PnL metrics, and sortable long/short user lists.

---

Request

HTTP Method: GET Endpoint:

/coin/position_value/{symbol}

Path Parameter

Name	Type	Description
symbol	string	Token symbol to query

Query Parameters (optional)

Name	Type	Description
sortBy	string	Sorting field (value), optional
sortOrder	string	Sorting direction (asc or desc), optional
userAddress	string	Filter by user address, optional
offset	number	Pagination offset, optional
limit	number	Pagination limit, optional

---

Response

Content Type: application/json

Field	Type	Description
long	PositionSideStats	Long-side aggregated statistics
short	PositionSideStats	Short-side aggregated statistics
longList	PositionValueItem[]	User list for long positions
shortList	PositionValueItem[]	User list for short positions
total	number	Total record count

Type: PositionSideStats

Field	Type	Description
totalUsers	number	Total number of users
averagePrice	number	Average position price

Type: PositionValueItem

Field	Type	Description
address	string	User wallet address
nickname	string	User nickname
pnl	number	Profit or loss value
pnlPercentage	number	PnL percentage
positionValue	number	Total position value

---

Functionality

This endpoint analyzes the position distribution of a specific token, separating long and short traders, evaluating aggregated statistics, and ranking users by position value or other metrics. It is designed to help understand market sentiment around a token and identify influential long/short holders.

---

Example Request

GET https://openapi.wildmeta.ai/dataprovider/v1/coin/position_value/BTC?sortBy=value&sortOrder=desc&offset=0&limit=20

---

Example Response

{
  "long": {
    "totalUsers": 1523,
    "averagePrice": 62450.12
  },
  "short": {
    "totalUsers": 847,
    "averagePrice": 61890.44
  },
  "longList": [
    {
      "address": "0x1111...abcd",
      "nickname": "BullKing",
      "pnl": 1543.2,
      "pnlPercentage": 3.2,
      "positionValue": 48000.5
    }
  ],
  "shortList": [
    {
      "address": "0x9999...beef",
      "nickname": "ShortMaster",
      "pnl": -820.4,
      "pnlPercentage": -1.7,
      "positionValue": 37500.8
    }
  ],
  "total": 2370
}