liquidityLocksV2

​

Example

{
  liquidityLocksV2(
    pairAddress: "8WwcNqdZjCY5Pt7AkhupAFknV2txca9sq6YBkGzLbvdt"
    networkId: 1399811149
  ) {
    items {
      pairAddress
      networkId
      liquidityProtocol
      liquidity
      locked
      lockedPercent
      permanentLocked
      vestedLocked
      unlocked
      nextReleasePoint
      updatedAt
      current
      holders {
        entityId
        displayName
        lockProtocol
        amount
        permanent
        unlockAt
        shared
      }
    }
    cursor
  }
}

​

Usage Guidelines

• Query by pairAddress for one pool, or by tokenAddress for every pool containing that token. networkId is required.
• Every result is a read of current on-chain state (the locker’s own registry, the launch hook’s position, the protocol’s lock accounts), not a replay of past lock events. A lock created before Codex indexed a protocol reads the same as one created today.
• lockedPercent is 0–100 and is locked / liquidity from the same read, so it can never exceed 100. Note that lockedLiquidityPercentage on liquidityMetadataByToken is 0–1.
• locked is permanentLocked plus vestedLocked. permanentLocked is burned LP or a lock with no withdraw path; vestedLocked sits behind an unlock date. unlocked is everything else, including expired locks.
• Vesting is matured at read time. Once a lock’s unlockAt passes it moves from vestedLocked to unlocked, whether or not the LP has been withdrawn from the locker. nextReleasePoint is when the next vested tranche matures, in the pool’s own clock units (block, slot or seconds depending on the lock). Use holders[].unlockAt (unix seconds) for dates.
• holders attributes locked liquidity to whoever custodies it. lockProtocol is null for custodians the LiquidityLockProtocol enum cannot name, so use displayName or entityId to identify them. When shared is true, several holders name the same liquidity; count it once.
• updatedAt is when the state read was taken. Pools are re-read whenever liquidity is added or removed, and reconciled on a six-hour sweep. current: false means vesting could not be matured to now and the figures are as of that last refresh.
• Use cursor to page through token-level results.

​

Coverage

​

Troubleshooting Tips