{"uid":"cap_KbUbJJO3OTcSyCb3roKr8","slug":"token-lock-vesting-check-via-x-lock-2adf747b","name":"Token Lock/Vesting Check via X-Lock","description":"Check if a token or LP is locked before you buy, via X-Lock by Liquid Logic X: send an ERC-20 address (optional chain; default all 11, incl. Base, Ethereum, BNB, XRPL EVM), get locks, unlock dates, claimable and % of supply locked. $0.005 USDC on Base.","url":"https://audit.liquidlogicx.com/api/lock-status?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":["token"],"properties":{"chain":{"enum":["base","bnb","ethereum","arbitrum","polygon","avalanche","optimism","arc","tempo","robinhood","xrplevm"],"type":"string","description":"Optional. One chain key (chain id or eip155:<id> also accepted). Omit to scan all 11 X-Lock chains."},"token":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"ERC-20 token contract address (or LP token) to check."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["token","isLocked","checkedAt","chainsChecked","chainsFailed","totalLocks","chains"],"properties":{"token":{"type":"string"},"chains":{"type":"array","items":{"type":"object","properties":{"caip2":{"type":"string"},"chain":{"type":"string"},"error":{"type":"string"},"locks":{"type":"array","items":{"type":"object","properties":{"end":{"type":"string","format":"date-time","description":"Fully unlocked at"},"kind":{"enum":["timelock","vesting"],"type":"string"},"cliff":{"type":"string","format":"date-time"},"start":{"type":"string","format":"date-time"},"amount":{"type":"string","description":"Amount deposited (token units, decimal string)"},"lockId":{"type":"integer"},"status":{"enum":["locked","vesting","unlocked","fully_released"],"type":"string"},"creator":{"type":"string"},"lockUrl":{"type":"string","description":"Public X-Lock page for this lock"},"released":{"type":"string","description":"Already withdrawn by beneficiary"},"amountRaw":{"type":"string","description":"Amount in base units"},"claimable":{"type":"string","description":"Vested but not yet withdrawn"},"lockWallet":{"type":"string","description":"Per-lock wallet contract holding the tokens"},"beneficiary":{"type":"string"},"stillLocked":{"type":"string","description":"Not yet vested/unlocked"}}}},"token":{"type":"object","properties":{"symbol":{"type":["string","null"]},"decimals":{"type":"integer"},"totalSupply":{"type":["string","null"]}}},"status":{"enum":["ok","error"],"type":"string"},"chainId":{"type":"integer"},"factory":{"type":"string"},"lockCount":{"type":"integer"},"nextUnlock":{"type":["object","null"],"properties":{"at":{"type":"string","format":"date-time"},"chain":{"type":"string"},"amount":{"type":"string"},"lockId":{"type":"integer"},"lockUrl":{"type":"string"}}},"totalLockedRaw":{"type":"string"},"pctOfSupplyLocked":{"type":["number","null"],"description":"Still-locked / totalSupply on that chain, percent"},"totalLockedAmount":{"type":"string"}}}},"source":{"type":"string"},"isLocked":{"type":"boolean","description":"true if any amount is still locked on any checked chain"},"checkedAt":{"type":"string","format":"date-time"},"nextUnlock":{"type":["object","null"],"properties":{"at":{"type":"string","format":"date-time"},"chain":{"type":"string"},"amount":{"type":"string"},"lockId":{"type":"integer"},"lockUrl":{"type":"string"}}},"totalLocks":{"type":"integer"},"chainsFailed":{"type":"array","items":{"type":"string"},"description":"Chains whose RPC failed (results for them unknown)"},"chainsChecked":{"type":"array","items":{"type":"string"},"description":"Chains read successfully"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_C9u2gMpVM_QMMgnHLF_UM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Check whether an ERC-20 token or LP token is locked or vesting on-chain, returning lock details, unlock dates, claimable amounts, and percentage of supply locked across up to 11 EVM chains.","exampleAgentPrompt":"Before I buy this token, can you check if it's locked on X-Lock? The contract address is 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 — check across all chains and tell me how much of the supply is locked, when it unlocks, and if there's anything claimable.","exampleUseCases":[{"title":"Pre-buy rug pull safety check","prompt":"I'm about to buy this new token at 0x6B175474E89094C44Da98b954EedeAC495271d0F — can you check if the liquidity is locked on X-Lock across all chains before I pull the trigger? I want to know the lock status, unlock date, and what percentage of supply is locked."},{"title":"Vesting schedule lookup for investment","prompt":"Can you pull up the vesting schedule for the token at 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 on Ethereum? I need to know when it fully unlocks, how much is claimable now, and whether it's a timelock or vesting type."},{"title":"LP token lock verification on BNB Chain","prompt":"Check whether the LP token at 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 is locked on BNB chain — I want to see the lock ID, who created the lock, and when the tokens become fully available."}],"resultDescription":"Returns a JSON object with the token address, overall lock status (isLocked), timestamp of the check, list of chains checked and any that failed, total number of locks found, and per-chain detail arrays. Each chain entry includes individual lock records with: lock type (timelock or vesting), status (locked/vesting/unlocked/fully_released), start/cliff/end dates, amount deposited, amount released, claimable amount, lock wallet, creator address, and a public X-Lock page URL for each lock.","failureModes":["Invalid ERC-20 address format returns 400 validation error","Token not found on any scanned chain returns isLocked=false with empty locks array","Unsupported chain key returns enum validation error","Chain RPC unavailability populates chainsFailed array with error messages","Insufficient USDC balance or failed x402 micropayment returns 402 Payment Required","Token has no lock contract interactions — returns zero locks, not an error"],"whenToPreferThis":"Use this endpoint when you need to verify token or LP lock status before a DeFi investment, specifically when you want structured on-chain lock data across multiple EVM chains simultaneously including Base, Ethereum, BNB, and XRPL EVM. Prefer this over manual block explorer checks when you need machine-readable vesting schedules, unlock dates, and claimable amounts. Ideal for DeFi due diligence agents, portfolio monitors, or pre-trade safety checks.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:38:19.707Z","isFirstParty":false,"canonicalSlug":"token-lock-vesting-check-via-x-lock-2adf747b"}