{"uid":"cap_55P_rrxaYRwzmea3rs28E","slug":"liquidity-lock-inspector-966b7558","name":"Liquidity Lock Inspector","description":"Share of a token's LP tokens that are burned (dead or zero address) or locked, from GoPlus lp_holders on Ethereum, BSC, Base, Arbitrum or Polygon. Lists the top 10 LP holders with GoPlus's lock flag and tag (a locker's name only when GoPlus gives it). Does not query Uncx, Team.Finance or Streamflow directly.","url":"https://api.fadeandco.workers.dev/api/agent-intel/liquidity-lock-inspector?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["address"],"properties":{"chain":{"type":"string","description":"ethereum, bsc, base, arbitrum or polygon (default ethereum)"},"address":{"type":"string","description":"Token contract address 0x... (40 hex characters)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"ethereum","source":"https://api.gopluslabs.io/api/v1/token_security/","symbol":"PEPE","address":"0x6982508145454ce325ddbe47a25d4ec3d2311933","verdict":"MOSTLY_UNLOCKED","checkedAt":"2026-10-23T09:35:17.635Z","burnedShare":0.0001,"lockedShare":0.0001,"topLpHolders":[{"tag":null,"locked":false,"address":"0x6982508145454ce325ddbe47a25d4ec3d2311933","percent":0.9937586648113556},{"tag":null,"locked":false,"address":"0x7a6a59588b8106045303e1923227a2cefbec2b66","percent":0.00186923323350786}],"lpHolderCount":78,"lpTotalSupply":"28163719.113899650905949868"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-DXJIuuOOYm5nCftkAOK6","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the burned and locked share of a token's LP tokens, plus the top 10 LP holders with lock status, using GoPlus data on Ethereum, BSC, Base, Arbitrum, or Polygon.","exampleAgentPrompt":"Can you check how much of the liquidity is burned or locked for the PEPE token at 0x6982508145454ce325ddbe47a25d4ec3d2311933 on Ethereum, and show me the top LP holders?","exampleUseCases":[{"title":"Pre-investment LP safety check","prompt":"Before I ape into this new token, can you check if the liquidity is locked or burned for contract 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum? I want to see the top LP holders and how much is actually locked."},{"title":"BSC meme coin rug-pull screening","prompt":"I'm looking at a BSC token at 0x0e09fabb73bd3ade0a17ecc321fd13a19e81ce82 — can you pull the LP lock data and tell me what percentage is burned or locked and who the top liquidity holders are?"},{"title":"DeFi due diligence on Arbitrum","prompt":"Can you run a liquidity lock check on this Arbitrum token 0xff970a61a04b1ca14834a43f5de4533ebddb5cc8 and give me the verdict on whether the LP is mostly locked, unlocked, or burned?"}],"resultDescription":"Returns a JSON object with the token symbol, chain, a verdict string (e.g. MOSTLY_UNLOCKED, FULLY_LOCKED), the burned and locked share as decimals (0–1), LP total supply, LP holder count, and an array of up to 10 top LP holders each with their address, percentage held, a lock flag, and an optional locker tag name sourced from GoPlus.","failureModes":["Invalid or non-existent token address returns an error or empty holder list","Unsupported chain name causes a validation error","Token has no LP or GoPlus has no data for it, resulting in zero holders and null values","Rate limiting or GoPlus API outage may cause upstream failures","Non-ERC20 or non-standard LP tokens may not be recognized"],"whenToPreferThis":"Use this endpoint when you need a quick, low-cost signal on whether a token's liquidity is burned or locked, based on GoPlus data, across Ethereum, BSC, Base, Arbitrum, or Polygon. Prefer this over querying Uncx, Team.Finance, or Streamflow directly when a GoPlus-sourced verdict plus top-10 holder breakdown is sufficient. It is ideal for pre-investment screening, rug-pull risk assessment, and DeFi due diligence pipelines where on-chain locker contract verification is not required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:40:36.220Z","isFirstParty":false,"canonicalSlug":"liquidity-lock-inspector-966b7558"}