Get LP Position List
Query the user's LP positions with real-time valuation, earned rewards, and APY.
info
- Use this to display the user's LP portfolio, or to confirm position changes after Execute LP Stake / Execute LP Redeem
- For pool details, use Get LP Pool Info instead
- Rate Limit: 3 req/s (per user), 2000 req/s (global)
HTTP Request
POST/v5/alpha/lp/position-listRequest Parameters
None
Response Parameters
| Parameter | Type | Comments |
|---|---|---|
| positions | array | Position list |
| > positionId | integer | Position identifier |
| > poolAddress | string | Pool contract address |
| > poolName | string | Pool name |
| > stakedAmount | string | Total staked amount in payment token |
| > stakedTokenCode | string | Staked token code |
| > stakedTokenSymbol | string | Staked token symbol |
| > currentValueUsd | string | Current position value in USD |
| > earnedRewardsUsd | string | Total earned rewards in USD |
| > unrealizedPnl | string | Unrealized profit/loss |
| > realizedPnl | string | Realized profit/loss |
| > apy | string | Current APY for this position |
| > token0Amount | string | Amount of token0 in position |
| > token0Symbol | string | Token0 symbol |
| > token1Amount | string | Amount of token1 in position |
| > token1Symbol | string | Token1 symbol |
| > rangeUpper | string | Position upper range/price |
| > rangeLower | string | Position lower range/price |
| > createTime | integer | Position creation time (Unix seconds) |
| > updateTime | integer | Last update time (Unix seconds) |
| > status | integer | Position status. 1: Active, 2: Closed, 3: Processing |
Request Example
- HTTP
- Python
- Node.js
POST /v5/alpha/lp/position-list HTTP/1.1
Host: api.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1704067200000
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
{}
Response Example
{
"retCode": 0,
"retMsg": "OK",
"result": {
"positions": [
{
"positionId": 12345,
"poolAddress": "0x1234567890abcdef",
"poolName": "ETH-USDC Pool",
"stakedAmount": "1000",
"stakedTokenCode": "CEX_1",
"stakedTokenSymbol": "USDT",
"currentValueUsd": "1050.25",
"earnedRewardsUsd": "50.25",
"unrealizedPnl": "30.00",
"realizedPnl": "20.25",
"apy": "12.5",
"token0Amount": "0.3",
"token0Symbol": "ETH",
"token1Amount": "600",
"token1Symbol": "USDC",
"rangeUpper": "2000",
"rangeLower": "1800",
"createTime": 1704067200,
"updateTime": 1704067260,
"status": 1
}
]
},
"retExtInfo": {},
"time": 1704067300000
}