- PoolTransactionEdge
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.
Globally unique identifier for this pool node.
The on-chain address / module reference for this pool.
The first token in the pair (base/slot-0).
The second token in the pair (quote/slot-1).
Current on-chain reserve of token0 held by the pool (as a string for full precision).
Current on-chain reserve of token1 held by the pool (as a string for full precision).
Total supply of the pool’s LP (liquidity provider) tokens (as a string for full precision).
A stable key for the pool (e.g., a deterministic pair identifier).
Total value locked (USD) in this pool, derived from reserves and external pricing.
24-hour percentage change in TVL.
Notional 24-hour traded volume (USD).
24-hour percentage change in volume.
Notional 7-day traded volume (USD).
Notional 24-hour fees accrued by the pool (USD).
24-hour percentage change in fees.
Count of pool transactions over the last 24 hours.
24-hour percentage change in transaction count.
24-hour APR estimate derived from recent fees relative to TVL (as a percentage).
Timestamp when this pool record was created.
Timestamp when this pool record was last updated.
Get chart/series data for this pool over a specified timeframe (e.g., TVL, volume).
Get transactions related to this pool, with optional type filtering and cursor-based pagination.
Implements interfaces
A globally identifiable object in the GraphQL schema.
All core entities in this API implement the Node interface, which guarantees that they have
a unique id field, enabling consistent caching, pagination, and reference resolution across the API.
{ "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "address": "Example String", "token0": { "__typename": "Token" }, "token1": { "__typename": "Token" }, "reserve0": "Example String", "reserve1": "Example String", "totalSupply": "Example String", "key": "Example String", "tvlUsd": 40, "tvlChange24h": 40, "volume24hUsd": 40, "volumeChange24h": 40, "volume7dUsd": 40, "fees24hUsd": 40, "feesChange24h": 40, "transactionCount24h": 40, "transactionCountChange24h": 40, "apr24h": 40, "createdAt": "Example Custom Scalar", "updatedAt": "Example Custom Scalar", "charts": { "__typename": "PoolCharts" }, "transactions": { "__typename": "PoolTransactionsConnection" } }
{ "edges": [ { "cursor": "Example String", "node": { "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "address": "Example String", "token0": { "__typename": "Token" }, "token1": { "__typename": "Token" }, "reserve0": "Example String", "reserve1": "Example String", "totalSupply": "Example String", "key": "Example String", "tvlUsd": 40, "tvlChange24h": 40, "volume24hUsd": 40, "volumeChange24h": 40, "volume7dUsd": 40, "fees24hUsd": 40, "feesChange24h": 40, "transactionCount24h": 40, "transactionCountChange24h": 40, "apr24h": 40, "createdAt": "Example Custom Scalar", "updatedAt": "Example Custom Scalar", "charts": { "__typename": "PoolCharts" }, "transactions": { "__typename": "PoolTransactionsConnection" } } } ], "pageInfo": { "startCursor": "Example String", "endCursor": "Example String", "hasNextPage": true, "hasPreviousPage": true }, "totalCount": 40 }
{ "cursor": "Example String", "node": { "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "address": "Example String", "token0": { "__typename": "Token" }, "token1": { "__typename": "Token" }, "reserve0": "Example String", "reserve1": "Example String", "totalSupply": "Example String", "key": "Example String", "tvlUsd": 40, "tvlChange24h": 40, "volume24hUsd": 40, "volumeChange24h": 40, "volume7dUsd": 40, "fees24hUsd": 40, "feesChange24h": 40, "transactionCount24h": 40, "transactionCountChange24h": 40, "apr24h": 40, "createdAt": "Example Custom Scalar", "updatedAt": "Example Custom Scalar", "charts": { "__typename": "PoolCharts" }, "transactions": { "__typename": "PoolTransactionsConnection" } } }
A swap transaction in a pool
Unique identifier
User who made the swap
Amount of token0 swapped in
Amount of token1 swapped in
Amount of token0 swapped out
Amount of token1 swapped out
Total amount in USD
Transaction timestamp
ID of the transaction
Request key of the transaction
The type of transaction
{ "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "maker": "Example String", "amount0In": "Example Custom Scalar", "amount1In": "Example Custom Scalar", "amount0Out": "Example Custom Scalar", "amount1Out": "Example Custom Scalar", "amountUsd": "Example Custom Scalar", "timestamp": "Example Custom Scalar", "transactionId": 40, "requestkey": "Example String", "transactionType": "SWAP" }
Connection type for pool transactions
List of transaction edges
Pagination information
Total number of transactions
{ "edges": [ { "cursor": "Example String", "node": { "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "maker": "Example String", "amount0In": "Example Custom Scalar", "amount1In": "Example Custom Scalar", "amount0Out": "Example Custom Scalar", "amount1Out": "Example Custom Scalar", "amountUsd": "Example Custom Scalar", "timestamp": "Example Custom Scalar", "transactionId": 40, "requestkey": "Example String", "transactionType": "SWAP" } } ], "pageInfo": { "startCursor": "Example String", "endCursor": "Example String", "hasNextPage": true, "hasPreviousPage": true }, "totalCount": 40 }
Edge type for pool transactions
Cursor for pagination
The transaction node
{ "cursor": "Example String", "node": { "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "maker": "Example String", "amount0In": "Example Custom Scalar", "amount1In": "Example Custom Scalar", "amount0Out": "Example Custom Scalar", "amount1Out": "Example Custom Scalar", "amountUsd": "Example Custom Scalar", "timestamp": "Example Custom Scalar", "transactionId": 40, "requestkey": "Example String", "transactionType": "SWAP" } }
{ "id": 40, "pairId": "Example String", "liquidity": "Example String", "walletAddress": "Example String", "pair": { "__typename": "Pool" }, "createdAt": "Example Custom Scalar", "updatedAt": "Example Custom Scalar" }
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.
Globally unique identifier for this liquidity position.
The unique identifier (pair ID) of the pool this position belongs to.
The total liquidity tokens held by this account in the pool. Returned as a string to preserve precision.
The Kadena account address that owns this liquidity position.
Example: "k:abcd1234..."
The current USD value of the user's liquidity position, calculated using DIA pricing data.
The 24-hour annualized percentage rate (APR) earned by this position based on recent pool activity.
Detailed information about the pool associated with this position.
Timestamp when this liquidity position was first created.
Timestamp when this liquidity position was last updated.
{ "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "pairId": "Example String", "liquidity": "Example String", "walletAddress": "Example String", "valueUsd": "Example Custom Scalar", "apr24h": "Example Custom Scalar", "pair": { "__typename": "Pool" }, "createdAt": "Example Custom Scalar", "updatedAt": "Example Custom Scalar" }
{ "edges": [ { "cursor": "Example String", "node": { "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "pairId": "Example String", "liquidity": "Example String", "walletAddress": "Example String", "valueUsd": "Example Custom Scalar", "apr24h": "Example Custom Scalar", "pair": { "__typename": "Pool" }, "createdAt": "Example Custom Scalar", "updatedAt": "Example Custom Scalar" } } ], "pageInfo": { "startCursor": "Example String", "endCursor": "Example String", "hasNextPage": true, "hasPreviousPage": true }, "totalCount": 40 }
{ "cursor": "Example String", "node": { "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4", "pairId": "Example String", "liquidity": "Example String", "walletAddress": "Example String", "valueUsd": "Example Custom Scalar", "apr24h": "Example Custom Scalar", "pair": { "__typename": "Pool" }, "createdAt": "Example Custom Scalar", "updatedAt": "Example Custom Scalar" } }
Aggregated performance metrics for a decentralized exchange (DEX).
DexMetrics provides a snapshot and historical overview of network-wide DeFi activity,
including total liquidity (TVL), trading volume, and the number of active pools.
It is designed for powering dashboards, analytics views, and protocol-level insights.
All USD-denominated values (TVL, volume) are calculated using price data from DIA, and historical data is shaped by the time range specified in the query (defaults to 30 days if none is provided).
The total number of liquidity pools deployed under the protocol.
The current total value locked (TVL) across all pools, expressed in USD. This reflects the combined liquidity available in the protocol at the time of the query.
Historical time-series data points representing TVL evolution over the selected time range. Useful for charting liquidity growth and analyzing protocol trends.
Historical time-series data points representing trading volume over the selected time range. Useful for charting market activity and usage patterns.
The total cumulative trading volume (in USD) observed over the specified time range.
{ "totalPools": 40, "currentTvlUsd": "Example Custom Scalar", "tvlHistory": [ { "__typename": "ChartDataPoint" } ], "volumeHistory": [ { "__typename": "ChartDataPoint" } ], "totalVolumeUsd": "Example Custom Scalar" }