Skip to content
/
LiquidityBalance

GraphQL Overview

Download GraphQL schema
index.graphql

Queries

Overview

Subscriptions

Overview

Directives

Overview

Objects

Overview

QueryPoolsConnection

edges
[QueryPoolsConnectionEdge!]!,non-null
pageInfo
PageInfo!,non-null
totalCount
Int!,non-null
Sample
{
  "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
}

QueryPoolsConnectionEdge

cursor
String!,non-null
node
Pool!,non-null
Sample
{
  "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"
    }
  }
}
Referenced in
QueryPoolsConnection.edges

PoolTransaction

A swap transaction in a pool

id
ID!,non-null

Unique identifier

maker
String!,non-null

User who made the swap

amount0In
Decimal!,non-null

Amount of token0 swapped in

amount1In
Decimal!,non-null

Amount of token1 swapped in

amount0Out
Decimal!,non-null

Amount of token0 swapped out

amount1Out
Decimal!,non-null

Amount of token1 swapped out

amountUsd
Decimal!,non-null

Total amount in USD

timestamp
DateTime!,non-null

Transaction timestamp

transactionId
Int

ID of the transaction

requestkey
String!,non-null

Request key of the transaction

transactionType
PoolTransactionType!,non-null

The type of transaction

Sample
{
  "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"
}
Referenced in
PoolTransactionEdge.node

PoolTransactionsConnection

Connection type for pool transactions

edges
[PoolTransactionEdge!],non-null

List of transaction edges

pageInfo
PageInfo

Pagination information

totalCount
Int

Total number of transactions

Sample
{
  "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
}
Referenced in
Pool.transactions

PoolTransactionEdge

Edge type for pool transactions

cursor
String!,non-null

Cursor for pagination

node
PoolTransaction!,non-null

The transaction node

Sample
{
  "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"
  }
}
Referenced in
PoolTransactionsConnection.edges

LiquidityBalance

id
Int!,non-null
pairId
String!,non-null
liquidity
String!,non-null
walletAddress
String!,non-null
pair
Pool!,non-null
createdAt
DateTime!,non-null
updatedAt
DateTime!,non-null
Sample
{
  "id": 40,
  "pairId": "Example String",
  "liquidity": "Example String",
  "walletAddress": "Example String",
  "pair": {
    "__typename": "Pool"
  },
  "createdAt": "Example Custom Scalar",
  "updatedAt": "Example Custom Scalar"
}

LiquidityPosition

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.

id
ID!,non-null

Globally unique identifier for this liquidity position.

pairId
String!,non-null

The unique identifier (pair ID) of the pool this position belongs to.

liquidity
String!,non-null

The total liquidity tokens held by this account in the pool. Returned as a string to preserve precision.

walletAddress
String!,non-null

The Kadena account address that owns this liquidity position. Example: "k:abcd1234..."

valueUsd
Decimal!,non-null

The current USD value of the user's liquidity position, calculated using DIA pricing data.

apr24h
Decimal!,non-null

The 24-hour annualized percentage rate (APR) earned by this position based on recent pool activity.

pair
Pool!,non-null

Detailed information about the pool associated with this position.

createdAt
DateTime!,non-null

Timestamp when this liquidity position was first created.

updatedAt
DateTime!,non-null

Timestamp when this liquidity position was last updated.

Sample
{
  "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"
}
Referenced in
LiquidityPositionEdge.node

LiquidityPositionsConnection

edges
[LiquidityPositionEdge!]!,non-null
pageInfo
PageInfo!,non-null
totalCount
Int!,non-null
Sample
{
  "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
}

LiquidityPositionEdge

cursor
String!,non-null
node
LiquidityPosition!,non-null
Sample
{
  "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"
  }
}
Referenced in
LiquidityPositionsConnection.edges

DexMetrics

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).

totalPools
Int!,non-null

The total number of liquidity pools deployed under the protocol.

currentTvlUsd
Decimal!,non-null

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.

tvlHistory
[ChartDataPoint!]!,non-null

Historical time-series data points representing TVL evolution over the selected time range. Useful for charting liquidity growth and analyzing protocol trends.

volumeHistory
[ChartDataPoint!]!,non-null

Historical time-series data points representing trading volume over the selected time range. Useful for charting market activity and usage patterns.

totalVolumeUsd
Decimal!,non-null

The total cumulative trading volume (in USD) observed over the specified time range.

Sample
{
  "totalPools": 40,
  "currentTvlUsd": "Example Custom Scalar",
  "tvlHistory": [
    {
      "__typename": "ChartDataPoint"
    }
  ],
  "volumeHistory": [
    {
      "__typename": "ChartDataPoint"
    }
  ],
  "totalVolumeUsd": "Example Custom Scalar"
}

TokenPrice

Represents the latest known price information for a specific token.

TokenPrice provides the current valuation of a token in both KDA (the Kadena native token) and USD, along with metadata about the protocol where the token is traded and the timestamp of the most recent price update.

id
ID!,non-null

Globally unique identifier for this token price entry.

token
Token!,non-null

The token associated with this price data.

priceInKda
Decimal!,non-null

The current price of the token denominated in KDA.

priceInUsd
Decimal!,non-null

The current price of the token denominated in USD.

protocolAddress
String!,non-null

The protocol/module name on Kadena where this price was retrieved from.

updatedAt
DateTime!,non-null

The timestamp of the most recent price update.

Sample
{
  "id": "9cfb1c81-4c79-452f-b1f5-8ee6571276b4",
  "token": {
    "__typename": "Token"
  },
  "priceInKda": "Example Custom Scalar",
  "priceInUsd": "Example Custom Scalar",
  "protocolAddress": "Example String",
  "updatedAt": "Example Custom Scalar"
}

Interfaces

Overview

Unions

Overview

Enums

Overview

Inputs

Overview

Scalars

Overview