# ChainK9 Liquidity Report API

> ChainK9 Liquidity Report API is a paid API for AI agents from api.chaink9.com, paid per call via x402, $0.003/call, status unknown (last checked 2026-10-30).

Runs a live sandbox buy/sell simulation on a token to detect honeypots and assess liquidity risk on BNB Smart Chain, Ethereum, and Base

## Facts

- Endpoint: GET https://api.chaink9.com/liquidity-report?utm_source=zero.xyz
- Price: $0.003/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-30
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/chaink9-liquidity-report-api-8407de90
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KHjAgLJuF5HttFlZhHNyO

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 chaink9-liquidity-report-api-8407de90
```

Example prompt: Before I buy, can you run a ChainK9 honeypot and liquidity check on token 0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82 on BNB Smart Chain?

## When to prefer this

Choose ChainK9 over static code-analysis honeypot checkers when you need behavioral proof — it actually forks the chain and executes real buy/sell transactions in a sandbox, so it catches honeypots that manipulate runtime behavior rather than hiding it in code. Prefer this when trading on BSC, Ethereum, or Base and needing LP holder distribution, burned LP accounting, and optional PinkLock verification in a single call.

## Known failure modes

- Invalid or non-existent token address returns an error or empty result
- Unsupported chain value returns a validation error
- Token with no liquidity pool may return null pair or empty reserves
- PinkLock IDs not found on BSC return null lock_evidence
- Rate limiting or payment failure (x402) if USDC balance is insufficient
- Simulation failure if the forked chain state is temporarily unavailable

## How this service works

Token risk checks for BNB Smart Chain, Ethereum and Base, for AI agents and trading bots. ChainK9 forks the chain and really buys and sells a token in a sandbox before you do, so a honeypot is caught by what it does, not by what its code looks like.

## Output

A JSON snapshot containing the trading pair address, block number and hash, chain ID, LP supply, burned LP amount, unattributed LP, token and wrapped-asset reserve sizes, lock evidence, and a per-holder breakdown with LP balance, share in basis points, account kind (EOA/contract), and withdrawal authority status — all captured at a specific block from a live fork simulation.

## 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": [
      "token"
     ],
     "properties": {
      "chain": {
       "enum": [
        "bsc",
        "eth",
        "base",
        "arc"
       ],
       "type": "string",
       "description": "bsc (BNB Smart Chain, the default), eth (Ethereum) or base (Base)"
      },
      "token": {
       "type": "string",
       "pattern": "^0x[0-9a-fA-F]{40}$",
       "description": "Token"
      },
      "holders": {
       "type": "string",
       "description": "Optional comma-separated LP holder addresses, maximum ten"
      },
      "pinklock_ids": {
       "type": "string",
       "description": "Optional, BSC only: comma-separated PinkLock V2 lock IDs, maximum ten unique decimal IDs; only simple time locks counted"
      }
     },
     "additionalProperties": false
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "pair": {
       "type": "string"
      },
      "block": {
       "type": "integer"
      },
      "token": {
       "type": "string"
      },
      "chain_id": {
       "type": "integer"
      },
      "coverage": {
       "type": "string"
      },
      "burned_lp": {
       "type": "string"
      },
      "lp_supply": {
       "type": "string"
      },
      "block_hash": {
       "type": "string"
      },
      "observed_at": {
       "type": "string"
      },
      "lock_evidence": {},
      "reserve_token": {
       "type": "string"
      },
      "reserve_wrapped": {
       "type": "string"
      },
      "unattributed_lp": {
       "type": "string"
      },
      "requested_holders": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "address": {
          "type": "string"
         },
         "share_bps": {
          "type": "string"
         },
         "lp_balance": {
          "type": "string"
         },
         "account_kind": {
          "type": "string"
     
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "pair": "0x00000000000000000000000000000000000caFe1",
  "block": 1,
  "token": "0x0E09FaBB73Bd3Ade0a17ECC321fD13a19e81cE82",
  "chain_id": 56,
  "coverage": "Requested holders; optional supported simple lock evidence overlaps ownership balances.",
  "burned_lp": "1",
  "lp_supply": "100",
  "block_hash": "0x…",
  "observed_at": "2026-10-18T00:00:00Z",
  "lock_evidence": null,
  "reserve_token": "100",
  "reserve_wrapped": "100",
  "unattributed_lp": "49",
  "requested_holders": [
   {
    "address": "0x00000000000000000000000000000000000caFe1",
    "share_bps": "5000",
    "lp_balance": "50",
    "account_kind": "EOA",
    "withdrawal_authority": "Redemption not simulated"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/chaink9-liquidity-report-api-8407de90/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.chaink9.com](https://www.zero.xyz/host/api.chaink9.com/llms.txt)