# Liquidity Lock Inspector

> Liquidity Lock Inspector is a paid API for AI agents from api.fadeandco.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

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.

## Facts

- Endpoint: GET https://api.fadeandco.workers.dev/api/agent-intel/liquidity-lock-inspector?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/liquidity-lock-inspector-966b7558
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_55P_rrxaYRwzmea3rs28E

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability liquidity-lock-inspector-966b7558
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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.

## Request schema (JSON Schema)

```json
{
 "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"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/liquidity-lock-inspector-966b7558/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.fadeandco.workers.dev](https://www.zero.xyz/host/api.fadeandco.workers.dev/llms.txt)