{"slug":"audit-liquidlogicx-com-api-lock-status-56e1b7","title":"Check if a token or LP is locked before you buy, via X-Lock by Liquid Logic X","host":"audit.liquidlogicx.com","method":"GET","resource":"https://audit.liquidlogicx.com/api/lock-status","category":"code","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.","price_listed":0.005,"price_asked":null,"state":"effects","state_label":"Not tested: has real-world effects","checks_7d":0,"answered_7d":0,"latency_ms_median":null,"reported_calls_30d":3,"reported_payers_30d":3,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"method":"GET","queryParams":{"chain":"base","token":"0x1111111111111111111111111111111111111111"},"type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"method":{"enum":["GET"],"type":"string"},"queryParams":{"properties":{"chain":{"description":"Optional. One chain key (chain id or eip155:<id> also accepted). Omit to scan all 11 X-Lock chains.","enum":["base","bnb","ethereum","arbitrum","polygon","avalanche","optimism","arc","tempo","robinhood","xrplevm"],"type":"string"},"token":{"description":"ERC-20 token contract address (or LP token) to check.","pattern":"^0x[0-9a-fA-F]{40}$","type":"string"}},"required":["token"],"type":"object"},"type":{"const":"http","type":"string"}},"required":["type","method"],"type":"object"},"output":{"properties":{"example":{"properties":{"chains":{"items":{"properties":{"caip2":{"type":"string"},"chain":{"type":"string"},"chainId":{"type":"integer"},"error":{"type":"string"},"factory":{"type":"string"},"lockCount":{"type":"integer"},"locks":{"items":{"properties":{"amount":{"description":"Amount deposited (token units, decimal string)","type":"string"},"amountRaw":{"description":"Amount in base units","type":"string"},"beneficiary":{"type":"string"},"claimable":{"description":"Vested but not yet withdrawn","type":"string"},"cliff":{"format":"date-time","type":"string"},"creator":{"type":"string"},"end":{"description":"Fully unlocked at","format":"date-time","type":"string"},"kind":{"enum":["timelock","vesting"],"type":"string"},"lockId":{"type":"integer"},"lockUrl":{"description":"Public X-Lock page for this lock","type":"string"},"lockWallet":{"description":"Per-lock wallet contract holding the tokens","type":"string"},"released":{"description":"Already withdrawn by beneficiary","type":"string"},"start":{"format":"date-time","type":"string"},"status":{"enum":["locked","vesting","unlocked","fully_released"],"type":"string"},"stillLocked":{"description":"Not yet vested/unlocked","type":"string"}},"type":"object"},"type":"array"},"nextUnlock":{"properties":{"amount":{"type":"string"},"at":{"format":"date-time","type":"string"},"chain":{"type":"string"},"lockId":{"type":"integer"},"lockUrl":{"type":"string"}},"type":["object","null"]},"pctOfSupplyLocked":{"description":"Still-locked / totalSupply on that chain, percent","type":["number","null"]},"status":{"enum":["ok","error"],"type":"string"},"token":{"properties":{"decimals":{"type":"integer"},"symbol":{"type":["string","null"]},"totalSupply":{"type":["string","null"]}},"type":"object"},"totalLockedAmount":{"type":"string"},"totalLockedRaw":{"type":"string"}},"type":"object"},"type":"array"},"chainsChecked":{"description":"Chains read successfully","items":{"type":"string"},"type":"array"},"chainsFailed":{"description":"Chains whose RPC failed (results for them unknown)","items":{"type":"string"},"type":"array"},"checkedAt":{"format":"date-time","type":"string"},"isLocked":{"description":"true if any amount is still locked on any checked chain","type":"boolean"},"nextUnlock":{"properties":{"amount":{"type":"string"},"at":{"format":"date-time","type":"string"},"chain":{"type":"string"},"lockId":{"type":"integer"},"lockUrl":{"type":"string"}},"type":["object","null"]},"source":{"type":"string"},"token":{"type":"string"},"totalLocks":{"type":"integer"}},"required":["token","isLocked","checkedAt","chainsChecked","chainsFailed","totalLocks","chains"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[],"description_full":"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.","last_updated":"2026-10-17T14:11:10.629Z","schemes":["exact"]}