# LiquidityPosition

**Type:** GraphQL objects

**Description:**
Represents a user's liquidity position within a specific AMM pool.

A `LiquidityPosition` tracks how much liquidity a given account has supplied to a pool,
along with its current USD value, 24-hour APR, and metadata about the associated pool.
It is typically used by wallets, dashboards, and DeFi analytics tools to display portfolio holdings,
yield performance, and pool-specific details for a user's positions.

## Fields
- id (ID): Globally unique identifier for this liquidity position.
- pairId (String): The unique identifier (pair ID) of the pool this position belongs to.
- liquidity (String): The total liquidity tokens held by this account in the pool.
Returned as a string to preserve precision.
- walletAddress (String): The Kadena account address that owns this liquidity position.
Example: `"k:abcd1234..."`
- valueUsd (Decimal): The current USD value of the user's liquidity position, calculated using DIA pricing data.
- apr24h (Decimal): The 24-hour annualized percentage rate (APR) earned by this position based on recent pool activity.
- pair (Pool, Not Null): Detailed information about the pool associated with this position.
  - id (ID): Globally unique identifier for this pool node.
  - address (String): The on-chain address / module reference for this pool.
  - token0 (Token): The first token in the pair (base/slot-0).
  - token1 (Token): The second token in the pair (quote/slot-1).
  - reserve0 (String): Current on-chain reserve of `token0` held by the pool (as a string for full precision).
  - reserve1 (String): Current on-chain reserve of `token1` held by the pool (as a string for full precision).
  - totalSupply (String): Total supply of the pool’s LP (liquidity provider) tokens (as a string for full precision).
  - key (String): A stable key for the pool (e.g., a deterministic pair identifier).
  - tvlUsd (Float): Total value locked (USD) in this pool, derived from reserves and external pricing.
  - tvlChange24h (Float): 24-hour percentage change in TVL.
  - volume24hUsd (Float): Notional 24-hour traded volume (USD).
  - volumeChange24h (Float): 24-hour percentage change in volume.
  - volume7dUsd (Float): Notional 7-day traded volume (USD).
  - fees24hUsd (Float): Notional 24-hour fees accrued by the pool (USD).
  - feesChange24h (Float): 24-hour percentage change in fees.
  - transactionCount24h (Int): Count of pool transactions over the last 24 hours.
  - transactionCountChange24h (Float): 24-hour percentage change in transaction count.
  - apr24h (Float): 24-hour APR estimate derived from recent fees relative to TVL (as a percentage).
  - createdAt (DateTime): Timestamp when this pool record was created.
  - updatedAt (DateTime): Timestamp when this pool record was last updated.
  - charts (PoolCharts): Get chart/series data for this pool over a specified timeframe (e.g., TVL, volume).
  - transactions (PoolTransactionsConnection): Get transactions related to this pool, with optional type filtering and cursor-based pagination.
- createdAt (DateTime): Timestamp when this liquidity position was first created.
- updatedAt (DateTime): Timestamp when this liquidity position was last updated.