{"uid":"cap_pqs1b34EoJDtn8bwqyhRk","slug":"kette-lp-token-liquidity-ownership-analyzer-a6fc4631","name":"Kette LP Token Liquidity Ownership Analyzer","description":"Reads the holders of an LP token and splits them into burned, locked in a named locker, and free. Burned and locked are two different things and are reported separately - burned is gone for good, locked comes back. A locker contract that is not in the curated table yields is_locker \"unbekannt\" rather than false, because an unknown lock contract is not the same as a demonstrably free holder. Limits: earliest_unlock_ts is NOT read - the unlock time lives inside each locker contract in its own layo","url":"https://kette.halowerk.com/token/liquidity-ownership","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"pool":{"type":"string","description":"Address of the liquidity pool (the LP token contract), 0x followed by 40 hex characters."},"chain":{"type":"string","description":"Chain identifier, for example ethereum, base, arbitrum or optimism."},"top_n":{"type":"integer","default":30,"maximum":100,"minimum":10,"description":"How many LP holders to examine. Default 30."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.006","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.006/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.006","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wHMFqvD7SV4IvrJNlYsLG","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.006","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes the holders of an LP (liquidity provider) token and categorizes them into burned (permanently removed), locked (held in named locker contracts), and free (circulating) supply, with curated locker identification.","exampleAgentPrompt":"Can you check the LP token ownership for this Uniswap pair token at 0xABC123... on Ethereum and tell me how much of the liquidity is burned, how much is locked in a named locker, and how much is free to be withdrawn?","exampleUseCases":[{"title":"Rug pull risk check before investing","prompt":"Before I ape into this new token, can you check the LP token at 0x4e2f1a3b... on Base and tell me whether the liquidity is burned, locked in something like Team Finance or Unicrypt, or just sitting free where the devs could pull it?"},{"title":"DeFi project due diligence report","prompt":"I'm writing a safety report on this project — can you pull the LP token holder breakdown for 0x9c3d8a7e... on Arbitrum and split it into burned, locked with a named locker contract, and free holders?"},{"title":"Liquidity lock verification for a token listing","prompt":"We're considering listing this token and need to verify liquidity security — please analyze the LP token 0x1f7b2c9a... on BNB Smart Chain and tell me what share is permanently burned, what's in a recognized locker, and what's still freely held."}],"resultDescription":"Returns a breakdown of LP token holders grouped into three categories: burned (permanently destroyed, gone from circulation), locked (held in locker contracts — named if in the curated table, or flagged as 'unbekannt' if the locker is unrecognized), and free (fully circulating and withdrawable). Each holder entry includes the is_locker flag with the locker's name or 'unbekannt' for unknown contracts. Does not include earliest_unlock_ts as unlock time requires reading each individual locker contract.","failureModes":["Token address not found or invalid — returns error with address details","Unsupported chain — endpoint may not index all EVM chains","Block explorer index unavailable — data cannot be fetched","Locker contract not in curated table — returns is_locker: 'unbekannt' rather than false, indicating uncertainty","Rate limit or payment failure — x402 payment required per call"],"whenToPreferThis":"Use this endpoint when you need to assess the security and lock status of a DeFi project's liquidity by examining LP token holders on-chain. It is specifically designed to distinguish between burned (irreversible) and locked (temporary) liquidity — a distinction most generic holder tools collapse. The curated locker table adds named identification for common locker contracts, making it more reliable than raw holder analysis. Prefer this over generic ERC-20 holder endpoints when the token in question is a Uniswap/DEX LP token and you specifically need liquidity security analysis.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:43:40.390Z","isFirstParty":false}