> ## Documentation Index
> Fetch the complete documentation index at: https://docs.codex.io/llms.txt
> Use this file to discover all available pages before exploring further.

# LiquidityMetadataByToken

> Metadata about a token's liquidity. Includes locked liquidity data for up to 100 pairs that the token is in.

<div data-generated>
  ## GraphQL

  ```
  type LiquidityMetadataByToken {
    tokenAddress: String!
    networkId: Int!
    totalLiquidityUsd: String!
    lockedLiquidityUsd: String!
    totalTokenLiquidity: String!
    totalTokenLiquidityShifted: String!
    lockedTokenLiquidity: String!
    lockedTokenLiquidityShifted: String!
    lockedLiquidityPercentage: Float!
    lockBreakdown: [LiquidityLockBreakdownForToken]!
  }

  enum LiquidityLockProtocol {
    BASECAMP_V1
    UNCX_V2
    UNCX_V3
    BURN
    BITBOND
    METEORA_DAMM_V2
  }

  type LiquidityLockBreakdownForToken {
    lockProtocol: LiquidityLockProtocol!
    amountLockedUsd: String!
    amountLockedTokens: String!
    amountLockedTokensShifted: String!
  }
  ```

  ### Used By

  **Returned by**

  * [liquidityMetadataByToken](/api-reference/queries/liquiditymetadatabytoken.md): Returns liquidity metadata for a given token. Includes liquidity lock data for up to 100 pairs that the token is in.
</div>