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

## 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
  DOPPLER
  O1_EXCHANGE
  MINARA
  PONS_V2
  METAPLEX_GENESIS
  PINKSALE
  TEAM_FINANCE
  LAUNCH_FAIR
  BAGS
  RAYDIUM_LOCK
  LETSCASH
  PAIR
  LAUNCH_HOOK
  LUNCH_FUN
  LAUNCH_TAX_HOOK
  PEACH
  FOCI
  LIFT
  LONG_SUPPLY
  TOLLY
  FLYWHEEL
  REALM
}

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

### Used By

**Returned by**

* [liquidityMetadataByToken](https://docs.codex.io/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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.