Get detailed information for a specific LP position

curl --request GET \
  --url https://api.lpagent.io/open-api/v1/lp-positions/position \
  --header 'x-api-key: <api-key>'

{
  "status": "success",
  "data": {
    "status": "Open",
    "strategyType": "<string>",
    "tokenId": "5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP",
    "pairName": "STREAMER",
    "currentValue": "1945.43465917398",
    "inputValue": 1953.2696703928616,
    "inputNative": 9.578296184,
    "outputValue": 0,
    "outputNative": 0,
    "collectedReward": 0,
    "collectedRewardNative": 0,
    "collectedFee": 65.00620782123218,
    "collectedFeeNative": 0.3177726158119659,
    "uncollectedFee": "0",
    "impermanentLoss": 123,
    "inputToken0": 0,
    "inputToken1": 9578296184,
    "tickLower": -341,
    "tickUpper": -243,
    "pool": "CcyHh3WgYRpLMDgSRSsJ2ptneSHfrc73oR51r72pAHU7",
    "liquidity": "0",
    "token0": "3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump",
    "token1": "So11111111111111111111111111111111111111112",
    "inRange": true,
    "createdAt": "2025-09-04T15:46:55.000Z",
    "updatedAt": "2025-09-04T23:08:19.000Z",
    "pnl": {
      "value": -1.1084269291922126,
      "percent": -0.05674725543499963,
      "valueNative": 0.031181194298495987,
      "percentNative": 0.3255400929299138
    },
    "pnlNative": -9.260523568188033,
    "upnl": 123,
    "owner": "ACQTiYg2TMRRKo294PENtfqkBqWQ5u3D7NDpm8Te2tyG",
    "dpr": -0.001361934130439991,
    "dprNative": 0.007812962230317931,
    "ageHour": 123,
    "decimal0": 6,
    "decimal1": 9,
    "yield24h": 123,
    "apr": 123,
    "protocol": "meteora",
    "token0Info": {
      "token_symbol": "STREAMER",
      "token_name": "StreamerCoin",
      "token_decimals": 6,
      "token_address": "3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump",
      "logo": "<string>"
    },
    "token1Info": {
      "token_symbol": "SOL",
      "token_name": "Wrapped SOL",
      "token_decimals": 9,
      "token_address": "So11111111111111111111111111111111111111112",
      "logo": "https://www.dextools.io/resources/tokens/logos/3/solana/So11111111111111111111111111111111111111112.jpg"
    },
    "poolInfo": {
      "fee": 100,
      "tickSpacing": 125
    },
    "age": "0.45",
    "position": "5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP",
    "logo0": "https://token-logo.getnimbus.io/api/v1/logo?address=3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump&chain=SOL",
    "logo1": "https://token-logo.getnimbus.io/api/v1/logo?address=So11111111111111111111111111111111111111112&chain=SOL",
    "tokenName0": "STREAMER",
    "tokenName1": "SOL",
    "priceRange": [
      0.0029376923002315727,
      0.009924746662859895,
      0.005535449986126866
    ],
    "range": [
      -341,
      -243,
      -290
    ],
    "value": 1870.0445330471607,
    "valueNative": 9.207458510615153,
    "current": {
      "amount0": "68057177237",
      "amount1": "7356057600",
      "amount0Adjusted": 68057.177237,
      "amount1Adjusted": 7.3560576
    },
    "unCollectedFee0": 1752.90661,
    "unCollectedFee1": 0.036560864,
    "unCollectedFee": 17.110502595276436,
    "unCollectedFeeNative": 0.08424625187137592,
    "price0": 0.005525081888046805,
    "price1": 203.10105453,
    "id": "26e3d33a2ba9a95f1021e0115e40f132:c8a2a48b6fab04a1781d0a1d515713d3c2d43ef1d4770665b95baf504e91f8aa78c8ef77fa5898db01fc9f0cda863796",
    "creationType": "AUTO",
    "followInfo": {
      "sourceOwner": "bb7b777b80b3948b3910aac6cfb85a6b:554f1dcb15f76893c41d150c6ddaa1d44a117fcff191a75a2052e4980e3f00d213cf4b7374a1e1dd1392ead036a9cd60",
      "sourceLabel": "Twenti",
      "sourceTokenId": "651fa1c45f7188731b4e585c4131217e:ed5bdc892f6456accb1a79b4792efa841d385cb83967e12684950399de07892c2bc52028e6c6513df01a57ccc62f2ba9"
    },
    "settings": {
      "autoCompound": false,
      "compoundThreshold": "0",
      "autoRebalance": false,
      "aiManage": false,
      "rebalanceInterval": 1,
      "rebalanceUpOnly": false,
      "takeProfitBps": 1000,
      "stopLossBps": 2000,
      "preferNativeValue": false,
      "positionCurrency": "SOL"
    },
    "logs": [
      {
        "position_id": "5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP",
        "trigger": "COLLECT_FEE_SUCCESS",
        "created_at": "2025-09-04T23:08:23.013Z"
      }
    ]
  }
}

GET

open-api

lp-positions

position

Get detailed information for a specific LP position

curl --request GET \
  --url https://api.lpagent.io/open-api/v1/lp-positions/position \
  --header 'x-api-key: <api-key>'

{
  "status": "success",
  "data": {
    "status": "Open",
    "strategyType": "<string>",
    "tokenId": "5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP",
    "pairName": "STREAMER",
    "currentValue": "1945.43465917398",
    "inputValue": 1953.2696703928616,
    "inputNative": 9.578296184,
    "outputValue": 0,
    "outputNative": 0,
    "collectedReward": 0,
    "collectedRewardNative": 0,
    "collectedFee": 65.00620782123218,
    "collectedFeeNative": 0.3177726158119659,
    "uncollectedFee": "0",
    "impermanentLoss": 123,
    "inputToken0": 0,
    "inputToken1": 9578296184,
    "tickLower": -341,
    "tickUpper": -243,
    "pool": "CcyHh3WgYRpLMDgSRSsJ2ptneSHfrc73oR51r72pAHU7",
    "liquidity": "0",
    "token0": "3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump",
    "token1": "So11111111111111111111111111111111111111112",
    "inRange": true,
    "createdAt": "2025-09-04T15:46:55.000Z",
    "updatedAt": "2025-09-04T23:08:19.000Z",
    "pnl": {
      "value": -1.1084269291922126,
      "percent": -0.05674725543499963,
      "valueNative": 0.031181194298495987,
      "percentNative": 0.3255400929299138
    },
    "pnlNative": -9.260523568188033,
    "upnl": 123,
    "owner": "ACQTiYg2TMRRKo294PENtfqkBqWQ5u3D7NDpm8Te2tyG",
    "dpr": -0.001361934130439991,
    "dprNative": 0.007812962230317931,
    "ageHour": 123,
    "decimal0": 6,
    "decimal1": 9,
    "yield24h": 123,
    "apr": 123,
    "protocol": "meteora",
    "token0Info": {
      "token_symbol": "STREAMER",
      "token_name": "StreamerCoin",
      "token_decimals": 6,
      "token_address": "3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump",
      "logo": "<string>"
    },
    "token1Info": {
      "token_symbol": "SOL",
      "token_name": "Wrapped SOL",
      "token_decimals": 9,
      "token_address": "So11111111111111111111111111111111111111112",
      "logo": "https://www.dextools.io/resources/tokens/logos/3/solana/So11111111111111111111111111111111111111112.jpg"
    },
    "poolInfo": {
      "fee": 100,
      "tickSpacing": 125
    },
    "age": "0.45",
    "position": "5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP",
    "logo0": "https://token-logo.getnimbus.io/api/v1/logo?address=3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump&chain=SOL",
    "logo1": "https://token-logo.getnimbus.io/api/v1/logo?address=So11111111111111111111111111111111111111112&chain=SOL",
    "tokenName0": "STREAMER",
    "tokenName1": "SOL",
    "priceRange": [
      0.0029376923002315727,
      0.009924746662859895,
      0.005535449986126866
    ],
    "range": [
      -341,
      -243,
      -290
    ],
    "value": 1870.0445330471607,
    "valueNative": 9.207458510615153,
    "current": {
      "amount0": "68057177237",
      "amount1": "7356057600",
      "amount0Adjusted": 68057.177237,
      "amount1Adjusted": 7.3560576
    },
    "unCollectedFee0": 1752.90661,
    "unCollectedFee1": 0.036560864,
    "unCollectedFee": 17.110502595276436,
    "unCollectedFeeNative": 0.08424625187137592,
    "price0": 0.005525081888046805,
    "price1": 203.10105453,
    "id": "26e3d33a2ba9a95f1021e0115e40f132:c8a2a48b6fab04a1781d0a1d515713d3c2d43ef1d4770665b95baf504e91f8aa78c8ef77fa5898db01fc9f0cda863796",
    "creationType": "AUTO",
    "followInfo": {
      "sourceOwner": "bb7b777b80b3948b3910aac6cfb85a6b:554f1dcb15f76893c41d150c6ddaa1d44a117fcff191a75a2052e4980e3f00d213cf4b7374a1e1dd1392ead036a9cd60",
      "sourceLabel": "Twenti",
      "sourceTokenId": "651fa1c45f7188731b4e585c4131217e:ed5bdc892f6456accb1a79b4792efa841d385cb83967e12684950399de07892c2bc52028e6c6513df01a57ccc62f2ba9"
    },
    "settings": {
      "autoCompound": false,
      "compoundThreshold": "0",
      "autoRebalance": false,
      "aiManage": false,
      "rebalanceInterval": 1,
      "rebalanceUpOnly": false,
      "takeProfitBps": 1000,
      "stopLossBps": 2000,
      "preferNativeValue": false,
      "positionCurrency": "SOL"
    },
    "logs": [
      {
        "position_id": "5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP",
        "trigger": "COLLECT_FEE_SUCCESS",
        "created_at": "2025-09-04T23:08:23.013Z"
      }
    ]
  }
}

Authorizations

x-api-key

string

header

required

Query Parameters

position

string

required

The position ID/token ID to retrieve

Response

Successfully retrieved position details

status

string

Example:

"success"

data

object

Show child attributes

data.status

string

Position status

Example:

"Open"

data.strategyType

string

Strategy type for the position

data.tokenId

string

Position token ID

Example:

"5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP"

data.pairName

string

Trading pair name

Example:

"STREAMER"

data.currentValue

string

Current USD value of the position

Example:

"1945.43465917398"

data.inputValue

number

Initial USD value invested

Example:

1953.2696703928616

data.inputNative

number

Initial native token amount invested

Example:

9.578296184

data.outputValue

number

USD value of withdrawn amount

Example:

0

data.outputNative

number

Native token amount withdrawn

Example:

0

data.collectedReward

number

USD value of collected rewards

Example:

0

data.collectedRewardNative

number

Native token amount of collected rewards

Example:

0

data.collectedFee

number

USD value of collected fees

Example:

65.00620782123218

data.collectedFeeNative

number

Native token amount of collected fees

Example:

0.3177726158119659

data.uncollectedFee

string

USD value of uncollected fees

Example:

"0"

data.impermanentLoss

number | null

Impermanent loss amount

data.inputToken0

number

Initial amount of token0

Example:

0

data.inputToken1

number

Initial amount of token1

Example:

9578296184

data.tickLower

number

Lower tick of the position range

Example:

-341

data.tickUpper

number

Upper tick of the position range

Example:

-243

data.pool

string

Pool address

Example:

"CcyHh3WgYRpLMDgSRSsJ2ptneSHfrc73oR51r72pAHU7"

data.liquidity

string

Current liquidity amount

Example:

"0"

data.token0

string

Token0 address

Example:

"3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump"

data.token1

string

Token1 address

Example:

"So11111111111111111111111111111111111111112"

data.inRange

boolean

Whether the position is in range

Example:

true

data.createdAt

string<date-time>

Position creation timestamp

Example:

"2025-09-04T15:46:55.000Z"

data.updatedAt

string<date-time>

Position last update timestamp

Example:

"2025-09-04T23:08:19.000Z"

data.pnl

object

Profit and loss information

Show child attributes

data.pnl.value

number

PnL in USD

Example:

-1.1084269291922126

data.pnl.percent

number

PnL percentage

Example:

-0.05674725543499963

data.pnl.valueNative

number

PnL in native token

Example:

0.031181194298495987

data.pnl.percentNative

number

PnL percentage in native token

Example:

0.3255400929299138

data.pnlNative

number

Native token PnL

Example:

-9.260523568188033

data.upnl

number | null

Unrealized PnL

data.owner

string

Position owner address

Example:

"ACQTiYg2TMRRKo294PENtfqkBqWQ5u3D7NDpm8Te2tyG"

data.dpr

number

Daily percentage return in USD

Example:

-0.001361934130439991

data.dprNative

number

Daily percentage return in native token

Example:

0.007812962230317931

data.ageHour

number | null

Position age in hours

data.decimal0

number

Token0 decimals

Example:

6

data.decimal1

number

Token1 decimals

Example:

9

data.yield24h

number | null

24-hour yield

data.apr

number | null

Annual percentage rate

data.protocol

string

Protocol name

Example:

"meteora"

data.token0Info

object

Token0 information

Show child attributes

data.token0Info.token_symbol

string

Example:

"STREAMER"

data.token0Info.token_name

string

Example:

"StreamerCoin"

data.token0Info.token_decimals

number

Example:

6

data.token0Info.token_address

string

Example:

"3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump"

data.token0Info.logo

string | null

data.token1Info

object

Token1 information

Show child attributes

data.token1Info.token_symbol

string

Example:

"SOL"

data.token1Info.token_name

string

Example:

"Wrapped SOL"

data.token1Info.token_decimals

number

Example:

9

data.token1Info.token_address

string

Example:

"So11111111111111111111111111111111111111112"

data.token1Info.logo

string

Example:

"https://www.dextools.io/resources/tokens/logos/3/solana/So11111111111111111111111111111111111111112.jpg"

data.poolInfo

object

Pool information

Show child attributes

data.poolInfo.fee

number

Pool fee in basis points

Example:

100

data.poolInfo.tickSpacing

number

Tick spacing for the pool

Example:

125

data.age

string

Position age in days

Example:

"0.45"

data.position

string

Position identifier

Example:

"5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP"

data.logo0

string

Token0 logo URL

Example:

"https://token-logo.getnimbus.io/api/v1/logo?address=3arUrpH3nzaRJbbpVgY42dcqSq9A5BFgUxKozZ4npump&chain=SOL"

data.logo1

string

Token1 logo URL

Example:

"https://token-logo.getnimbus.io/api/v1/logo?address=So11111111111111111111111111111111111111112&chain=SOL"

data.tokenName0

string

Token0 name

Example:

"STREAMER"

data.tokenName1

string

Token1 name

Example:

"SOL"

data.priceRange

number[]

Price range array [lower, upper, current]

Example:

[
  0.0029376923002315727,
  0.009924746662859895,
  0.005535449986126866
]

data.range

number[]

Tick range array [lower, upper, current]

Example:

[-341, -243, -290]

data.value

number

Current position value in USD

Example:

1870.0445330471607

data.valueNative

number

Current position value in native token

Example:

9.207458510615153

data.current

object

Current token amounts

Show child attributes

data.current.amount0

string

Current amount of token0 (raw)

Example:

"68057177237"

data.current.amount1

string

Current amount of token1 (raw)

Example:

"7356057600"

data.current.amount0Adjusted

number

Current amount of token0 (adjusted for decimals)

Example:

68057.177237

data.current.amount1Adjusted

number

Current amount of token1 (adjusted for decimals)

Example:

7.3560576

data.unCollectedFee0

number

Uncollected fees for token0

Example:

1752.90661

data.unCollectedFee1

number

Uncollected fees for token1

Example:

0.036560864

data.unCollectedFee

number

Total uncollected fees in USD

Example:

17.110502595276436

data.unCollectedFeeNative

number

Total uncollected fees in native token

Example:

0.08424625187137592

data.price0

number

Current price of token0

Example:

0.005525081888046805

data.price1

number

Current price of token1

Example:

203.10105453

data.id

string

Unique position identifier

Example:

"26e3d33a2ba9a95f1021e0115e40f132:c8a2a48b6fab04a1781d0a1d515713d3c2d43ef1d4770665b95baf504e91f8aa78c8ef77fa5898db01fc9f0cda863796"

data.creationType

string

How the position was created

Example:

"AUTO"

data.followInfo

object

Information about followed positions

Show child attributes

data.followInfo.sourceOwner

string

Source owner identifier

Example:

"bb7b777b80b3948b3910aac6cfb85a6b:554f1dcb15f76893c41d150c6ddaa1d44a117fcff191a75a2052e4980e3f00d213cf4b7374a1e1dd1392ead036a9cd60"

data.followInfo.sourceLabel

string

Source label/name

Example:

"Twenti"

data.followInfo.sourceTokenId

string

Source token ID

Example:

"651fa1c45f7188731b4e585c4131217e:ed5bdc892f6456accb1a79b4792efa841d385cb83967e12684950399de07892c2bc52028e6c6513df01a57ccc62f2ba9"

data.settings

object

Position management settings

Show child attributes

data.settings.autoCompound

boolean

Whether auto-compound is enabled

Example:

false

data.settings.compoundThreshold

string

Threshold for auto-compound

Example:

"0"

data.settings.autoRebalance

boolean

Whether auto-rebalance is enabled

Example:

false

data.settings.aiManage

boolean

Whether AI management is enabled

Example:

false

data.settings.rebalanceInterval

number

Rebalance interval

Example:

1

data.settings.rebalanceUpOnly

boolean

Whether to rebalance up only

Example:

false

data.settings.takeProfitBps

number

Take profit threshold in basis points

Example:

1000

data.settings.stopLossBps

number

Stop loss threshold in basis points

Example:

2000

data.settings.preferNativeValue

boolean

Whether to prefer native value display

Example:

false

data.settings.positionCurrency

string

Currency for position display

Example:

"SOL"

data.logs

object[]

Position activity logs

Show child attributes

data.logs.position_id

string

Position ID

Example:

"5tTjw7V7b5QV7xL6jj5RUfV45QWMugYzENSTLZYvp1TP"

data.logs.trigger

string

Event trigger type

Example:

"COLLECT_FEE_SUCCESS"

data.logs.created_at

string<date-time>

Log entry timestamp

Example:

"2025-09-04T23:08:23.013Z"

Get overview metrics for LP positions Get logs for LP positions

⌘I

API

positions

Authorizations

Query Parameters

Response