# pool

**Type:** GraphQL queries

**Description:**
Retrieve a specific liquidity pool by its unique ID.

This query returns detailed information about a single AMM liquidity pool, including its reserves,
paired tokens, TVL, trading volume, APR, and recent performance metrics.
It’s commonly used by explorers, dashboards, and analytics tools to power individual pool detail views.

You can optionally provide a `timeFrame` to shape the data returned in metrics and charts, and a `type`
to filter transactions by category (e.g., swaps, adds, removes).

⚠️ **Note:** While `first`, `after`, `last`, and `before` arguments are accepted for API consistency,
they are **not used** by the internal resolvers of this query. Pagination of pool transactions is handled
by the parent pool resolver, not directly here.

## Arguments
- id (ID): The globally unique ID of the pool to retrieve.
- timeFrame (TimeFrame): Optional time frame used for calculating and returning chart data.

- type (PoolTransactionType): Optional transaction type filter (e.g., swaps, adds, removes) applied to the returned transactions.

- first (Int): Accepted for API consistency but **not used** by this resolver.
- after (String): Accepted for API consistency but **not used** by this resolver.
- last (Int): Accepted for API consistency but **not used** by this resolver.
- before (String): Accepted for API consistency but **not used** by this resolver.

## Response
**Type:** Pool
**Description:**
Represents an automated market maker (AMM) liquidity pool for a pair of tokens.

A `Pool` tracks on-chain reserves, liquidity (LP) supply, pricing-derived metrics (TVL, volume, fees),
and short-term performance indicators (24h / 7d deltas). Prices used to compute TVL/volume/fees
are sourced from DIA and refreshed periodically. Use this type to power pool lists, detail pages,
analytics dashboards, and historical charts.

Note: Numeric reserve and supply values are returned as strings to preserve precision.

### Fields
- 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.