Get position PnL data (open and closed positions with on-the-fly calculation)

curl --request GET \
  --url https://dlmm.datapi.meteora.ag/positions/{pool_address}/pnl

const options = {method: 'GET'};

fetch('https://dlmm.datapi.meteora.ag/positions/{pool_address}/pnl', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET'};

fetch('https://dlmm.datapi.meteora.ag/positions/{pool_address}/pnl', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://dlmm.datapi.meteora.ag/positions/{pool_address}/pnl

false

{
  "hasNext": true,
  "page": 1,
  "pageSize": 1,
  "positions": [
    {
      "allTimeDeposits": {
        "tokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "tokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "total": {
          "usd": "<string>",
          "sol": "<string>"
        }
      },
      "allTimeFees": {
        "tokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "tokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "total": {
          "usd": "<string>",
          "sol": "<string>"
        }
      },
      "allTimeWithdrawals": {
        "tokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "tokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "total": {
          "usd": "<string>",
          "sol": "<string>"
        }
      },
      "feePerTvl24h": "<string>",
      "isClosed": true,
      "lowerBinId": 123,
      "maxPrice": "<string>",
      "minPrice": "<string>",
      "pnlPctChange": "<string>",
      "pnlUsd": "<string>",
      "positionAddress": "<string>",
      "upperBinId": 123,
      "closedAt": 123,
      "createdAt": 123,
      "isOutOfRange": true,
      "pnlSol": 123,
      "pnlSolPctChange": 123,
      "poolActiveBinId": 123,
      "poolActivePrice": "<string>",
      "unrealizedPnl": {
        "balanceTokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "balanceTokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "balances": 123,
        "unclaimedFeeTokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "unclaimedFeeTokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "unclaimedRewardTokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "unclaimedRewardTokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "balancesSol": "<string>"
      }
    }
  ],
  "rewardTokenXPrice": "<string>",
  "rewardTokenYPrice": "<string>",
  "tokenXPrice": "<string>",
  "tokenYPrice": "<string>",
  "totalCount": 1,
  "rewardTokenX": "<string>",
  "rewardTokenY": "<string>",
  "solPrice": "<string>",
  "tokenX": "<string>",
  "tokenY": "<string>"
}

Positions

Get position PnL data (open and closed positions with on-the-fly calculation)

Returns positions for a specific pool and user with calculated PnL values. Includes SOL-denominated amounts when SOL price is available (omitted otherwise). Results can be filtered by status (open/closed) and are paginated.

Arguments

pool_address - The address of the pool
user - The user address
status - Filter by status: “open”, “closed”, or omit for all (default: all)
page - Page number starting from 1 (default: 1)

Returns

200 - Paginated list of positions with PnL data in USD and SOL

GET

positions

{pool_address}

pnl

Get position PnL data (open and closed positions with on-the-fly calculation)

curl --request GET \
  --url https://dlmm.datapi.meteora.ag/positions/{pool_address}/pnl

const options = {method: 'GET'};

fetch('https://dlmm.datapi.meteora.ag/positions/{pool_address}/pnl', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

const options = {method: 'GET'};

fetch('https://dlmm.datapi.meteora.ag/positions/{pool_address}/pnl', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

curl --request GET \
  --url https://dlmm.datapi.meteora.ag/positions/{pool_address}/pnl

false

{
  "hasNext": true,
  "page": 1,
  "pageSize": 1,
  "positions": [
    {
      "allTimeDeposits": {
        "tokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "tokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "total": {
          "usd": "<string>",
          "sol": "<string>"
        }
      },
      "allTimeFees": {
        "tokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "tokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "total": {
          "usd": "<string>",
          "sol": "<string>"
        }
      },
      "allTimeWithdrawals": {
        "tokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "tokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "total": {
          "usd": "<string>",
          "sol": "<string>"
        }
      },
      "feePerTvl24h": "<string>",
      "isClosed": true,
      "lowerBinId": 123,
      "maxPrice": "<string>",
      "minPrice": "<string>",
      "pnlPctChange": "<string>",
      "pnlUsd": "<string>",
      "positionAddress": "<string>",
      "upperBinId": 123,
      "closedAt": 123,
      "createdAt": 123,
      "isOutOfRange": true,
      "pnlSol": 123,
      "pnlSolPctChange": 123,
      "poolActiveBinId": 123,
      "poolActivePrice": "<string>",
      "unrealizedPnl": {
        "balanceTokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "balanceTokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "balances": 123,
        "unclaimedFeeTokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "unclaimedFeeTokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "unclaimedRewardTokenX": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "unclaimedRewardTokenY": {
          "amount": "<string>",
          "usd": "<string>",
          "amountSol": "<string>"
        },
        "balancesSol": "<string>"
      }
    }
  ],
  "rewardTokenXPrice": "<string>",
  "rewardTokenYPrice": "<string>",
  "tokenXPrice": "<string>",
  "tokenYPrice": "<string>",
  "totalCount": 1,
  "rewardTokenX": "<string>",
  "rewardTokenY": "<string>",
  "solPrice": "<string>",
  "tokenX": "<string>",
  "tokenY": "<string>"
}

Path Parameters

pool_address

string

required

Query Parameters

user

string

required

The user's wallet address

status

enum<string>

Filter positions by status: "open", "closed", or "all" (default: "all")

Available options:

open,

closed,

all

page

integer<int32>

Page number for pagination (minimum: 1, default: 1)

Required range: x >= 0

page_size

integer<int32>

Page size for pagination (minimum: 1, maximum: 100, default: 20)

Required range: x >= 0

Response

200 - application/json

hasNext

boolean

required

page

integer<int32>

required

Required range: x >= 0

pageSize

integer<int32>

required

Required range: x >= 0

positions

object[]

required

Show child attributes

rewardTokenXPrice

string

required

rewardTokenYPrice

string

required

tokenXPrice

string

required

tokenYPrice

string

required

totalCount

integer<int64>

required

Required range: x >= 0

rewardTokenX

string | null

rewardTokenY

string | null

solPrice

string | null

tokenX

string | null

tokenY

string | null

Get the historical events for a position

Protocol Overview

⌘I

Program

TypeScript SDK

Rust Integration

API Reference

Get position PnL data (open and closed positions with on-the-fly calculation)

Arguments

Returns

Path Parameters

Query Parameters

Response