Skip to main content

Get LP Position List

Query the user's LP positions with real-time valuation, earned rewards, and APY.

info

HTTP Request

POST/v5/alpha/lp/position-list

Request Parameters

None

Response Parameters

ParameterTypeComments
positionsarrayPosition list
> positionIdintegerPosition identifier
> poolAddressstringPool contract address
> poolNamestringPool name
> stakedAmountstringTotal staked amount in payment token
> stakedTokenCodestringStaked token code
> stakedTokenSymbolstringStaked token symbol
> currentValueUsdstringCurrent position value in USD
> earnedRewardsUsdstringTotal earned rewards in USD
> unrealizedPnlstringUnrealized profit/loss
> realizedPnlstringRealized profit/loss
> apystringCurrent APY for this position
> token0AmountstringAmount of token0 in position
> token0SymbolstringToken0 symbol
> token1AmountstringAmount of token1 in position
> token1SymbolstringToken1 symbol
> rangeUpperstringPosition upper range/price
> rangeLowerstringPosition lower range/price
> createTimeintegerPosition creation time (Unix seconds)
> updateTimeintegerLast update time (Unix seconds)
> statusintegerPosition status. 1: Active, 2: Closed, 3: Processing

Request Example

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
}